@majordigital/create-acorn 1.6.0 → 1.6.2

package/README.md

@@ -36,6 +36,35 @@ Every Acorn project ships with a carefully curated stack:
 - **SVG-as-components** — Inline SVG imports via `@svgr/webpack` for both Webpack and Turbopack
 - **Bundle Analysis** — `@next/bundle-analyzer` ready to go with `ANALYZE=true`
 
+## Pre-Deploy Validation
+
+Every Acorn project ships with a built-in pre-deployment validation suite. Run it with the `/pre-deploy` slash command in Claude Code to get a full readiness report before going live.
+
+The suite covers 7 phases:
+
+1. **Static code checks** — console logs, placeholder analytics IDs, missing favicon, robots.txt, sitemap, metadata, and legal pages
+2. **Browser checks** — screenshots every core page at desktop and mobile viewports using agent-browser
+3. **Lighthouse audit** — mobile + desktop scores across Performance, Accessibility, Best Practices, and SEO
+4. **Broken link check** — crawls the full site and reports every broken internal link
+5. **Cross-browser compatibility** — screenshots across Chromium, Firefox, and WebKit
+6. **Final report** — saves a dated markdown report to `.claude/pre-deployment-result/`
+
+Results and screenshots are saved to `.claude/pre-deployment-result/` for review and historical comparison.
+
+### Adding pre-deploy to an existing project
+
+The suite is included automatically in every new project. If you have an existing acorn project that predates v1.6.0, you can add it without re-running the full setup:
+
+```bash
+# Full new project — pre-deploy included automatically
+npx @majordigital/create-acorn@latest
+
+# Add pre-deploy to an existing project only
+npx @majordigital/create-acorn@latest --add-pre-deploy
+```
+
+The `--add-pre-deploy` flag copies the scripts, installs the dependencies (`lighthouse`, `chrome-launcher`, `playwright`, `linkinator`), and adds the npm scripts to your `package.json`. It skips silently if the tooling is already present.
+
 ## Acorn Component Architecture
 
 The Acorn library follows a layered component hierarchy designed for consistency and reuse across projects:
@@ -87,6 +116,11 @@ Beyond the component library, every project includes:
 | `.env.example` | CMS-specific environment variable template |
 | `.npmrc` | Legacy peer deps for React 19 compatibility |
 | `README.md` | Project-specific documentation based on CMS choice |
+| `scripts/lighthouse-audit.mjs` | Lighthouse audit runner (mobile + desktop, concurrent Chrome workers) |
+| `scripts/cross-browser-check.mjs` | Cross-browser screenshots via Playwright (Chromium, Firefox, WebKit) |
+| `scripts/check-links.mjs` | Broken internal link crawler using linkinator |
+| `scripts/cleanup-screenshots.mjs` | Removes pre-deploy artifacts older than 1 month |
+| `.claude/commands/pre-deploy.md` | `/pre-deploy` slash command for Claude Code |
 
 ## npm
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@majordigital/create-acorn",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Interactive starter CLI for Acorn with Storyblok/Prismic/DatoCMS, TypeScript, and Tailwind.",
   "bin": {
     "create-acorn": "bin/create-acorn.mjs",

package/template/scripts/check-links.mjs

@@ -21,6 +21,18 @@ const outputDir = process.argv[3] || ".claude/pre-deployment-result";
 
 mkdirSync(outputDir, { recursive: true });
 
+// Lower concurrency for localhost — the Next.js dev server + CMS API calls
+// can't handle many parallel requests and returns 500s under concurrent load.
+const isLocalhost = baseUrl.includes("localhost") || baseUrl.includes("127.0.0.1");
+const concurrency = isLocalhost ? 2 : 5;
+
+// Support Netlify Basic Auth (password-protected preview deploys).
+// Set NETLIFY_AUTH=user:password in your environment before running.
+const netlifyAuth = process.env.NETLIFY_AUTH;
+const headers = netlifyAuth
+    ? { Authorization: `Basic ${Buffer.from(netlifyAuth).toString("base64")}` }
+    : {};
+
 const checker = new LinkChecker();
 
 checker.on("link", (result) => {
@@ -32,16 +44,19 @@ checker.on("link", (result) => {
 });
 
 console.log(`Checking links on: ${baseUrl}`);
+if (netlifyAuth) console.log("Using Basic Auth from NETLIFY_AUTH env var");
+console.log(`Concurrency: ${concurrency}`);
 console.log("This may take several minutes...\n");
 
 const result = await checker.check({
     path: baseUrl,
     recurse: true,
-    concurrency: 10,
+    concurrency,
     timeout: 30000,
+    headers,
     // Skip external links to avoid false positives from rate limiting
     linksToSkip: [
-        "^(?!(" + baseUrl.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "))",
+        `^(?!(${baseUrl.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}))`,
     ],
 });