chore(project): update documentation and release scripts

- Update PRD.md with website and release automation features
- Update README.md with website local dev instructions
- Update CONTRIBUTING.md with website verification step
- Fix syntax error in release.cjs
- Add update-web-version.js script

Author: mahatmamahardhikach

CONTRIBUTING.md

@@ -93,7 +93,8 @@ Closes #123
 3. Add tests for new features
 4. Ensure all tests pass: `npm test`
 5. Update the README.md if needed
-6. Create a Pull Request with a clear description
+6. If modifying the website, verify changes with `npm run web`
+7. Create a Pull Request with a clear description
 
 ## Release Process
 

PRD.md

@@ -28,8 +28,13 @@ Growing teams often struggle to keep release processes consistent: commit messag
   - Detects release type from CLI args or npm context.
   - Runs project tests via detected package manager before releasing.
   - Invokes `standard-version` with additional flags (e.g., preload patch for deprecated APIs).
+  - **[NEW]** Automatically updates website version in `web/index.html`.
 - **Preload Patching (`scripts/preload/fs-f-ok.cjs`)**
   - Hooks Node’s module loader to transparently replace deprecated `fs.F_OK` usages in `standard-version` without altering `node_modules`.
+- **Website & Documentation**
+  - Professional landing page in `web/` directory.
+  - Automated GitHub Releases generation.
+  - Open Graph social media preview support.
 - **Testing**
   - Suite executed via `node --test` covers setup utilities, release argument parsing, and the preload patch.
 

README.md

@@ -186,7 +186,21 @@ To see what would happen without making changes:
 npm run release -- --dry-run
 ```
 
-## Contributing
+## Website
+ 
+ The project includes a professional landing page in the `web/` directory.
+ 
+ ### Local Development
+ 
+ To run the website locally:
+ 
+ ```bash
+ npm run web
+ ```
+ 
+ This will serve the website at `http://localhost:3000`.
+ 
+ ## Contributing
 
 Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
 

package.json

@@ -12,7 +12,9 @@
     "release": "node scripts/release.cjs",
     "release:major": "node scripts/release.cjs major",
     "release:minor": "node scripts/release.cjs minor",
-    "release:patch": "node scripts/release.cjs patch"
+    "release:patch": "node scripts/release.cjs patch",
+    "web": "npx serve web",
+    "update:web": "node scripts/update-web-version.js"
   },
   "keywords": [
     "commit",
@@ -91,4 +93,4 @@
     "husky": "^9.1.7",
     "standard-version": "^9.5.0"
   }
-}
+}

scripts/release.cjs

@@ -188,9 +188,21 @@ function runRelease({
     }
   }
 
+  // Update website version
+  try {
+    console.log('🌐 Updating website version...');
+    const updateWebResult = spawnSync('npm', ['run', 'update:web'], { stdio: 'inherit', cwd });
+    if (updateWebResult.status === 0) {
+      spawnSync('git', ['add', 'web/index.html'], { stdio: 'inherit', cwd });
+    } else {
+      console.warn('⚠️  Failed to update website version');
+    }
+  } catch (error) {
+    console.warn(`⚠️  Skipping website version update: ${error.message}`);
+  }
+
   return releaseResult;
 }
-
 if (require.main === module) {
   try {
     const result = runRelease();

scripts/update-web-version.js

@@ -0,0 +1,26 @@
+const fs = require('fs');
+const path = require('path');
+
+// Get current version from package.json
+const packageJson = require('../package.json');
+const version = packageJson.version;
+
+const indexPath = path.join(__dirname, '../web/index.html');
+let content = fs.readFileSync(indexPath, 'utf8');
+
+// Update version in the badge
+// Matches: <span>v1.1.9 - Latest Release</span>
+content = content.replace(
+    /<span>v\d+\.\d+\.\d+ - Latest Release<\/span>/,
+    `<span>v${version} - Latest Release</span>`
+);
+
+// Update version in the stats
+// Matches: <div class="stat-value">1.1.9</div>
+content = content.replace(
+    /<div class="stat-value">\d+\.\d+\.\d+<\/div>(\s*<div class="stat-label">Latest Version<\/div>)/,
+    `<div class="stat-value">${version}</div>$1`
+);
+
+fs.writeFileSync(indexPath, content);
+console.log(`✅ Updated website to version ${version}`);

web/index.html

@@ -66,7 +66,7 @@
             <div class="hero-content">
                 <div class="hero-badge">
                     <span class="badge-dot"></span>
-                    <span>v1.1.9 - Latest Release</span>
+                    <span>v1.1.11 - Latest Release</span>
                 </div>
                 <h1 class="hero-title">
                     Ship Releases with <span class="gradient-text">Confidence</span>
@@ -90,7 +90,7 @@ <h1 class="hero-title">
                 </div>
                 <div class="hero-stats">
                     <div class="stat-item">
-                        <div class="stat-value">1.1.9</div>
+                        <div class="stat-value">1.1.11</div>
                         <div class="stat-label">Latest Version</div>
                     </div>
                     <div class="stat-item">