Generated a temp story for each point. As well I add a generate step for the json file

Author: NangiDev

.github/workflows/deploy.yml

@@ -31,12 +31,20 @@ jobs:
       - name: Setup Pages
         uses: actions/configure-pages@v4
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          
       - name: Build site
         run: |
           echo "Building static site..."
-          # Since this is a static site, we just need to prepare the files
-          # Remove any development-only files if needed
+          # Generate tips.json from markdown files
+          node scripts/build-tips.js
+          # Remove any development-only files
           find . -name ".DS_Store" -delete 2>/dev/null || true
+          # Remove build scripts from deployment
+          rm -rf scripts/
           
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

.gitignore

@@ -0,0 +1,23 @@
+# Generated files
+data/tips.json
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Node modules (if any build tools are added later)
+node_modules/
+npm-debug.log
+yarn-error.log

CLAUDE.md

@@ -11,7 +11,16 @@ The Pragmatic Cheatsheet is a static GitHub Pages website that provides an inter
 - **Story format**: Stories are separated by `---` and can reference multiple tips using tag system `[34,45]`
 - **Deployment**: GitHub Actions builds and deploys to `gh-pages` branch
 
+## Development Commands  
+Since this is a static site with a build step:
+- **Local development**: `python -m http.server 8000` or `npx serve .`
+- **Build data**: `node scripts/build-tips.js` (generates `data/tips.json` from story files)
+- **Testing**: Open `index.html` in browser after building
+- **Deployment**: Trigger manual GitHub Actions workflow "Deploy to GitHub Pages"
+
 ## Development Workflow
+- **Content editing**: Edit markdown files in `stories/` directory
+- **Build process**: GitHub Actions runs `build-tips.js` to generate `tips.json` from markdown
 - **Main branch**: Development work
 - **gh-pages branch**: Deployment target (auto-generated)
 - **Style consistency**: Follow Acorn website design patterns (https://www.acorntechnology.se/)

README.md

@@ -67,6 +67,7 @@ The repository includes a GitHub Actions workflow for manual deployment to the `
 5. **Click "Run workflow"** to start deployment
 
 The workflow will automatically:
+- Generate `data/tips.json` from markdown story files
 - Build the static site (cleanup development files)
 - Create/update the `gh-pages` branch
 - Deploy to GitHub Pages
@@ -86,13 +87,19 @@ If you encounter workflow permission errors:
 ## Local Development
 To run the website locally:
 1. Clone the repository
-2. Open `index.html` in a web browser or use a local server:
+2. **Build the data file**: Generate `tips.json` from markdown stories
+   ```bash
+   node scripts/build-tips.js
+   ```
+3. Start a local server:
    ```bash
    python -m http.server 8000
    # or
    npx serve .
    ```
-3. Navigate to `http://localhost:8000`
+4. Navigate to `http://localhost:8000`
+
+**Note**: The `data/tips.json` file is generated from markdown files in the `stories/` directory and should not be edited directly.
 
 ## Future Improvements
 The following features could enhance the user experience:

data/.gitkeep

@@ -0,0 +1,2 @@
+# This file ensures the data/ directory is tracked in git
+# The actual tips.json file is generated by scripts/build-tips.js