Migrate deployment docs to Azure Static Web Apps, add lint/test/clean scripts, extract shared CSS

The site deploys via Azure Static Web Apps, not GitHub Pages, so remove the
leftover CNAME/.nojekyll files and correct README, copilot-instructions, and
the constitution to describe the real deployment pipeline (custom domain is
bound in the Azure portal, not a repo file).

Add npm run clean/lint/test alongside the existing build script: ESLint
(flat config) over the Node sources, and a Node built-in test-runner suite
that builds the site and checks every page exists, required Azure/SEO files
are copied, and internal links resolve. Wire lint + test + a docs/ drift
check into a new CI workflow so a stale committed docs/ or a broken build
is caught before the Azure deploy workflow uploads it.

Extract the shared inline <style> block into one docs/styles.css referenced
via <link> from every page, so browsers cache it once across navigations
instead of re-downloading ~28KB of duplicate CSS on every page load
(index.html alone drops from 60KB to 32KB).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: markhazleton

.documentation/memory/constitution.md

@@ -14,11 +14,11 @@ against `content.json`, brand documentation, and generated output in `docs/`.
 This repository is a static marketing site. Prefer generated HTML, CSS, and
 small focused JavaScript over adding client-side frameworks, backends,
 databases, or build complexity. New dependencies must have a clear benefit and
-must not make GitHub Pages deployment harder to reason about.
+must not make Azure Static Web Apps deployment harder to reason about.
 
 ### III. Production Output Integrity
 
-The committed `docs/` directory is the GitHub Pages deployment output and must
+The committed `docs/` directory is the Azure Static Web Apps deployment output and must
 stay synchronized with source changes. Any change to `build.js`, `content.json`,
 or files under `static/` or `attached_assets/` that affects rendered pages must
 include a regenerated `docs/` output.
@@ -49,7 +49,7 @@ brand/project reference material.
 - Node.js 18+ with npm scripts
 - Static site generator implemented in `build.js`
 - Site content stored in `content.json`
-- Generated GitHub Pages output in `docs/`
+- Generated Azure Static Web Apps output in `docs/`
 - Source static assets in `static/` and `attached_assets/`
 - No backend, database, or client-side framework
 

.github/copilot-instructions.md

@@ -18,10 +18,10 @@ MakeBoldSolutionsCom/
 ├── dev.js                 # Local dev server with rebuild-on-change
 ├── serve.js               # Plain static file server for docs/
 ├── static/                 # Files copied verbatim into docs/ on every build
-│   ├── CNAME, .nojekyll, robots.txt, sitemap.xml, favicon.*, .well-known/
+│   ├── staticwebapp.config.json, robots.txt, sitemap.xml, favicon.*, .well-known/
 ├── attached_assets/        # Logo files, vCards, contact photos used during build
 ├── documentation/          # Brand guide, logo source files
-└── docs/                   # Build output, committed to git for GitHub Pages
+└── docs/                   # Build output, committed to git for Azure Static Web Apps
 ```
 
 ## Development Workflows
@@ -35,8 +35,8 @@ npm run serve       # Serve existing docs/ without rebuilding
 
 ### Build & Deployment
 - Build output goes to `docs/`, which is committed to git.
-- GitHub Pages serves from `main` branch, `/docs` folder, custom domain `makeboldsolutions.com` (see `static/CNAME`).
-- `build.js` copies `static/CNAME`, `static/.nojekyll`, `static/robots.txt`, `static/sitemap.xml`, favicons, and `static/.well-known/security.txt` into `docs/` on every run — edit the source files in `static/`, not the generated copies in `docs/`.
+- Azure Static Web Apps deploys on push to `main` via `.github/workflows/azure-static-web-apps-*.yml`, which uploads `docs/` as a pre-built artifact (`skip_app_build: true`) — there is no build step in CI, so `docs/` must be committed already up to date. Custom domain `makeboldsolutions.com` is configured in the Azure portal, not a repo file.
+- `build.js` copies `static/staticwebapp.config.json`, `static/robots.txt`, `static/sitemap.xml`, favicons, and `static/.well-known/security.txt` into `docs/` on every run — edit the source files in `static/`, not the generated copies in `docs/`.
 
 ## Code Conventions
 - Pages are built by individual `build*()` functions in `build.js` (e.g. `buildHome`, `buildAbout`, `buildContact`) and registered in the `pages` array near the bottom of the file.

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - run: npm ci
+      - run: npm run lint
+      - run: npm test
+
+      - name: Verify docs/ is up to date with source
+        run: |
+          npm run build
+          if ! git diff --quiet -- docs/; then
+            echo "::error::docs/ is out of date with build.js/content.json. Run 'npm run build' locally and commit the result."
+            git diff --stat -- docs/
+            exit 1
+          fi

.gitignore

@@ -1,7 +1,7 @@
 # Dependencies
 node_modules
 
-# Note: docs/ is NOT ignored - it's the GitHub Pages deployment output
+# Note: docs/ is NOT ignored - it's the Azure Static Web Apps deployment output
 
 # Environment variables
 .env

README.md

@@ -37,6 +37,9 @@ The site is a Node.js static site generator: `build.js` reads content from `cont
 
 ## Available Scripts
 
+- `npm run clean` - Remove the generated `docs/` directory (build.js never clears stale files on its own, so this catches orphaned output from removed pages/assets)
+- `npm run lint` - Lint `build.js`, `dev.js`, `serve.js`, and `test/` with ESLint
+- `npm test` - Run the build against a smoke-test suite (Node's built-in test runner): verifies every page builds, required Azure/SEO files are copied, and internal links resolve to real files
 - `npm run build` - Run the static site generator (`build.js`) and write output to `docs/`
 - `npm run dev` - Build, serve `docs/` locally, and rebuild automatically when `build.js` or `content.json` changes
 - `npm run serve` - Serve the existing `docs/` output without rebuilding
@@ -50,15 +53,14 @@ MakeBoldSolutionsCom/
 ├── dev.js                # Local dev server with rebuild-on-change
 ├── serve.js              # Plain static file server for docs/
 ├── static/                # Source files copied into docs/ on every build
-│   ├── CNAME              # Custom domain for GitHub Pages
-│   ├── .nojekyll          # Prevents Jekyll processing
+│   ├── staticwebapp.config.json  # Azure Static Web Apps routing, headers, caching
 │   ├── robots.txt
 │   ├── sitemap.xml
 │   ├── favicon.png / favicon.svg
 │   └── .well-known/security.txt
 ├── attached_assets/       # Logo files, vCards, and contact photos used during build
 ├── documentation/         # Brand guide, logo source files, project docs
-└── docs/                  # Build output (committed to git for GitHub Pages)
+└── docs/                  # Build output (committed to git for Azure Static Web Apps)
 ```
 
 ## Pages
@@ -76,7 +78,7 @@ Site copy, navigation, and page sections live in `content.json`. Edit that file
 
 ## Deployment
 
-GitHub Pages is configured to serve from the `main` branch, `/docs` folder, at the custom domain `makeboldsolutions.com` (see `static/CNAME`). After making changes:
+The site deploys to Azure Static Web Apps via [.github/workflows/azure-static-web-apps-lemon-plant-08b5fed10.yml](.github/workflows/azure-static-web-apps-lemon-plant-08b5fed10.yml), which triggers on every push to `main`. It uploads the pre-built `docs/` folder as-is (`skip_app_build: true`, `app_location: "docs"`) — there is no build step in CI, so `docs/` must be regenerated and committed locally before pushing. The custom domain `makeboldsolutions.com` is configured in the Azure Static Web Apps portal (Custom domains blade), not via a repo file. Routing, security headers, and caching rules live in [static/staticwebapp.config.json](static/staticwebapp.config.json), which `build.js` copies into `docs/` on every build. After making changes:
 
 ```bash
 npm run build

build.js

@@ -36,9 +36,7 @@ const staticDir = join(__dirname, 'static');
 copyFileSync(join(staticDir, 'favicon.png'), join(docsDir, 'favicon.png'));
 copyFileSync(join(staticDir, 'favicon.svg'), join(docsDir, 'favicon.svg'));
 
-// Copy GitHub Pages essentials (custom domain, Jekyll bypass, crawler rules, security contact)
-copyFileSync(join(staticDir, 'CNAME'), join(docsDir, 'CNAME'));
-copyFileSync(join(staticDir, '.nojekyll'), join(docsDir, '.nojekyll'));
+// Copy crawler rules and security contact
 copyFileSync(join(staticDir, 'robots.txt'), join(docsDir, 'robots.txt'));
 copyFileSync(join(staticDir, 'sitemap.xml'), join(docsDir, 'sitemap.xml'));
 // Copy Azure Static Web Apps config (routing, redirects, MIME types, security headers)
@@ -1014,6 +1012,9 @@ h1, h2, h3, h4, h5, h6 {
 @media (max-width: 640px) { .deck-hero h1 { font-size: 1.9rem; } }
 `;
 
+// Write CSS once as a shared external file so browsers cache it across page
+// navigations instead of re-downloading it inlined in every HTML page.
+writeFileSync(join(docsDir, 'styles.css'), css.trim() + '\n', 'utf-8');
 
 // ─── Shared HTML Builders ────────────────────────────────────────────────────
 
@@ -1097,7 +1098,7 @@ ${robotsMeta}  <link rel="canonical" href="${escapeAttr(canonicalUrl)}">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Be+Vietnam+Pro:ital,wght@0,400;0,500;0,600;0,700;0,800;0,900;1,400&family=Inter+Tight:wght@300;400;500;600;700&display=swap" rel="stylesheet">
   <title>${escapeHtml(pageTitle)}</title>
-  <style>${css}</style>
+  <link rel="stylesheet" href="styles.css">
 </head>
 <body>`;
 }
@@ -1447,69 +1448,6 @@ function buildServicesCfo() {
   </section>` + footer() + closePage();
 }
 
-function buildCaseStudies() {
-  const cs = content.caseStudies;
-
-  const studies = cs.studies.map(study => `
-      <div class="case-study">
-        <div class="grid grid-12" style="gap:2rem">
-          <div class="md-col-span-8">
-            <div style="display:flex;align-items:center;gap:1rem;margin-bottom:1rem">
-              <span class="badge">${escapeHtml(study.sector)}</span>
-              <span class="badge-muted">${escapeHtml(study.category)}</span>
-            </div>
-            <h2 class="text-2xl font-heading font-bold mb-6">${escapeHtml(study.title)}</h2>
-            <div style="margin-bottom:2rem">
-              <h4 class="text-sm font-bold uppercase tracking-wider text-primary mb-1">Challenge</h4>
-              <p class="text-muted">${escapeHtml(study.challenge)}</p>
-            </div>
-            <div style="margin-bottom:2rem">
-              <h4 class="text-sm font-bold uppercase tracking-wider text-primary mb-1">Solution</h4>
-              <p class="text-muted">${escapeHtml(study.solution)}</p>
-            </div>
-            <div class="outcome-box">
-              <h4 style="font-weight:700;margin-bottom:0.25rem">Outcome</h4>
-              <p style="font-size:1.125rem;font-weight:500;opacity:0.8">${escapeHtml(study.outcome)}</p>
-            </div>
-          </div>
-          <div class="md-col-span-4 metrics-panel">
-            ${study.metrics.map(m => `
-              <div class="metric">
-                <div class="value">${escapeHtml(m.value)}</div>
-                <div class="label">${escapeHtml(m.label)}</div>
-              </div>`).join('')}
-          </div>
-        </div>
-      </div>`).join('');
-
-  return htmlHead('Case Studies', cs.header.description) + navigation('case-studies.html') + `
-
-  <div class="section-dark header-accent page-header">
-    <div class="container" style="position:relative;z-index:1">
-      <span class="text-primary font-bold tracking-widest uppercase text-sm mb-4" style="display:block">Client Results</span>
-      <h1 class="text-4xl lg-text-5xl font-heading font-bold mb-6">${escapeHtml(cs.header.heading)}</h1>
-      <p class="text-xl text-white-80 max-w-2xl">${escapeHtml(cs.header.description)}</p>
-    </div>
-  </div>
-
-  <div class="container section">
-    <div class="grid" style="gap:3rem">
-      ${studies}
-    </div>
-  </div>
-
-  <section class="section-primary section">
-    <div class="container text-center">
-      <h2 class="text-3xl font-heading font-bold mb-6">Ready to Write Your Own Success Story?</h2>
-      <p class="text-white-80 max-w-2xl mx-auto mb-10 text-lg">Every engagement starts with a conversation. Let's talk about where you are and where you want to go.</p>
-      <div class="flex flex-col sm-flex-row gap-4 justify-center">
-        <a href="contact.html" class="btn-white btn-large">Get in Touch</a>
-        <a href="services-cfo.html" class="btn-outline-white btn-large">Explore Our Services</a>
-      </div>
-    </div>
-  </section>` + footer() + closePage();
-}
-
 function buildAbout() {
   const a = content.about;
   const cf = a.cofounder;
@@ -1916,7 +1854,7 @@ async function buildCard(person) {
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Be+Vietnam+Pro:ital,wght@0,400;0,500;0,600;0,700;0,800;1,400&family=Inter+Tight:ital,wght@0,400;0,500;0,600;0,700;1,400&display=swap" rel="stylesheet">
-  <style>${css}</style>
+  <link rel="stylesheet" href="/styles.css">
 </head>
 <body>
   <main class="card-page">

clean.js

@@ -0,0 +1,9 @@
+import { rmSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const docsDir = join(__dirname, 'docs');
+
+rmSync(docsDir, { recursive: true, force: true });
+console.log('Removed docs/');