diff --git a/CONTENT.md b/CONTENT.md
new file mode 100644
index 0000000..f469630
--- /dev/null
+++ b/CONTENT.md
@@ -0,0 +1,121 @@
+# CONTENT - Copy Standards, Image Rules, and Asset Guidelines
+Author: Andre Cobham / Arising Media
+Updated: 2026-06-09
+
+## Writing Standard
+
+Reading level: 7th to 8th grade for service businesses, 10th to 12th grade for professional/B2B.
+
+Active voice. Short paragraphs (2 to 4 sentences max).
+
+Lead with the customer's problem, not the business's credentials.
+
+One clear CTA per section.
+
+No marketing jargon (synergize, leverage, best-in-class, cutting-edge, state-of-the-art).
+
+No filler phrases (In today's fast-paced world, Look no further, We pride ourselves on, Don't hesitate, Whether you are X or Y).
+
+Specificity beats superlatives. A timeframe, a material, a measurable result beats any adjective.
+
+## What We Never Write
+
+Em dashes or en dashes. Replace with a period, comma, colon, or the word "and" or "to".
+
+Invented numbers (satisfaction rates, years of experience, award claims) without client-verified proof.
+
+"Licensed" for any provisionally licensed or permit-holding clinician. Use "Provisionally Licensed" instead.
+
+Exclamation points (one per page maximum, in a CTA only).
+
+Passive voice as the default sentence structure.
+
+Verification check: `grep -rn '.\|–\|—\|–' . --include="*.html" --include="*.json"`. Result must be zero.
+
+## Tone by Sector
+
+Service businesses (trades, cleaning, home services): plain, direct, neighborhood-familiar.
+
+Healthcare / counseling: warm, clinical accuracy required, never overpromise outcomes.
+
+Professional / B2B / tech: peer-level, systems-oriented, results-focused.
+
+## Healthcare Credential Rules
+
+MHC-LP is Provisionally Licensed, not Licensed. LP stands for Limited Permit.
+
+Any permit holder must display: "Practices under the supervision of [Name], [Credential]" in the footer, about page, and auto-response email.
+
+Use "Provisionally Licensed" everywhere: credential row, why-cards, location page intros, section headers, auto-response emails, meta descriptions.
+
+Run grep check before launch: `grep -r "Licensed Professional" --include="*.html"` . result must be zero.
+
+Supervisor's credential must be accurate to the letter. LMHC not equivalent to LMHC-D. Confirm the current designation before publishing.
+
+When a credential changes (upgrade or advancement), update the source templates first (render.py, copy_library.py), rebuild the Docker container, then re-run verification checks.
+
+## Copy Structure
+
+One h1 per page. h2 for major sections. h3 for cards or items within a section. Never skip levels.
+
+Footer on every page: phone, hours, address, in identical format.
+
+Phone format: (###) ###-####. Hours: Monday to Friday: 8:00 AM to 5:00 PM (no dashes).
+
+Links use relative paths with .html extension for internal pages. External links include target="_blank" rel="noopener". Phone links use tel:+1 format. Email links use mailto:. Map links open in new tab.
+
+## Image Standards
+
+Format: WebP only in production. No JPGs or PNGs in the webroot.
+
+Every image has descriptive alt text or alt="" if decorative.
+
+loading="lazy" on every image except the above-the-fold hero.
+
+width and height attributes on every img tag to prevent layout shift.
+
+No people, no faces in any generated or stock imagery.
+
+Show the result (clean room, finished floor, complete installation), not the process or equipment.
+
+Hero images: unique per page, named hero-{page-slug}.webp.
+
+## Image Generation
+
+Preferred source: local ComfyUI (FLUX.1 Schnell) or Google Imagen API.
+
+Every generated image passes a vision validation check for people/faces before being saved.
+
+Prompt structure: camera angle + lens + subject + foreground detail + background + lighting + no people.
+
+Specify lens focal length and depth of field. Vague room names produce incoherent scenes.
+
+Never generate: people, faces, cleaning equipment, text overlaid on source, before/after states.
+
+No cleaning machines, vacuums, steam equipment, or hoses in any image.
+
+Show upright equipment only, not flat industrial models.
+
+Machines must look functional and modern, not dated or commercial-scale.
+
+## Image Size Targets
+
+Service card / thumbnail: max 900px wide, 78% quality, 30-80KB target.
+
+Hero image (page header): max 1400px wide, 80% quality, 50-180KB target.
+
+OG / social share image: max 1200px wide, 85% quality, under 150KB.
+
+Images over these targets are rejected at deploy time.
+
+## Prompt Engineering
+
+All prompts follow this structure: {camera angle} {lens} {subject description}, {foreground detail} sharp in foreground, {background} receding into bokeh, {lighting description}, no people, ultra-realistic {type} photography.
+
+This pattern produces correct depth, perspective, and scene geometry because it names every surface explicitly.
+
+Fix incoherent objects by naming every part of the frame: background walls, floor material, ceiling (if visible), and what recedes. Avoid vague room names ("office" without detail). Specify plain surfaces (cream painted wall, white drop ceiling) not implied ones.
+
+Inline negative elements in the prompt itself (no people, no machines, no text), not in a separate negative prompt.
+
+Do not use "wide shot" without a camera angle qualifier.
\ No newline at end of file
diff --git a/OPTIMIZATION.md b/OPTIMIZATION.md
new file mode 100644
index 0000000..75ad181
--- /dev/null
+++ b/OPTIMIZATION.md
@@ -0,0 +1,616 @@
+# OPTIMIZATION - Mobile Responsive, SEO, Testing, and Performance
+Author: Andre Cobham / Arising Media
+Updated: 2026-06-09
+
+## Mobile
+
+Mobile-first CSS. Default styles target 320px and up.
+
+Breakpoints: 360px, 480px, 600px, 768px, 900px, 1023px, 1024px.
+
+Switch to mobile nav at max-width: 1023px, not 768px. A typical header does not fit cleanly below 1024px.
+
+Inline grid styles (style="display:grid;grid-template-columns:1fr 1fr") require !important overrides in media queries to collapse on mobile. Include override block at end of main.css.
+
+Always set: html, body { overflow-x: clip; max-width: 100%; }
+
+Form fields (input, select, textarea) require min-width: 0 and box-sizing: border-box on mobile or they push layout wider than viewport.
+
+Touch targets: 44x44px minimum (WCAG, Apple HIG).
+
+### Verification . Before Declaring Done
+
+Always run a Playwright check at multiple viewport widths. Save the script in
+`.planning/mobile_check.py`:
+
+```python
+from playwright.sync_api import sync_playwright
+
+PAGES = ['/', '/about/', '/services/', '/locations/buffalo.html', '/contact/']
+
+with sync_playwright() as p:
+ b = p.firefox.launch(headless=True)
+ for w in [320, 360, 390, 768, 900, 1023, 1024, 1200]:
+ ctx = b.new_context(viewport={'width': w, 'height': 800})
+ page = ctx.new_page()
+ for path in PAGES:
+ page.goto(f'http://localhost:8096{path}', wait_until='networkidle')
+ r = page.evaluate('() => ({sw: document.documentElement.scrollWidth, cw: document.documentElement.clientWidth})')
+ diff = r['sw'] - r['cw']
+ status = 'OK' if diff <= 0 else f'OVERFLOW +{diff}px'
+ print(f' w={w} {path:<35} {status}')
+ ctx.close()
+ b.close()
+```
+
+Result must be zero overflow on every page at every width.
+
+### Animation on Mobile
+
+Scroll-triggered animations (`data-animate="up"` etc.) work the same on mobile.
+But if you take a full-page screenshot for review, force-trigger them first:
+
+```python
+page.evaluate("() => document.querySelectorAll('[data-animate]').forEach(e => e.classList.add('in-view'))")
+page.wait_for_timeout(500)
+```
+
+Otherwise the screenshot shows blank sections that are actually hiding behind
+the IntersectionObserver.
+
+### Touch Targets
+
+- Tap targets must be at least 44x44px (Apple HIG, WCAG)
+- Header menu button: 44px square minimum
+- Form submit buttons: padding 0.875rem vertical minimum
+- Phone-link CTAs: same
+
+### Test Devices
+
+When the site is "done", verify on:
+- Real iPhone (Safari) . test the form actually submits
+- Real Android phone (Chrome) . same
+- Tablet (iPad) . header switches to mobile menu cleanly at 1023px and below
+- Desktop (any browser) . full nav, hover states work
+
+---
+
+## SEO, Meta, and Schema
+
+Every page on every site must include the full set of head tags below.
+No exceptions.
+
+### Required `` Tags (Every Page)
+
+```html
+
+
+
+
+ {Page-specific title under 60 chars} | {Brand}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
+### OG Image
+
+One default OG image at `/assets/images/og-default.jpg`:
+- 1200x630px
+- Brand colors
+- Logo + company name + city + one descriptor (e.g., "Hardwood Floor Refinishing . Buffalo, NY")
+- Under 200KB optimized
+
+For pages with their own hero image (location, service detail), use that
+image's webp/jpg version as the OG image instead of the default.
+
+### Schema.org JSON-LD
+
+#### Home Page . LocalBusiness
+
+```json
+{
+ "@context": "https://schema.org",
+ "@type": "LocalBusiness",
+ "@id": "https://{domain}/#business",
+ "name": "{Legal business name}",
+ "url": "https://{domain}",
+ "telephone": "+1{10digits}",
+ "email": "{contact email}",
+ "address": {
+ "@type": "PostalAddress",
+ "streetAddress": "{street}",
+ "addressLocality": "{city}",
+ "addressRegion": "{state}",
+ "postalCode": "{zip}",
+ "addressCountry": "US"
+ },
+ "geo": {
+ "@type": "GeoCoordinates",
+ "latitude": {lat},
+ "longitude": {lng}
+ },
+ "areaServed": [
+ { "@type": "City", "name": "Buffalo" },
+ { "@type": "City", "name": "Amherst" }
+ ],
+ "openingHoursSpecification": [{
+ "@type": "OpeningHoursSpecification",
+ "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],
+ "opens": "08:00",
+ "closes": "17:00"
+ }],
+ "aggregateRating": {
+ "@type": "AggregateRating",
+ "ratingValue": "4.9",
+ "reviewCount": "47"
+ }
+}
+```
+
+#### Service Detail Pages . Service
+
+```json
+{
+ "@context": "https://schema.org",
+ "@type": "Service",
+ "serviceType": "{Service name}",
+ "provider": { "@id": "https://{domain}/#business" },
+ "areaServed": { "@type": "AdministrativeArea", "name": "Erie County, NY" },
+ "url": "https://{domain}{path}"
+}
+```
+
+#### Location Pages . LocalBusiness with areaServed Override
+
+Same as the home `LocalBusiness` schema but override `areaServed` to the
+specific city, and include a different `@id` per page.
+
+#### Every Page . BreadcrumbList
+
+```json
+{
+ "@context": "https://schema.org",
+ "@type": "BreadcrumbList",
+ "itemListElement": [
+ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://{domain}/" },
+ { "@type": "ListItem", "position": 2, "name": "Services", "item": "https://{domain}/services/" },
+ { "@type": "ListItem", "position": 3, "name": "Floor Refinishing" }
+ ]
+}
+```
+
+#### FAQ Pages or Sections . FAQPage
+
+```json
+{
+ "@context": "https://schema.org",
+ "@type": "FAQPage",
+ "mainEntity": [{
+ "@type": "Question",
+ "name": "How long does refinishing take?",
+ "acceptedAnswer": { "@type": "Answer", "text": "Most rooms take 2 to 3 days..." }
+ }]
+}
+```
+
+### robots.txt
+
+Every site needs one at `/robots.txt`:
+
+```
+User-agent: *
+Allow: /
+Disallow: /api/
+
+Sitemap: https://{domain}/sitemap.xml
+```
+
+### sitemap.xml
+
+Generate at the end of every build. Save at `/sitemap.xml`. One `` entry
+per page. Use `` from the file's mtime.
+
+```xml
+
+
+
+ https://{domain}/
+ 2026-05-08
+ 1.0
+
+
+ https://{domain}/services/floor-refinishing.html
+ 2026-05-08
+ 0.8
+
+
+```
+
+After deploy, submit the sitemap to Google Search Console.
+
+### Title and Description Rules
+
+- **Title** under 60 characters. Format: `{Service} | {Brand} . {City}, {State}`
+- **Description** 150-160 characters, action-oriented, include city + service, phone when possible
+- Never use the same title/description on multiple pages
+- City + service name in title for location and service pages (huge SEO impact)
+- No em-dashes in meta tags. Use `|` pipe as brand separator
+- Always include `` . 5-10 comma-separated terms, city + service variants
+
+### Title/Meta Examples (Lahrcarpetcleaning.com Reference)
+
+Homepage:
+```html
+Lahr Carpet Cleaning | Residential & Commercial Carpet Cleaning . Finger Lakes, NY
+
+
+
+```
+
+Service page:
+```html
+Carpet Cleaning | Lahr Carpet Cleaning . Waterloo, NY
+
+
+```
+
+Location page:
+```html
+Carpet Cleaning in Seneca Falls, NY | Lahr Carpet Cleaning
+
+
+```
+
+### Audit Before Launch
+
+```bash
+# All pages have title
+grep -L '' site/**/*.html
+
+# All pages have canonical
+grep -L '<link rel="canonical"' site/**/*.html
+
+# All pages have og: tags
+for f in $(find site -name "*.html"); do
+ grep -q 'property="og:' "$f" || echo "MISSING og: $f"
+done
+
+# All pages have JSON-LD
+for f in $(find site -name "*.html"); do
+ grep -q 'application/ld+json' "$f" || echo "MISSING schema: $f"
+done
+```
+
+Each command should return zero results before declaring done.
+
+### llms.txt . AI Crawler Documentation
+
+Every project must include `/llms.txt` at the site root. This is the emerging standard (llmstxt.org) for telling AI crawlers (Perplexity, Claude, GPT) what your site does and what they should/should not index.
+
+**Location:** `src/llms.txt` (Docker) or `public_html/llms.txt` (cPanel)
+
+**Minimum content:**
+
+```
+# {Brand Name}
+> {One-line description of what the site does}
+
+{2-3 sentence description of the business, services, and target audience.}
+
+## Services
+- {Service 1}
+- {Service 2}
+
+## Pages
+- /: Homepage
+- /about/: About
+- /contact/: Contact
+
+## Not for external use
+- /api/: Internal API endpoints
+- /account/: User account pages
+```
+
+**robots.txt must also disallow /api/ and private paths** . llms.txt is the invitation, robots.txt is the boundary.
+
+---
+
+## Testing and Verification
+
+Before declaring a site done, run every check in this document and show the
+output. No exceptions.
+
+### The Law
+
+Before stating ANYTHING works, is configured, is ready, is installed, or is
+complete . run a live test and show the raw output. No output = it was not
+tested. Not for plugins, not for logins, not for deploys. Test it. Show the proof.
+
+### Build Verification
+
+After running build scripts:
+
+```bash
+# Zero unreplaced placeholders
+grep -rn "{{" site/locations/*.html site/services/*.html
+# Result: empty
+```
+
+### Container Health
+
+```bash
+docker compose ps
+# All services "Up" and (healthy) where applicable
+
+docker logs {project}-api-1 2>&1 | tail -20
+# No errors, no stack traces
+
+curl -s -o /dev/null -w "%{http_code}\n" http://localhost:{port}/
+# 200
+```
+
+### URL Surface Check
+
+Every public URL returns 200. Every sensitive URL returns 404.
+
+```bash
+# Public . should all be 200
+for p in "/" "/about/" "/services/" "/locations/" "/locations/buffalo.html" \
+ "/services/floor-refinishing.html" "/contact/" "/reviews/" \
+ "/assets/css/main.css" "/components/header.html" "/api/health"; do
+ curl -s -o /dev/null -w "%{http_code} ${p}\n" http://localhost:{port}${p}
+done
+
+# Sensitive . should all be 404
+for p in "/Dockerfile" "/nginx.conf" "/.env" "/api/.env" "/.git/HEAD" \
+ "/build_locations.py" "/docker-compose.yml" "/README.md"; do
+ curl -s -o /dev/null -w "%{http_code} ${p}\n" http://localhost:{port}${p}
+done
+```
+
+### Container Content Check
+
+Confirm sensitive files are not inside the nginx container:
+
+```bash
+docker exec {project}-web-1 ls /usr/share/nginx/html/
+# Only public folders + index.html. No api/, no Dockerfile, no .env
+
+docker exec {project}-web-1 ls /usr/share/nginx/html/api/ 2>&1
+# Result: "No such file or directory" (api was correctly excluded from web image)
+```
+
+### Mobile Responsive Check (Playwright)
+
+```python
+from playwright.sync_api import sync_playwright
+
+PAGES = ['/', '/about/', '/services/', '/services/floor-refinishing.html',
+ '/locations/', '/locations/buffalo.html', '/contact/', '/reviews/']
+
+with sync_playwright() as p:
+ b = p.firefox.launch(headless=True)
+ fails = 0
+ for w in [320, 360, 390, 768, 900, 1023, 1024, 1200]:
+ ctx = b.new_context(viewport={'width': w, 'height': 800})
+ page = ctx.new_page()
+ for path in PAGES:
+ page.goto(f'http://localhost:{port}{path}', wait_until='networkidle')
+ r = page.evaluate('() => ({sw: document.documentElement.scrollWidth, cw: document.documentElement.clientWidth})')
+ diff = r['sw'] - r['cw']
+ status = 'OK' if diff <= 0 else f'OVERFLOW +{diff}px'
+ print(f' w={w} {path:<40} {status}')
+ if diff > 0: fails += 1
+ ctx.close()
+ print(f'\nfails: {fails}')
+ b.close()
+```
+
+Result must be `fails: 0` across every page at every width.
+
+### Form Submission End-to-End
+
+After Resend domain is verified:
+
+```bash
+# Validation rejection test
+curl -s -X POST http://localhost:{port}/api/estimate \
+ -H "Content-Type: application/json" \
+ -d '{"name":"","email":"bad"}'
+# Expected: {"error":"Validation failed.","fields":[...]}
+
+# Real submission test
+curl -s -X POST http://localhost:{port}/api/estimate \
+ -H "Content-Type: application/json" \
+ -d '{"name":"Test","email":"acobham@arisingmedia.us","phone":"(716) 555-1234","address":"100 Test St","city":"Buffalo","zip":"14201","service":"refinishing","message":"E2E test","token":""}'
+# Expected: {"ok":true}
+
+# Verify the email actually arrived in the destination inbox
+```
+
+### Idempotency Test
+
+Send the same payload twice. Both should return `{"ok":true}`. Inbox should
+receive only ONE email (Resend deduplicates via Idempotency-Key).
+
+### Rate Limit Test
+
+Send 6 requests rapidly from the same IP:
+```bash
+for i in 1 2 3 4 5 6; do
+ curl -s -X POST http://localhost:{port}/api/estimate \
+ -H "Content-Type: application/json" \
+ -d "{\"name\":\"RL$i\",\"email\":\"a@b.co\",\"phone\":\"(716) 555-1234\",\"address\":\"x\",\"service\":\"x\",\"token\":\"\"}"
+ echo ""
+done
+# Requests 1-5: 200 or 422
+# Request 6: 429 Too Many Requests
+```
+
+### SEO Surface
+
+```bash
+# Every page has <title>
+grep -L "<title>" site/**/*.html
+# Result: empty
+
+# Every page has canonical
+grep -L 'rel="canonical"' site/**/*.html
+
+# Every page has og:title
+for f in $(find site -name "*.html"); do
+ grep -q 'property="og:title"' "$f" || echo "MISSING og: $f"
+done
+
+# robots.txt and sitemap.xml exist and are served
+curl -s http://localhost:{port}/robots.txt | head -5
+curl -s http://localhost:{port}/sitemap.xml | head -10
+```
+
+### Dash Check (Content Rule)
+
+```bash
+grep -rn '.\|–\|—\|–' site/ --include="*.html" --include="*.json"
+# Result: empty
+```
+
+### Lighthouse / PageSpeed (Recommended)
+
+Run https://pagespeed.web.dev/ on the live URL after launch. Targets:
+- Performance: 90+
+- Accessibility: 95+
+- Best Practices: 95+
+- SEO: 100
+
+If accessibility is below 95, common fixes:
+- Color contrast on body text (WCAG AA = 4.5:1 for normal text)
+- Form labels associated with inputs (`<label for="...">`)
+- Alt text on every meaningful image
+- Skip-to-main-content link
+- Focus indicators not removed in CSS
+
+### Browser Test Matrix
+
+Test in:
+- Firefox (current) . desktop + mobile emulation
+- Chrome (current) . desktop + mobile emulation
+- Safari (current) . desktop + iOS emulator if possible
+- Real iPhone . actual phone, actual Safari
+- Real Android . actual phone, actual Chrome
+
+The form must actually submit and produce a real email on the real phones.
+That's the launch gate.
+
+### Pre-Launch Sign-Off
+
+Don't ship until ALL of these are green:
+- [ ] All public URLs return 200
+- [ ] All sensitive URLs return 404
+- [ ] No sensitive files inside nginx container
+- [ ] Zero mobile horizontal overflow at 320-1440px
+- [ ] Form submission produces a real email
+- [ ] Idempotency dedupe works (same payload twice = one email)
+- [ ] Rate limit triggers at 6th request
+- [ ] All pages have title, description, canonical, og:, schema JSON-LD
+- [ ] robots.txt and sitemap.xml exist and are accessible
+- [ ] Zero em-dashes anywhere in HTML or JSON
+- [ ] Resend domain shows fully green (SPF + DKIM + DMARC)
+- [ ] First test email lands in primary inbox, not spam
+- [ ] Tested on real iPhone and real Android device
+- [ ] Lighthouse score 90+ across all four categories
+
+---
+
+## Performance Standards
+
+### Images
+
+- Must be WebP, converted via `convert-to-webp.py`
+- Service cards / thumbnails: max 900px wide, 78% quality, 30–80KB target
+- Hero images: max 1400px wide, 80% quality, 50–180KB target
+- OG images: max 1200px wide, 85% quality, under 150KB
+
+### Videos
+
+- Hero video: mp4 + webm pair
+- Max ~5MB per clip
+- Stitched reels: concatenated via ffmpeg
+
+### Cache Headers
+
+- Static assets (jpg, png, webp, css, js, svg, woff, woff2, mp4, webm): `Cache-Control: public, immutable; expires 30d`
+- HTML pages: `Cache-Control: no-cache, must-revalidate` (or vary by deployment)
+- API responses: `Cache-Control: no-store`
+
+### JavaScript
+
+- No render-blocking JS (use `defer` or `type="module"`)
+- Vanilla JS only, no frameworks
+- `fetch`, `IntersectionObserver`, `querySelector`
+
+### CSS
+
+- No unused CSS
+- Plain CSS only, no Sass/Tailwind
+- `tokens.css` (design tokens) + `main.css` (components)
+- Inline `<style>` blocks only for critical above-the-fold styles
+
+### HTML
+
+- One `<h1>` per page
+- Semantic tags: `<main>`, `<section>`, `<article>`, `<aside>`, `<header>`, `<footer>`, `<nav>`
+- Every `<img>` has `alt`, `width`, `height`, and `loading="lazy"` (except hero)
+- No inline event handlers (onclick, onload, etc.)
+- defer or async on all non-critical `<script>` tags
+
+### Lighthouse Targets
+
+- Performance: 90+
+- Accessibility: 95+
+- Best Practices: 95+
+- SEO: 100
+
+Minimum viable scores for launch:
+- Performance: 80+ (mobile), 90+ (desktop)
+- Accessibility: 90+
+- Best Practices: 90+
+- SEO: 95+
diff --git a/STACK.md b/STACK.md
new file mode 100644
index 0000000..0633c31
--- /dev/null
+++ b/STACK.md
@@ -0,0 +1,1770 @@
+# STACK — Architecture, Deployment, and Build Pipeline
+Author: Andre Cobham / Arising Media
+Updated: 2026-06-09
+
+## Stack Philosophy
+
+Two primary stacks. Pick based on page count and update frequency.
+
+### Stack A — PHP Router + SQLite (50+ pages, standard as of 2026-05-21)
+
+- **PHP Router** — `router.php` dispatches every content URL to the correct PHP template. Edit one template = entire page class updates on next request. No find-and-replace. No file edits.
+- **SQLite** — single-file content DB. `pages.sqlite` holds all page content (title, meta, sections JSON, schema). 10,000 rows = 5MB. Sub-millisecond reads. No server process.
+- **Vanilla JavaScript** — no frameworks. `fetch`, `IntersectionObserver`, `querySelector`
+- **Plain CSS** — `tokens.css` (design tokens) + `main.css` (components). No Sass, no Tailwind
+- **Docker + nginx** — nginx routes `/assets/*` directly; all content URLs → PHP-FPM → router.php
+- **Resend** — transactional email via `/api/contact.php`
+- **Reference:** `arisingmedia.us` — 10,000+ pages
+
+### Stack B — Static HTML (fewer than 50 pages)
+
+- **Static HTML** — every page is a `.html` file on disk
+- Same JS, CSS, Docker, nginx, Resend as Stack A
+- Python 3 stdlib for build scripts (no pip)
+- **Reference:** `lahrcarpetcleaning.com`
+
+### Never Use (Both Stacks)
+
+- Node.js / npm packages on the website. Front-end JS uses ZERO packages
+- WordPress for new builds (we migrate clients OUT of WordPress)
+- CSS frameworks (Bootstrap, Tailwind, Bulma)
+- JS frameworks (React, Vue, Angular, Svelte)
+- jQuery, Lodash, Moment, axios, or any utility library
+- CSS-in-JS, styled-components
+- Build tools that require `node_modules` (webpack, vite, parcel, esbuild)
+- Tracking pixels other than what the client explicitly requests
+
+### Why This Stack
+
+1. **Performance** — a static HTML page with vanilla JS loads in <100ms with no parse cost from frameworks
+2. **Longevity** — no dependency rot. A site we build today still works in 10 years with no maintenance
+3. **Security** — no `npm audit` warnings, no supply-chain attack vectors, no transitive deps to patch
+4. **Auditability** — every line on the site is something we wrote and can read in plain text
+5. **Hosting** — a static folder + tiny Python container fits in the smallest VM tier any provider sells
+
+### When to Add a Server-Side Service
+
+Static-only is the default. Add a small Python service ONLY when needed for:
+- Form submission (handled via Resend in the stdlib HTTP server pattern)
+- A specific dynamic feature the client paid for (e.g., booking widget, AI chat)
+
+Each service is its own Docker container. Keep them small (single file when possible).
+Use Python `http.server` + `urllib` from stdlib. Do not introduce Flask, FastAPI, Django, or any third-party HTTP framework.
+
+---
+
+## Project Structure
+
+Two folders per project: source and deployment.
+
+### Source Folder
+
+Lives in the dev tree under `concept-agent/projects/{domain}/site/`.
+Contains everything needed to maintain and rebuild the site.
+
+```
+{domain}/site/
+├── index.html # home page
+├── about/index.html # /about/
+├── contact/index.html # /contact/
+├── reviews/index.html # /reviews/
+├── blog/index.html # /blog/
+├── locations/ # location pages
+│ ├── index.html # /locations/
+│ ├── _template.html # template stamped with JSON
+│ ├── buffalo.html # generated, flat URL
+│ ├── amherst.html
+│ └── ...
+├── services/
+│ ├── index.html
+│ ├── _template.html
+│ ├── floor-refinishing.html
+│ └── ...
+├── components/
+│ ├── header.html # loaded via fetch() by components.js
+│ └── footer.html
+├── data/
+│ ├── locations.json # source data for build_locations.py
+│ └── services.json # source data for build_services.py
+├── assets/
+│ ├── css/
+│ │ ├── main.css # variables, reset, layout
+│ │ └── components.css # cards, hero, header, footer, nav, responsive
+│ ├── js/
+│ │ ├── main.js # scroll animations, count-up, etc.
+│ │ ├── components.js # fetch + inject header/footer
+│ │ └── form.js # form validation + submit
+│ ├── images/
+│ ├── videos/ # hero video files (.mp4 + .webm)
+│ └── fonts/ # only if not using Google Fonts CDN
+├── build_locations.py # JSON → flat .html stamping
+├── build_services.py
+└── README.md # project notes, content sources, status
+```
+
+### Deployment Folder
+
+Lives at `/home/sirdrez/arisingmedia-websites/{domain}/`.
+Contains ONLY what's needed to run `docker compose up`.
+
+```
+{domain}/
+├── index.html # all public website folders
+├── about/ # ↑
+├── assets/ # ↑
+├── blog/ # ↑
+├── components/ # ↑
+├── contact/ # ↑
+├── locations/ # ↑
+├── reviews/ # ↑
+├── services/ # ↑
+├── api/ # form-submit Python service (if used)
+│ ├── server.py
+│ ├── Dockerfile
+│ ├── .env # gitignored — Resend key, etc.
+│ └── .env.example
+├── Dockerfile # nginx web container
+├── nginx.conf
+├── docker-compose.yml
+├── .dockerignore
+├── .gitignore
+└── .planning/ # everything not needed at runtime
+ ├── build_locations.py # build scripts moved here
+ ├── data/ # JSON sources moved here
+ ├── README.md
+ ├── DNS_*.txt # DNS notes
+ └── review_*.png # design review screenshots
+```
+
+### What Goes Where
+
+**Source folder gets** every working file (build scripts, data JSON, screenshots,
+notes, raw assets). This is the dev/maintenance copy. NOT what gets deployed.
+
+**Deployment folder gets** ONLY the rendered website + the small API service.
+Build scripts, JSON data, and notes go into `.planning/` to keep root clean and
+prevent accidental web exposure.
+
+### URL Structure — Two Valid Patterns
+
+#### Pattern A: Flat HTML (default for Docker/nginx projects)
+
+nginx `try_files $uri $uri/ $uri.html =404` serves `/locations/buffalo` and
+`/locations/buffalo.html`. Canonical form: `/locations/buffalo.html`.
+
+Why flat:
+- One file = one page, no `/index.html` confusion
+- Easier sitemap generation
+- `<a href>` links are unambiguous
+- Crawl budget benefit — Google indexes one URL per page, not two
+
+#### Pattern B: Directory-style (default for cPanel/Apache projects)
+
+Each page lives at `{slug}/index.html`. Apache auto-serves `index.html` when
+visiting `/{slug}/`. Use this when deploying to cPanel shared hosting.
+
+```
+services/
+├── carpet-cleaning/index.html → /services/carpet-cleaning/
+├── stairs/index.html → /services/stairs/
+commercial/
+├── offices/index.html → /commercial/offices/
+└── vacation-rentals/index.html → /commercial/vacation-rentals/
+```
+
+### Lahrcarpetcleaning.com Reference (Directory-Style, cPanel)
+
+```
+lahrcarpetcleaning.com/
+├── index.html
+├── about/index.html
+├── contact/index.html
+├── reviews/index.html
+├── service-area/index.html
+├── locations/
+│ ├── index.html
+│ ├── waterloo-ny/index.html
+│ ├── geneva-ny/index.html
+│ └── ... (20 location pages)
+├── services/
+│ ├── carpet-cleaning/index.html
+│ ├── stairs/index.html
+│ ├── upholstery/index.html
+│ ├── floors/index.html
+│ ├── area-rugs/index.html
+│ ├── add-ons/index.html
+│ └── commercial/index.html
+├── commercial/
+│ ├── offices/index.html
+│ ├── vacation-rentals/index.html
+│ ├── hotels-inns/index.html
+│ ├── retail-showrooms/index.html
+│ └── property-management/index.html
+├── assets/
+│ ├── css/styles.css?v=N ← always cache-bust on change
+│ ├── js/
+│ │ ├── main.js
+│ │ └── components.js ← injects nav+footer via innerHTML
+│ ├── images/
+│ │ ├── hero/ ← hero-{slug}.webp, one per page
+│ │ └── services/ ← {service}.webp card images
+│ └── videos/hero/hero-reel.mp4
+├── tools/ ← NOT deployed to webroot
+│ ├── convert-to-webp.py
+│ ├── gen-images-flux.py
+│ └── gen-hero-images.py
+├── .cpanel.yml
+├── robots.txt
+├── sitemap.xml
+├── 404.html
+└── 500.html
+```
+
+All images are `.webp`. cPanel deployment via `.cpanel.yml`.
+
+---
+
+## Build Pipeline
+
+When a site has many similar pages (location pages, service pages, blog posts,
+team-member pages), use a JSON + template + Python build script.
+
+### When to Use a Build Script
+
+Use it when there are 4+ pages with identical structure differing only in
+content. For example: 6 location pages where only the city name and
+city-specific copy differs.
+
+For one-off pages (home, about, contact, services index), hand-write the HTML
+directly. Build scripts are for repetition, not for everything.
+
+### Pattern
+
+Three files per template family:
+
+1. **`data/{thing}.json`** — array of objects, one per page
+2. **`{thing}/_template.html`** — HTML with `{{placeholder}}` markers
+3. **`build_{thing}.py`** — stdlib Python, stamps template with data
+
+#### Example: locations.json
+
+```json
+[
+ {
+ "slug": "buffalo",
+ "city": "Buffalo",
+ "state": "NY",
+ "title": "Hardwood Floor Refinishing in Buffalo, NY | Floor It",
+ "meta_description": "Professional hardwood floor refinishing...",
+ "canonical": "https://floorithardwoodfloors.com/locations/buffalo.html",
+ "hero_h1": "Hardwood Floor Refinishing in Buffalo, NY",
+ "hero_lead": "Western New York's most experienced...",
+ "overview_h2": "Buffalo's Trusted Floor Refinishing Specialists",
+ "overview_body_1": "...",
+ "overview_body_2": "...",
+ "faqs": [
+ { "q": "...", "a": "..." }
+ ]
+ }
+]
+```
+
+#### Example: _template.html
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <title>{{title}}
+
+
+ ...
+
+
+