docs: document GitHub Pages deployment

README.md

@@ -6,29 +6,26 @@ Static marketing site for `codecarto.dev`. Built on the Hearth UI design templat
 
 - `index.html` — overview and landing page
 - `features.html` — pipeline variants, evidence classification, phase-gating, output artifacts
-- `docs.html` — installation (drop-in, Pi-mono, MCP), configuration, cPanel deployment
+- `docs.html` — installation (drop-in, Pi-mono, MCP), configuration, GitHub Pages deployment
 - `showcase.html` — example outputs, defect scan passes, model compatibility, use cases
 - `site.css` — marketing site styles (imports `colors_and_type.css`)
 - `colors_and_type.css` — canonical design tokens (palette, typography, spacing, shadows)
 - `logo.svg` — CodeCartographer map/matrix brand icon and favicon
 - `script.js` — pipeline switcher, copy buttons, scroll reveals
-- `.htaccess` — Apache config (HTTPS redirect, security headers)
+- `CNAME` — GitHub Pages custom-domain configuration for `codecarto.dev`
 - `robots.txt` — crawler guidance
 - `sitemap.xml` — sitemap for the live domain
-- `LAUNCH_CHECKLIST.md` — cPanel launch and post-upload verification checklist
-
-## Deploy To Namecheap cPanel
-
-1. Open Namecheap cPanel for the account serving `codecarto.dev`.
-2. Go to File Manager.
-3. Open the document root for the domain:
-   - primary domain: usually `public_html/`
-   - addon domain: the folder assigned as that domain's document root
-4. Upload the contents of this folder into that document root.
-5. Confirm `index.html` is at the top of the document root.
-6. Enable AutoSSL for `codecarto.dev`.
-7. Force HTTPS in the domain settings or with the `.htaccess` file.
-8. Visit `https://codecarto.dev/` and hard refresh.
+
+## Deploy With GitHub Pages
+
+GitHub Pages publishes the repository's `main` branch from the repository root.
+
+1. Open a pull request targeting `main`.
+2. Run `npm test` against the authoritative CodeCartographer checkout and wait for the pull-request checks to pass.
+3. Merge the pull request. GitHub Pages automatically starts a new deployment.
+4. Confirm the latest Pages build completed successfully in the repository's **Settings → Pages** view.
+5. Keep `CNAME` set to `codecarto.dev`; GitHub Pages manages the approved TLS certificate and enforces HTTPS.
+6. Visit `https://codecarto.dev/` and hard refresh.
 
 ## Important Link Notes
 

docs.html

@@ -4,7 +4,7 @@
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Docs — CodeCartographer</title>
-<meta name="description" content="Installation and configuration: drop-in template, Pi-mono extension, MCP server, pipeline selection, and cPanel deployment.">
+<meta name="description" content="Installation and configuration: drop-in template, Pi-mono extension, MCP server, pipeline selection, and GitHub Pages deployment.">
 <meta name="theme-color" content="#141413">
 <link rel="canonical" href="https://codecarto.dev/docs.html">
 <link rel="icon" href="logo.svg" type="image/svg+xml">
@@ -228,30 +228,29 @@ <h2>Turn confirmed software maps into a traceable build plan.</h2>
   </div>
 </section>
 
-<!-- =================== Deploy to cPanel ========== -->
+<!-- =================== Deploy with GitHub Pages === -->
 <section class="section-dark">
   <div class="container">
-    <div class="overline">05 · Deploy to Namecheap cPanel</div>
-    <h2>Upload the static bundle and point the domain at it.</h2>
+    <div class="overline">05 · Deploy with GitHub Pages</div>
+    <h2>Merge to main and let GitHub Pages publish the site.</h2>
     <p class="section-sub">
-      This site is plain HTML, CSS, and JavaScript. Drop it into <code>public_html</code> on your
-      cPanel host and it is live.
+      This site is plain HTML, CSS, and JavaScript. GitHub Pages serves the repository's
+      <code>main</code> branch from the repository root at <code>codecarto.dev</code>.
     </p>
 
     <div class="split">
       <div class="deploy-steps" data-reveal>
         <ol>
-          <li>Open Namecheap cPanel and navigate to <strong>File Manager</strong>.</li>
-          <li>Open the document root for <code>codecarto.dev</code>. For a primary domain this is <code>public_html/</code>. For an addon domain it is the folder assigned as that domain's document root.</li>
-          <li>Upload the entire contents of this <code>website/</code> folder into that document root.</li>
-          <li>Confirm <code>index.html</code> sits at the top of the document root.</li>
-          <li>Enable <strong>AutoSSL</strong> for the domain in cPanel.</li>
-          <li>Force HTTPS with the included <code>.htaccess</code> file or the cPanel domain settings.</li>
+          <li>Open a pull request targeting <code>main</code>.</li>
+          <li>Run <code>npm test</code> against the authoritative CodeCartographer checkout and wait for the pull-request checks to pass.</li>
+          <li>Merge the pull request. GitHub Pages automatically starts a deployment from <code>main</code> at <code>/(root)</code>.</li>
+          <li>Confirm the latest build completed in <strong>Settings → Pages</strong>.</li>
+          <li>Keep <code>CNAME</code> set to <code>codecarto.dev</code>. GitHub Pages manages the approved TLS certificate and enforces HTTPS.</li>
           <li>Visit <code>https://codecarto.dev/</code> and hard refresh.</li>
         </ol>
       </div>
       <div class="card-elevated" style="background:rgba(245,239,216,0.06);border:1px solid rgba(245,239,216,0.14);box-shadow:none" data-reveal>
-        <div class="overline">Files to upload</div>
+        <div class="overline">Published site files</div>
         <ul style="list-style:none;padding:0;display:grid;gap:6px;font-family:var(--font-mono);font-size:13px;color:rgba(245,239,216,0.8);margin:0">
           <li>index.html</li>
           <li>features.html</li>
@@ -260,7 +259,7 @@ <h2>Upload the static bundle and point the domain at it.</h2>
           <li>site.css</li>
           <li>colors_and_type.css</li>
           <li>script.js</li>
-          <li>.htaccess</li>
+          <li>CNAME</li>
           <li>robots.txt</li>
           <li>sitemap.xml</li>
         </ul>