build: subtree init

fezcode · fezcode · commit 659347960ee0 · 2026-01-08T19:28:48.000+03:00
diff --git a/README.md b/README.md
@@ -69,7 +69,8 @@ npm run deploy
 ```
 
 ### Content Syncing
-Stories are managed via git subtrees:
+Stories are managed via git subtrees. Because subtree remotes are not tracked by git, you must initialize the remote once after cloning:
+- `npm run init-stories`: Initialize the stories remote URL (only needed once).
 - `npm run pull-stories`: Sync stories from the remote repository.
 - `npm run push-stories`: Push local story changes to the remote repository.
 
diff --git a/package.json b/package.json
@@ -39,6 +39,7 @@
   "scripts": {
     "generate-rss": "node scripts/generate-rss.js",
     "generate-sitemap": "node scripts/generate-sitemap.js",
+    "init-stories": "git remote add fezcodex-stories https://github.com/fezcode/fezcodex.stories",
     "pull-stories": "git subtree pull --prefix public/stories fezcodex-stories main --squash",
     "push-stories": "git subtree push --prefix public/stories fezcodex-stories main",
     "generate-wallpapers": "node scripts/generateWallpapers.js",
diff --git a/public/posts/fezcodex-stories-with-git-subtrees.txt b/public/posts/fezcodex-stories-with-git-subtrees.txt
@@ -33,6 +33,8 @@ Before you begin, ensure your working directory is clean. Git commands like `git
 
 First, we'll add the external repository as a remote to your current Git project. This gives it a short, memorable name that you can use to reference it later.
 
+**Important Note for Collaborators:** Since Git does not track remotes in the repository itself, every time you clone this project fresh, you must re-run this step to enable syncing. In this project, we've simplified this with a command: `npm run init-stories`.
+
 **Explanation:** This command tells your local Git repository about the existence of the `fezcodex.stories` repository and associates it with the name `fezcodex-stories`. This makes it easier to fetch from or push to this external repository without typing out the full URL every time.
 
 **Command:**
