Copperline Heating & Air
HVAC app · built by the Vibecode team
Copperline is a fictional heating and cooling company in Johnson County, Kansas. Visitors check their ZIP, pick a day and a morning or afternoon window with live spots left, and book a furnace or AC visit; an emergency strip, upfront prices, seasonal offers, financing and a two-tier maintenance plan sit on the same site. The owner gets a dispatch board with a row per technician, where requests are dragged onto the day, plus customers with the equipment on file, plan members with renewal dates and a publish checklist. Technicians sign in on their phone with a PIN and tap On my way, Arrived and Job done. Every photo, review and technician is a labelled sample, and the demo dates move forward each day.
- Web app
- Built in 4 prompts
- Free to remix

Remix copies the working app into your account for free, exactly as we built it. It runs in your browser.
The prompt that builds it
We built Copperline Heating & Air in 4 prompts. Here they are folded into one, so a single paste into a new app builds the finished version.
Prompt · 8,686 words
Build "Copperline Heating & Air": a complete booking website plus owner admin, dispatch board and customer CRM for a small local HVAC company. The demo business is Copperline Heating & Air, a fictional heating and cooling company in Johnson County, Kansas (Kansas City suburbs: hot summers, cold winters). It is made for HVAC owners with 1 to 15 technicians who get most jobs by phone and Google and run the day from a whiteboard. Their visitor has no heat or no AC right now, or wants a tune-up or a new system quote: they need to know fast whether you cover their ZIP, what it costs to come out, and how to get someone there. The owner wants the call or the booking, plan members who renew, and one screen that shows who is going where today.
It must look like a polished, designed local business, not an AI template: no purple or blue gradients, no emoji, no glassmorphism, no default shadcn look, real typography, one accent colour (copper).
Honesty rules (these matter to real contractors): the business, people, photos and reviews are fictional and are labelled as demo or sample in the UI as described below. Never invent stats ("10,000 happy customers", "#1 rated"). Any business fact left empty in admin hides its UI instead of showing a placeholder. Site copy is plain, local and calm, with short sentences and no em dashes.
## Reference screenshots (look at them first)
First download every reference screenshot with curl into refs/ in the workspace and look at each one before writing code:
1. https://webtpl-hvac-company-site-refs.beacon.host/01-utility-bar-header-hero.jpg : a big HVAC company's header. A thin utility row (Locations, Membership, Offers, Financing, Contact, phone, a solid "Book now" pill) above the main nav. Borrow the utility row with Membership, Offers and Financing links and the always-visible phone plus Book button. Not its brand, mascot or red.
2. https://webtpl-hvac-company-site-refs.beacon.host/02-header-rating-phone-schedule.jpg : a header that puts the Google rating, a phone number with an icon and "Schedule My Visit" side by side. Our header's right side follows this order: rating chip, phone, Book a visit.
3. https://webtpl-hvac-company-site-refs.beacon.host/03-emergency-strip-services.jpg : a full-width coloured strip under the header with an icon and one sentence about no trip charge, then a compact two-column services list with round icons. Our emergency strip and the service icon list use this pattern.
4. https://webtpl-hvac-company-site-refs.beacon.host/04-plan-benefit-columns.jpg : a maintenance plan's benefits in three columns with a coloured header bar on each (Preventative maintenance / Priority service / Member savings). Our plan page's benefit columns.
5. https://webtpl-hvac-company-site-refs.beacon.host/05-plan-two-tiers.jpg : two plan tiers side by side with price per month or per year and a checklist. Our plan tiers, far cleaner.
6. https://webtpl-hvac-company-site-refs.beacon.host/06-dispatch-board.jpg : ServiceTitan's dispatch board: a row per technician (avatar, name, status dot) and a time axis across the top (7 AM to 12 PM...), job blocks placed on the timeline, coloured by type, with the customer and street. Our /admin dispatch board copies this layout.
7. https://webtpl-hvac-company-site-refs.beacon.host/07-phone-call-book-buttons.jpg : the same company's phone header: two big buttons, phone number and "Book Online", right under the logo. Our phone layout gets a fixed bottom bar instead (Call / Text / Book).
8. https://webtpl-hvac-company-site-refs.beacon.host/08-jobber-admin-workflow-home.jpg : Jobber's home: workflow cards with coloured top borders and big counts. Our admin Today cards.
9. https://webtpl-hvac-company-site-refs.beacon.host/09-jobber-admin-customer-detail.jpg : Jobber's client detail: name with a badge, action buttons, contact column, notes. Our customer detail layout.
10. https://webtpl-hvac-company-site-refs.beacon.host/10-google-reviews-panel.jpg : a Google Business Profile reviews panel: big average, 5-to-1 bar histogram, topic chips, initial avatars, relative dates. Our reviews section.
If an image Read comes back empty, shrink it to 720px wide with ffmpeg and read it again; don't stall on it.
## Stack and ground rules
- Use this workspace's stack: React + Vite + Tailwind + React Router + React Query + Framer Motion + lucide-react in webapp/, Hono on Bun in backend/. Use the database-auth skill for Prisma (SQLite) and Better Auth, the upload-assets skill for Vibecode Storage, and the vibecode-apis skill for image generation and Resend email. Shared Zod contracts in backend/src/types.ts.
- The public site is never behind a password. Only /admin (owner) and /tech (technician PIN) are.
- Seed realistic demo data automatically on backend start when the database is empty (so fresh copies work), including the owner account.
- Remixes get a copy of backend/.env with BETTER_AUTH_SECRET cleared, and the standard env check would then stop the backend at boot. Add backend/src/lib/authSecret.ts exactly as below and call ensureAuthSecret() in backend/src/env.ts before the environment is validated (keep the validation):
```ts
import { randomBytes } from "node:crypto";
import { existsSync, readFileSync, writeFileSync } from "node:fs";
import { join } from "node:path";
const LINE = /^[ \t]*(?:export[ \t]+)?BETTER_AUTH_SECRET[ \t]*=(.*)$/gm;
/** Remixes get a copy of .env with this value cleared, so a fresh copy generates and saves its own secret on first start. */
export function ensureAuthSecret(envPath = join(import.meta.dir, "..", "..", ".env")) {
if (process.env.BETTER_AUTH_SECRET?.trim()) return;
const secret = randomBytes(32).toString("base64");
const line = `BETTER_AUTH_SECRET=${secret}`;
try {
const text = existsSync(envPath) ? readFileSync(envPath, "utf8") : "";
// Bun only loads the .env in the working directory, so a saved secret can exist without being in process.env.
const saved = [...text.matchAll(LINE)].map((m) => m[1]!.trim().replace(/^(["'])(.*)\1$/, "$2")).filter(Boolean).pop();
if (saved) { process.env.BETTER_AUTH_SECRET = saved; return; }
writeFileSync(envPath, text.match(LINE) ? text.replace(LINE, () => line) : `${text}${text && !text.endsWith("\n") ? "\n" : ""}${line}\n`);
} catch (e) {
console.warn("Couldn't save BETTER_AUTH_SECRET to .env; logins will reset when the server restarts", e);
}
process.env.BETTER_AUTH_SECRET = secret;
console.log("Generated a new BETTER_AUTH_SECRET");
}
```
- Owner sign-in is email + password. Seeded owner: email `owner@copperlinehvac.example`, password `Copperline-2026`. Show these on the /admin sign-in page in a card titled "Demo owner login" with a "Use demo login" button that fills both fields, until the owner changes the password in Settings. Disable public sign-up on the server (only the seeded owner exists). Every /api/admin/* route checks the session on the server.
- Never store a visitor's IP address or user agent: blank ipAddress and userAgent whenever a Better Auth session is created or updated (databaseHooks.session create/update before hooks). Keep rate limiting as it is.
- Replace the template's favicon.ico, og image, title and meta. No Vibecode branding anywhere: favicon, title, share image, footer, meta generator.
## The database ships with the project (important)
Before the platform recycles an idle sandbox it saves the workspace with `git add --all`, and a remix copies only what is in git. So:
- Track the database: no .gitignore rule may match backend/prisma/dev.db (or dev.db-wal/-shm/-journal, or *.db). dev.db is committed. Seed an empty or missing database; never delete or re-seed a database that already has rows.
- Keep the demo current without re-seeding: store the calendar day the demo was seeded (a DemoState row: seededDay in America/Chicago). At backend startup, before the server answers, and then once an hour: if whole calendar days have passed since that day, move every seeded demo timestamp forward by that many days (created, updated, scheduled job start/end, status times, plan start/renewal, offer start/expiry, review dates, events, notes) and save the new day. Shift only rows the seed created (an isDemo flag), never rows a user created or edited. Then the dispatch board always shows a full "today", renewals stay "in 12 days", offers stay current, and "Last booking: 2 hours ago" stays true.
- Dates use the business timezone (America/Chicago) everywhere, server and client, so a job at 8 AM is 8 AM for the owner wherever the server runs.
## Look and feel: "Copper & Frost"
- Colours (CSS variables, used through Tailwind tokens):
- ink `#14202B` (headings, dark sections, footer), ink-800 `#1E2E3C` (cards on dark), ink-600 `#3A4B5C`
- copper `#C2622D` (the one accent: primary buttons, links on hover, active chips, stars, price numerals), copper-700 `#A24E20` (hover, copper text on white for contrast), copper-50 `#FBF1EA` (tinted backgrounds for offer cards and selected states)
- frost `#E8F1F6` (alternate light sections), frost-300 `#B9D3E1` (hairlines and small labels on ink, cool-side icons)
- paper `#FBFAF8` (page background), white (cards), body text `#24313D`, muted `#5D6B78`, line `#E2E6EA`
- success `#2E7D4F`, warning `#B7791F`, error `#B42318`
- The emergency strip uses ink `#14202B` with a copper icon and white text (not red; one accent).
- Type: "Archivo" (Google Fonts, 600/700/800) for headings in sentence case with letter-spacing -0.02em; "Inter" (400/500/600) for body and UI. H1 64px/1.02 desktop, 38px phone. H2 42px/1.08 desktop, 30px phone. H3 22px. Eyebrows: Inter 600 12px uppercase, letter-spacing .12em, copper-700 on light, frost-300 on ink. Body 17px/1.6 desktop, 16px phone. Prices and times use tabular numbers. Every H1 and H2 uses `text-wrap: balance`, and every displayed phone number stays on one line (white-space: nowrap), admin included.
- Corners: 10px radius on cards, inputs and buttons; chips are pill-shaped; avatars and map pins round. Shadows only as a soft `0 1px 2px rgb(20 32 43 / .06), 0 8px 24px rgb(20 32 43 / .06)` on raised cards; otherwise 1px line borders. Cards lift 2px on hover.
- Buttons: primary = copper background, white text, Inter 600 16px, height 50px (40px small), padding 0 22px. Secondary = white with a 1px line border and ink text (on ink: transparent with frost-300 border and white text).
- Spacing scale 4/8/12/16/24/32/48/64/96. Sections 96px vertical padding desktop, 64px phone. Container 1200px max, 32px side padding desktop, 20px phone.
- Icons: lucide-react at 1.75 stroke (Snowflake for cooling, Flame for heating, Wind for air quality and ducts, Thermometer, Wrench, Phone, MessageSquare, CalendarCheck). Service icons sit in 40px round frost circles. No emoji anywhere.
- Logo: an inline SVG React component: a 34px rounded-square (8px radius) in ink holding a copper sine-wave line crossing a frost-blue line (hot and cold air), then "Copperline" in Archivo 800 22px ink with "HEATING & AIR" under it in Inter 600 9px letter-spacing .22em muted. Same mark for the favicon (SVG plus 32px PNG and 180px apple-touch icon).
## Business facts (one source of truth)
Stored once in the Business table and used everywhere (header, strip, footer, forms, FAQ answers, schema, llms.txt):
- Name: Copperline Heating & Air. Base: Overland Park, KS 66212 (no street address shown anywhere). Area: Johnson County, Kansas.
- Phone and text: (913) 555-0186 → `tel:+19135550186`, `sms:+19135550186`, WhatsApp `https://wa.me/19135550186`. Email: service@copperlinehvac.example
- Kansas/Johnson County mechanical contractor license (demo) JC-MECH-48211. Insured: "$2M general liability, workers' comp". EPA 608 certified technicians. In business since 2009. Owner Theo Brandt.
- Hours: office Mon–Fri 7:00 AM–6:00 PM, Sat 8:00 AM–2:00 PM, Sun closed. Emergency line 24/7 (a flag on the business: emergencyService true). Timezone America/Chicago, USD, en-US.
- Diagnostic fee: $89, "waived when you approve the repair". Members: $0 diagnostic.
- Google review link (demo): `https://www.google.com/maps/search/?api=1&query=Copperline+Heating+%26+Air+Overland+Park+KS`. Instagram and Facebook placeholders. GTM ID and Google Ads IDs empty. Financing link (demo): `https://example.com/financing` with the owner-editable label "Apply for financing".
- Service area (town, ZIP, lat, lng): Overland Park 66212 38.9590,-94.6810 · Overland Park 66213 38.8996,-94.7020 · Olathe 66061 38.8814,-94.8191 · Olathe 66062 38.8580,-94.7590 · Lenexa 66215 38.9536,-94.7336 · Shawnee 66216 39.0228,-94.7152 · Leawood 66206 38.9667,-94.6169 · Prairie Village 66208 38.9917,-94.6336 · Merriam 66203 39.0236,-94.6936 · Mission 66202 39.0278,-94.6558 · Roeland Park 66205 39.0375,-94.6322 · Gardner 66030 38.8108,-94.9272 · Spring Hill 66083 38.7431,-94.8255 · De Soto 66018 38.9792,-94.9686
- Phone numbers display as "(913) 555-0186". Dates are always human-readable: "Today, 9:42 AM", "Yesterday", "Tue, Nov 25", "Nov 25, 2025". Reviews use Google-style relative dates ("3 weeks ago") with the exact date in a tooltip. Booking windows read "Morning, 8 AM–12 PM" and "Afternoon, 12–4 PM".
## Demo labelling
- Business.demoMode is on by default. While on: a slim dismissible bar above everything (ink-800, frost-300 text 13px, X button, dismissal remembered in localStorage): "Demo site. Copperline is a fictional company; photos are AI samples and reviews are placeholders. Owner sign-in: /admin" (the /admin part is a link).
- Every seeded image shows a small chip in its bottom-left corner: "Sample photo" (Inter 600 10px uppercase, letter-spacing .1em, white on rgb(20 32 43 / .6), 6px radius). Each image row has an isSample flag; images the owner uploads have it off. Below 160px of image width the chip shortens to "Sample" (9px).
- Every seeded review shows a small "Demo review" tag; every seeded tech profile a "Sample profile" tag. The footer says "Demo content: business details, photos, technicians and reviews are placeholders." while demoMode is on.
## Public site, home page top to bottom
1. **Utility row** (ink, 36px, 13px white/frost-300; desktop only): left "Serving Johnson County, KS · License JC-MECH-48211"; right links with small icons: Membership (/plans), Offers (#offers), Financing (#financing), Service area (#area), and the phone "(913) 555-0186" (tel:). Scrolls away.
2. **Sticky header** (white, 76px, 1px bottom line, soft shadow after 8px of scroll): logo left; nav (Inter 600 15px ink): Cooling, Heating, Air quality, Comfort Club, Reviews, About. Cooling and Heating open small dropdowns listing their services. Right, in this order (ref 2): a rating chip "★ 4.9 · 14 reviews" (computed from reviews; links to #reviews; shows a tiny "Demo" tag while reviews are demo), the phone with a Phone icon "(913) 555-0186", and a copper "Book a visit" button (scrolls to #book).
3. **Emergency strip** (ref 3; under the header, full width, ink background, 48px; shown only when the owner's emergency switch is on): copper Siren or AlertTriangle icon, white text "No heat or no AC? We answer 24/7.", a copper text link "Call (913) 555-0186" (tel:) and on desktop a muted note "After-hours visits from $149." The owner edits the text and switches it off in admin; when off it disappears everywhere.
4. **Hero** (desktop 660px, frost background split): left 7/12: eyebrow "Heating & cooling · Johnson County, KS"; H1 "Heat and AC repair, done the same day."; subline "Local technicians, upfront prices and a real person on the phone. $89 diagnostic, waived when you approve the repair."; three check lines with copper check icons: "Same-day and next-day visits", "Upfront price before any work starts", "EPA-certified, licensed and insured"; then text links "Call (913) 555-0186" and "Text us" with icons. Below them, the hero photo (16:9, 10px radius, Sample photo chip): a technician at an outdoor AC condenser beside a suburban house. Right 5/12: the white booking card "Book a visit" (id "book", 440px, 28px padding, copper 4px top border, raised shadow):
- "What do you need?" select: AC repair, Furnace repair, Heat pump service, Tune-up, New system quote, Duct cleaning, "No heat or no AC (urgent)", "Something else".
- "ZIP code" (5 digits): checks the service area live and shows success-green "We cover Lenexa 66215" with a check icon, or muted "Outside our usual area. Book anyway and we'll call you."
- "Pick a day": a row of 7 day pills (scrollable on phone) starting today ("Today", "Tomorrow", then "Sat 22"), Sundays disabled.
- "Pick a time": two option cards "Morning · 8 AM–12 PM" and "Afternoon · 12–4 PM", each with a small availability line ("3 spots left", "1 spot left", "Full", or "Past" for today's morning after 11 AM). Capacity is 2 jobs per tech per window, minus jobs already booked; full windows can't be picked. Choosing "No heat or no AC (urgent)" adds a copper note "Urgent? Calling is fastest: (913) 555-0186" and lets them pick "As soon as possible" instead of a window.
- "Your name", "Mobile number" (auto-formats as you type).
- Button "Book my visit" full width. Microcopy: "No charge to book. We'll text to confirm your arrival window."
- Submits a booking (source "hero") and goes to /booked.
5. **Trust strip** (white, four items in a row with 1px separators): copper icon + small uppercase muted label + Archivo 20px ink value: "Licensed · JC-MECH-48211", "Insured · $2M liability", "Since · 2009", "Google rating · 4.9 ★ (14)". Each hides when its field is empty.
6. **Services** (white, id "services"): eyebrow "Services", H2 "Heating and cooling, fixed right", sub "Every visit starts with an upfront price. You approve it before we start." A 3×2 grid of service cards (ref 3 icon style): 40px frost circle icon, photo strip on top (16:9, Sample chip), name (Archivo 22px), one line, price line in copper-700 Archivo 20px with small muted unit text, and links "Book this" (scrolls to #book with that service selected) and "Details →" (/services/<slug>):
- AC repair (`ac-repair`, Snowflake): "Warm air, short cycling, frozen coils or a unit that won't start." Repairs from $149 · $89 diagnostic.
- Furnace repair (`furnace-repair`, Flame): "No heat, ignition problems, strange smells or a blower that won't quit." Repairs from $149 · $89 diagnostic.
- Heat pump install (`heat-pump-install`, Thermometer): "Heat and cool with one high-efficiency system. Ask about federal tax credits." Installed from $7,900.
- New system quote (`new-system-quote`, Home): "Furnace, AC or both. Sized for your house with a load calculation, not a guess." Free in-home estimate.
- Tune-up (`tune-up`, Wrench): "A 21-point check before the season. Fewer breakdowns and lower bills." $119 per system · Free for members.
- Duct cleaning (`duct-cleaning`, Wind): "Dust, pet hair and construction debris out of your ducts and vents." From $399.
Under the grid: "Prices are starting points. You get the exact price before work starts."
7. **Seasonal offers** (frost section, id "offers"): eyebrow "Offers", H2 "This season's offers". Up to 3 offer cards from the Offer table (copper-50 background, 1px copper/20 border, 10px radius): a small copper tag ("Fall"), title in Archivo 24px, description, terms in 13px muted, an expiry line "Ends Sun, Nov 30" (computed; expired offers hide automatically), and "Book with this offer" (scrolls to #book and adds the offer code to the booking). Seed (dates relative to seed day, they shift with the demo): "Furnace tune-up for $79" (reg. $119, ends in 10 days, code FALL79), "$500 off a new heat pump" (ends in 40 days, code HP500, "Cannot be combined with other offers."), "Free second-opinion visit" (no end date, code SECOND: "Been quoted a new system? We'll take a look before you sign.").
8. **Comfort Club teaser** (white): left: eyebrow "Comfort Club", H2 "Two tune-ups a year. Priority when it breaks.", three icon lines (CalendarCheck "Spring AC and fall furnace tune-ups", Zap "Priority scheduling and no after-hours fees", BadgePercent "15% off repairs"), price "From $14 a month", buttons "See plans" (/plans) and "Join the club" (/plans#join). Right: photo of a technician changing a furnace filter (Sample chip).
9. **Financing** (ink section, id "financing"): eyebrow "Financing", H2 "New system now, monthly payments", text "Most new furnaces, AC units and heat pumps can be paid monthly through our lending partner. Subject to credit approval. Terms depend on the lender.", a small example row in frost-300 ("Example only: a $9,000 system over 60 months"), the copper button with the owner's label "Apply for financing ↗" (opens the owner's financing link in a new tab; hidden when the link is empty), and a secondary "Ask us about financing" (scrolls to #book with "New system quote"). Never name a real lender or promise a rate.
10. **Service area** (white, id "area"): left (5/12): H2 "Where we work", "Based in Overland Park. We cover these Johnson County ZIP codes.", a "Check your ZIP" input + button (same coverage result as the hero), then the towns and ZIPs in two columns (check icon, town, ZIP muted). Right (7/12): a Leaflet map (480px tall, 10px radius, 1px line border) with OpenStreetMap tiles `https://tile.openstreetmap.org/{z}/{x}/{y}.png` and the OSM attribution, greyed slightly with a CSS filter; each ZIP is a copper circle (radius 2,200 m, 18% fill, 1.5px stroke) with a small ZIP label; the base (Overland Park) gets a round ink marker with the logo mark. zoomSnap 0.25, zoomDelta 0.5, fitBounds to all circles with 24px padding after invalidateSize; scroll-zoom off until the map is clicked; `.leaflet-container img.leaflet-tile { mix-blend-mode: plus-lighter; }` to hide tile seams. Checking a ZIP that is covered pans to and pulses its circle. The map must render on phones: explicit height, invalidateSize() after mount and on resize.
11. **Technicians** (frost section, id "team"): eyebrow "Our technicians", H2 "The people who'll come to your door", 5 cards in a row on desktop (horizontal scroll with snap on phone): photo (4:5, Sample photo chip, rounded), name, role, years ("12 years in HVAC"), certifications as small chips ("EPA 608", "NATE"), one line in their words, and the "Sample profile" tag. Each card says on hover "Usually works: Olathe, Lenexa".
12. **Reviews** (white, id "reviews"), Google Business Profile style (ref 10): left: "4.9" in Archivo 64px, five copper stars, "14 reviews", a 5-to-1 histogram with copper bars, a copper "Leave us a review" button (/review) and "See us on Google ↗" (hidden when the link is empty), topic chips with counts ("on time 6", "explained everything 5", "fair price 5", "clean work 4", "same day 4", "furnace 5", "AC 5"). Right: a 2-column grid of six review cards: initial avatar (white on one of #14202B, #2F6F8F, #7A5C3E, #3E6B4E, #8A4F7D, #5B6577), name, "Lenexa · Furnace repair" muted, stars plus relative date, text clamped to 5 lines with "More", the tech's name if mentioned ("Technician: Kayla S."), owner response block (frost background, "Response from the owner") when present, and a footer with a small "G" mark "Google" plus the "Demo review" tag. "See all 14 reviews" expands the rest.
13. **About the owner** (white, a bordered panel): photo of Theo with a service van (Sample chip) left; right: eyebrow "About Copperline", H2 "A local shop, not a call center", text: "I started Copperline in 2009 with one van and a lot of night calls. We're still small on purpose: twelve people, five trucks, and the same few technicians you'll see on this page." / "When you call, someone here answers. When we quote a price, that's the price. If anything we fixed gives you trouble within a year, we come back for free." Then credential lines with copper checks: "Johnson County mechanical license JC-MECH-48211", "EPA 608 certified technicians", "$2M general liability and workers' comp", "1-year labor warranty on every repair", signature "Theo Brandt, Owner".
14. **FAQ** (frost, id "faq"): left (5/12): H2 "Questions we get a lot", "Still have a question? Text us." (sms link). Right (7/12): accordion, first item open, answers filled from Business facts:
- "How much does it cost to come out?" "$89 for a diagnostic visit. If you approve the repair, the $89 is waived. Comfort Club members pay nothing for diagnostics."
- "Do you charge more for nights and weekends?" "After-hours emergency visits start at $149. Comfort Club members pay the regular rate any time."
- "Will I know the price before you start?" "Yes. The technician shows you the price for the repair on a tablet and you approve it before any work begins."
- "Repair or replace?" "If your system is under 12 years old and the repair is under a third of a new system's price, we'll usually tell you to repair it. We'll show you both numbers."
- "How long does a new system install take?" "Most furnace and AC installs take one day. Heat pumps take one to two days. We pull the permit and clean up after."
- "Do you offer financing?" "Yes, on new systems through our lending partner, subject to credit approval. Apply online or ask the technician."
- "What's your warranty?" "One year on labor for every repair. New systems get the manufacturer's 10-year parts warranty when registered, and we register it for you."
15. **Footer** (ink): logo (light version) and "Heating and cooling across Johnson County, Kansas."; columns "Contact" (phone, text, WhatsApp, email), "Hours" (from the hours table plus "Emergency line 24/7" when on), "Service area" (towns as a comma list), "Company" (Comfort Club, Offers, Financing, Reviews, Privacy, Owner sign-in, Technician sign-in); social icons (hidden when empty); bottom row "© 2026 Copperline Heating & Air · License JC-MECH-48211" and the demo line while demoMode is on.
## Other public pages
- **/services/:slug**: hero band (frost) with breadcrumb, H1 (e.g. "AC repair in Johnson County"), the price line, buttons "Book a visit" and "Call (913) 555-0186", the service photo. Then 250–350 words of plain, specific copy (common problems, what the technician checks, typical parts and prices, how long it takes), a "What's included" checklist, a price box ("Repairs from $149 · $89 diagnostic, waived when you approve the repair."), three service FAQs, and the booking card with this service preselected (source "service-<slug>"). Page title "AC Repair in Overland Park & Johnson County, KS | Copperline".
- **/plans** (Comfort Club): hero "Comfort Club" H1 "Two tune-ups a year. Priority when it breaks." with sub "Join for $14 a month. Cancel any time after 12 months."; benefit columns (ref 4; three cards, each with an ink header bar and a copper icon): "Preventive maintenance" (spring AC tune-up, fall furnace tune-up, filter check, reminder texts), "Priority service" (front of the line when it breaks, no after-hours fees, $0 diagnostic), "Member savings" (15% off repairs, $250 off a new system, 2-year labor warranty on repairs). Then two tier cards (ref 5) side by side, with a Monthly/Yearly toggle above them (yearly shows "2 months free"):
- **Comfort** — $14/month or $149/year — covers 1 system (furnace + AC count as one system): 2 tune-ups a year, priority scheduling, $0 diagnostic, 10% off repairs, reminder texts.
- **Comfort Plus** (the "Most chosen" chip) — $22/month or $229/year — everything in Comfort plus: 15% off repairs, no after-hours fees, filters delivered each season (filter size on file), 2-year labor warranty on repairs, $250 off a new system.
Under them, the join form (id "join"): tier, billing (monthly/yearly), name, mobile, email, service address ZIP (coverage check), number of systems (1–3, price multiplies), "Filter size if you know it" (e.g. 16x25x1), and a payment block. Payment: when STRIPE_SECRET_KEY is not set in backend/.env, show a bordered demo box "Demo checkout: no card is charged. Connect Stripe in admin Settings to take real payments." with a disabled card-field mock and the button "Join Comfort Club (demo)". Submitting saves the Member (status "pending_payment" in demo; "active" when Stripe is connected and paid via Stripe Checkout) and goes to /plans/welcome ("You're in, Dana. Your first tune-up: we'll text you to book it."). Plan FAQs below (cancel, transfer when you sell the house, what counts as a system).
- **/booked**: "Thanks, Dana. You're booked." (first name), the summary card: reference "CL-2048", service, ZIP and town, day and window ("Tomorrow, Morning 8 AM–12 PM"), offer code if any, and "What happens next": 1. "We text to confirm your arrival window." 2. "Your technician texts when they're on the way." 3. "You approve the price before any work starts." Buttons "Call now", "Text us", and "Add a photo of the unit" (optional; up to 5 photos to that booking via a one-time token; photos of the data plate help). Fires the conversion once per booking (sessionStorage guard): `dataLayer.push({event: "generate_lead", lead_ref, service, value})`, plus the Google Ads conversion when its ID and label are set.
- **/review**: "How did we do?" with five large stars and an optional name. 4–5 stars: thank-you, "Would you share that on Google? It helps neighbors find us.", a "Leave a Google review" button and an automatic redirect after 3 seconds with a visible countdown. 1–3 stars: a private feedback form ("Sorry it wasn't great. Tell us what happened. This goes straight to Theo.") that saves to Feedback, with a small "You can also post a public review on Google" link kept visible, also after sending. Every rating is saved.
- **/privacy**: plain-English privacy policy from the business facts. A designed 404 page.
## Phone layout (390px)
- Demo bar wraps to two lines at 12px. Utility row hidden. Emergency strip stays (one line: "No heat or no AC? Call 24/7" + tel link).
- Header 60px: logo and a menu button opening a full-height sheet with the nav, rating chip, phone and Book button.
- Fixed bottom action bar on every public page under 768px: white, 1px top line, 64px plus safe-area inset, three equal buttons with icons: "Call" (tel:), "Text" (sms:), "Book" (copper, white text; scrolls to #book or goes to /#book). Pad the page so nothing hides behind it. Never on /admin or /tech.
- Hero: H1 38px, subline, checks, then the booking card full width, then the photo. Day pills scroll horizontally. Morning/Afternoon cards side by side.
- Trust strip 2×2. Services as compact horizontal cards (icon, name, one line, price, "Book this"). Offers stacked. Tier cards stacked with the toggle above. Map 320px tall, ZIP list two columns. Technicians scroll horizontally with snap. Reviews: summary, three cards, "See all reviews". No text cut off, nothing scrolls sideways.
## Owner admin (/admin)
Desktop: left sidebar (ink, 240px) with the logo, Today, Dispatch, Bookings, Customers, Comfort Club, Offers, Services & prices, Technicians, Reviews, Content, Service area, Settings, Publish checklist, and the owner's email with "Sign out" at the bottom. Phone: bottom tab bar "Today · Dispatch · Customers · More". At 390px nothing in admin may be clipped or wider than the screen: the Today workflow cards form a 2×2 grid, list rows wrap (name and details on top, Call and Text buttons below), Settings forms go single-column, and the Service area table puts the coordinates under the town name. Inter for UI, Archivo for page titles. Saves show a small toast "Saved". Deletes ask for confirmation.
- **/admin/login**: centered card on ink: logo, "Owner sign-in", email, password, "Sign in", "Forgot password?" (email code reset), and the "Demo owner login" card.
- **Alert banner** (top of every admin page): red when an owner alert failed ("A booking alert didn't send: Email to service@copperlinehvac.example on Nov 3 at 2:14 PM. The booking is saved." with "View booking", "Retry", "Dismiss"); otherwise ONE slim warning banner naming channels that need setup: on desktop, one line "Alerts need setup: email (verify a sending domain) and texts (add Twilio keys). New bookings are still saved." with "Open settings"; under 768px the shorter "Alerts need setup: email and texts. Bookings are still saved." with a "Settings" link, shown in full on at most two lines.
- **Today**: "Good morning, Theo" with the date, "Last booking: 2 hours ago" (warning "No new bookings in 7 days. Send a test booking to check your form." past 7 days). Jobber-style workflow cards (ref 8; 3px coloured top borders, big counts): "Needs scheduling" (unassigned requests, copper), "Today's jobs" (with done/total, ink), "Estimates out" (new-system quotes sent, with the total, frost-300), "Club renewals in 30 days" (success). Then "Needs a call back" (new requests older than 1 hour without a tech, with Call and Text buttons), "Today at a glance" (a compact list of today's jobs by window with tech avatar and status chip), and "Recent activity".
- **Dispatch** (/admin/dispatch, ref 6): the day's board. Header: date with prev/next arrows, a "Today" button and two small buttons "Morning" and "Afternoon" that scroll the board to 7 AM and 12 PM, a mini summary "11 jobs · 3 en route · 2 on site · 4 done", and a filter for job type. Left column (260px): "Unassigned" queue cards (customer, service, ZIP and town, requested window, "Urgent" copper chip when urgent, age "booked 40 min ago"). Main area: one row per active technician (avatar, name, a status dot: green on a job, amber en route, grey idle, and "3 jobs · 6.5 h"), a time axis 7 AM to 7 PM across the top with hour gridlines and a red "now" line on today (drawn behind the job blocks and above the gridlines, with a small dot at the top of the axis; give every block a solid white backing so the line never shows through tinted blocks), and job blocks positioned by start and duration (default 90 min; tune-ups 60; installs 360), coloured by type (cooling = frost-300 with ink text, heating = copper-50 with copper-700 border, install = ink with white text, maintenance = success/15) and showing customer last name, street name only, service and a status icon. The board opens scrolled to 7 AM. The label inside each block is sticky to the board's left edge (position: sticky; left: the tech column width), so a block that starts off-screen, like an all-day install, keeps its name visible while you scroll; an "Urgent" tag sits next to the customer's name. Drag a block to another tech row or another time to reassign or reschedule (snaps to 30 minutes; conflicts overlap visibly with a red outline and a toast "Overlaps Kayla's 10:00 job"); drag from Unassigned onto a row to assign. Click a block for a side sheet: customer, phone with Call/Text, address (street + ZIP; the full address only in admin), service, problem notes, equipment on file, offer code, status timeline (Scheduled 7:58 AM → En route 9:12 AM → On site 9:40 AM), and buttons to change tech, time, status, or "Text customer: on the way" (sms: prefilled "Hi Dana, this is Kayla from Copperline. I'm on my way and should be there around 9:45."). On phones, Dispatch becomes a list grouped by tech with a "Move" sheet instead of drag. Status changes from /tech appear on the board within 10 seconds (poll or SSE).
- **Bookings** (/admin/bookings): a table that fits the content width at 1280–1440px with no hidden columns (Ref, Booked, Customer with the town and ZIP under the name in muted 13px, Service wrapping to at most two lines, Requested, Tech, Status, Source; Ref, Booked, Requested and names on one line; under 1100px it scrolls sideways inside its card), with status tabs and counts (All · Requested · Scheduled · In progress · Done · Canceled · Spam), search (name, phone, ZIP), service and source filters, "Export CSV" (ref, booked at, status, name, phone, email, ZIP, town, service, day, window, tech, offer code, source, UTM source/medium/campaign, gclid, landing page). Row click opens the booking detail with the same side sheet content and a timeline.
- **Customers** (/admin/customers, ref 9): list with search, tags (Club member, Lead, Customer), last visit and next due tune-up. Customer detail: name with a badge (Lead / Customer / Club member), actions Call (tel:), Text (sms: with a prefilled message), WhatsApp, Email, "Book a visit" (creates a booking for this customer); left column: contact info, service address, source; main: "Equipment on file" cards (type Furnace / AC / Heat pump / Water heater / Thermostat, brand, model, serial (optional), install year with computed age ("Installed 2014 · 12 years old", "1 year old", or "Installed this year") and a warning tint past 12, tonnage or BTU, filter size e.g. 16x25x1, location "Basement"), add/edit equipment; "Job history" (past jobs with tech, service, notes, price); notes (timestamped); Comfort Club membership card with renewal date.
- **Comfort Club** (/admin/club): members table (name, tier, billing, systems, started, renews "in 12 days", status Active / Pending payment / Canceled, tune-ups used this year 1/2), filters "Renewing in 30 days" and "Tune-up due", "Book tune-up" on a row, CSV export. Tier editor (name, monthly and yearly price, benefits list).
- **Offers**: list and editor (title, tag, description, terms, code, start, end, active); expired offers grey out.
- **Services & prices**: edit services (name, slug, icon, short line, body, price lines, diagnostic fee, photo, active, order, default job duration).
- **Technicians**: cards with photo, name, role, years, certifications, phone, color, active, 4-digit PIN (shown masked, "Reset PIN"), and the towns they usually cover.
- **Reviews**: list with add, edit, delete, demo flag, owner response, the Google review link, and the private feedback inbox from /review (mark handled).
- **Content**: emergency strip switch and text, hero headline/subline/checks, Comfort Club teaser, financing text, link and label, about text, FAQ (add, edit, reorder, hide), hours editor.
- **Service area**: ZIPs with town and lat/lng (add, edit, remove), daily capacity per window override.
- **Settings**: Business facts, Notifications (alert email, alert phone, "Send alerts from" address; Email (Resend) and Text (Twilio) status: "Connected", "Needs setup" or "Failing"; "Send test booking" which runs a real booking through the pipeline and shows each channel's result; the notification log), Payments (Stripe: "Not connected" with how to add STRIPE_SECRET_KEY; never fake "Connected"), Tracking (GTM ID, Google Ads conversion ID and label, canonical domain), Google review link, Demo mode switch, Account (change email and password).
- **Publish checklist**: computed items with status icons and "Fix" links: "Replace the demo reviews (14 left)", "Replace the sample photos (n left)", "Replace the sample technician profiles", "Set your real phone, email and license number", "Set your financing link", "Change the owner password and the tech PINs", "Send a test booking and confirm the alert arrived", "Connect text alerts (Twilio)", "Connect Stripe for Comfort Club payments (optional)", "Add your Google review link", "Turn off demo mode", "Connect your domain and HTTPS" (manual tick).
## Technician view (/tech)
A phone-first page for techs in the truck. "Technician sign-in": pick your name from the active techs (avatar buttons), enter a 4-digit PIN (numeric keypad), stay signed in on that phone (signed token, 30 days). Demo PINs are shown in a "Demo technician PINs" card while demoMode is on (Luis 1111, Kayla 2222, Andre 3333, Priya 4444, Cody 5555). After sign-in: "Today, Thu Nov 20 · 3 jobs" and job cards in time order: window and planned start, customer name, street and town, service, problem notes, equipment on file, buttons Call, Text, Directions (`https://www.google.com/maps/dir/?api=1&destination=<street, ZIP>`), and one big status button that moves the job along: "On my way" → "Arrived" → "Job done" (each logs a timestamp; "On my way" opens a prefilled sms: to the customer). "Job done" opens a short sheet: work notes, price charged (optional), "Update equipment" (install year, filter size), and "Ask for a review" (sms: prefilled with the /review link). Done jobs collapse to the bottom. Status changes reach the dispatch board. The tech API only lets a tech see and change their own jobs for today and tomorrow.
## Functions that must actually work
- **Store first, then notify.** POST /api/bookings validates with Zod, finds or creates the Customer by phone, saves the Booking and a "created" event in one transaction FIRST, re-checks capacity inside the transaction (two people can't take the last spot), returns {ref, id, photoToken}, and only then sends notifications in the background: an owner alert email (Resend via the proxied RESEND_API_KEY at https://api.resend.com/emails, from the "Send alerts from" setting, never from a Vibecode domain), an owner text via Twilio's REST API when TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN and TWILIO_FROM_NUMBER exist (otherwise logged "needs setup"), and a customer confirmation email when they gave one. Every attempt writes a NotificationLog row (channel, to, status sent / failed / needs_setup, error, time) and an event. Resend 401/403/422 = needs_setup; network errors or 5xx = failed. Failures drive the admin banner and have a Retry. Test Resend from the sandbox and report what happened. Club sign-ups use the same pipeline.
- **Spam:** an invisible honeypot field (unique id per form, tabindex -1, autocomplete off) and a 2.5 s minimum fill time; caught submissions are stored as spam, shown under the Spam tab, never notify, and never take capacity.
- **Private photos.** Booking photos go to Vibecode Storage; their storage URL never reaches the browser or a public endpoint. Admin gets 15-minute HMAC-signed URLs (`/api/files/booking-photo/:id?exp=…&sig=…`) and that route checks the signature and streams the image. The server checks each upload's real type by its first bytes (JPEG, PNG, WebP, HEIC), max 15 MB, and rejects anything else inline with "That file isn't a photo."
- **Attribution:** on first visit store utm_source, utm_medium, utm_campaign, utm_term, utm_content, gclid, landing page and referrer in localStorage (newer gclid/UTM replaces) and send them with every booking and club sign-up. GTM loads only on public pages and only when an ID is set.
- **Coverage and capacity:** ZIP lookups use the service area; bookings store their town. Capacity per window = active techs × 2 (or the override) minus non-canceled, non-spam bookings in that window.
- **Working contact links:** tel:+19135550186, sms:+19135550186 (prefilled texts use the `sms:+1…?&body=` form that works on iOS and Android) and https://wa.me/19135550186, from the Business row.
## Data model (Prisma, SQLite)
Business (id, name, phone, smsPhone, whatsapp, email, licenseNo, insuredLine, sinceYear, baseTown, baseZip, timezone, currency, locale, diagnosticFeeCents, afterHoursFromCents, emergencyService, emergencyStripOn, emergencyStripText, financingUrl, financingLabel, gtmId, adsConversionId, adsConversionLabel, canonicalDomain, googleReviewUrl, instagramUrl, facebookUrl, notifyEmail, notifyPhone, alertsFrom, demoMode, ownerPasswordChanged, photoSigningSecret, techTokenSecret) · Hours (weekday, opens, closes, note) · ServiceArea (id, town, zip, lat, lng, capacityOverride, sortOrder) · Service (id, slug, name, icon, category [cooling|heating|air|install|maintenance], shortDesc, body, included JSON, priceLines JSON, durationMin, imageUrl, isSample, active, sortOrder) · Technician (id, name, role, years, certs JSON, bio, photoUrl, isSample, phone, color, pinHash, towns JSON, active, sortOrder) · Customer (id, name, phone unique, email, street, zip, town, type [lead|customer], source, notes, createdAt, isDemo) · Equipment (id, customerId, type, brand, model, serial, installYear, size, filterSize, location, notes, isDemo) · Booking (id, ref unique, createdAt, customerId, serviceId, serviceLabel, urgent, day, window [morning|afternoon|asap], status [requested|scheduled|en_route|on_site|done|canceled], technicianId, startAt, endAt, problem, offerCode, priceChargedCents, workNotes, source, landingPage, referrer, utm*, gclid, isSpam, isTest, photoToken, statusTimes JSON, isDemo) · BookingPhoto (id, bookingId, storageUrl, fileId, createdAt) · Event (id, bookingId?, customerId?, type, data JSON, at, isDemo) · Note (id, customerId, text, at, isDemo) · PlanTier (id, name, monthlyCents, yearlyCents, benefits JSON, highlight, sortOrder) · Member (id, customerId, tierId, billing, systems, startedAt, renewsAt, status, tuneUpsUsed, stripeSessionId, isDemo) · Offer (id, title, tag, description, terms, code, startsAt, endsAt?, active, isDemo) · Review (id, author, town, serviceLabel, techName, rating, text, topics JSON, ownerResponse, source, date, isDemo) · Feedback (id, rating, text, name, contact, handled, createdAt) · ContentBlock (key, valueJson, hidden) · Faq (id, question, answer, serviceId?, sortOrder, hidden) · NotificationLog (id, bookingId?, channel, to, status, error, at) · DemoState (id, seededDay) · Better Auth tables for the owner.
## Seed data (all fictional; dates relative to "now" in America/Chicago, all isDemo)
- Business, hours, 14 ZIPs, 6 services with the copy and prices above (3 FAQs each), 7 home FAQs, 2 plan tiers, 3 offers.
- **Technicians** (all Sample profiles, AI portraits): Luis Ortega (Lead service tech, 14 years, EPA 608, NATE; "Most furnaces just need someone to listen to them for a minute."; Olathe, Gardner, Spring Hill; colour #2F6F8F; PIN 1111) · Kayla Simmons (Service tech, 8 years, EPA 608; "I'll show you the part before I replace it."; Lenexa, Shawnee, De Soto; #7A5C3E; 2222) · Andre Mitchell (Service tech, 11 years, EPA 608, NATE; "If it's under warranty, I'll make the call to the manufacturer."; Overland Park, Leawood; #3E6B4E; 3333) · Priya Nair (Install lead, 9 years, EPA 608, NATE; "A clean install is the best tune-up you'll ever get."; all; #8A4F7D; 4444) · Cody Harlan (Apprentice tech, 2 years, EPA 608; "I do the tune-ups and I bring shoe covers."; Prairie Village, Mission, Merriam, Roeland Park; #5B6577; 5555).
- **Customers** (24; phones (913) 555-01xx, emails @example.com, streets fictional like "8412 W 98th Ter"), each with 1–3 equipment rows (e.g. "Carrier 59SC5 furnace, 2013, 80,000 BTU, filter 16x25x1, basement"; "Trane XR14 AC, 2011, 3 ton, side yard"; "Lennox ML180, 2019"; "Goodman heat pump, 2016"; "Rheem water heater, 2015"; one 2004 furnace flagged old), plus notes and job history (2–4 past done jobs each over the last 18 months).
- **Today's dispatch** (shifted every day with the demo): 11 jobs across the 5 techs plus 3 unassigned requests. It's heating season, so mostly furnace work plus tune-ups, a thermostat install, a duct cleaning and one heat pump install. Luis: 8:00 "No heat, Carrier furnace" (done), 10:00 "Furnace repair, flame sensor" (en route), 1:30 tune-up (scheduled). Kayla: 8:30 "Furnace short cycling" (done), 10:30 "Smart thermostat install" (on site), 2:30 tune-up (scheduled). Andre: 9:00 "Heat pump not heating" (on site), 1:00 "Duct cleaning, 2 floors" (scheduled). Priya: 8:00–2:00 "Heat pump install, Henley" (on site). Cody: 9:00 tune-up (done), 11:00 tune-up (scheduled), 2:00 tune-up (scheduled). Keep these seeded statuses as they are, whatever the time of day the demo is opened. Unassigned: "No heat (urgent), Olathe 66061, booked 40 min ago", "Tune-up, Leawood, tomorrow morning", "New system quote, Lenexa, Monday afternoon". Tomorrow has 6 scheduled jobs.
- **Booking references**: seeded bookings are numbered in order and end at CL-2047, so the first real booking is CL-2048.
- **Bookings history**: 30 past done jobs over the last 60 days (with prices charged $89–$1,450 and a few installs $8,200–$11,600), 2 canceled, 1 spam. The newest request is 2 hours old.
- **Club members**: 18 (12 Comfort, 6 Comfort Plus; 4 renewing within 30 days, 1 pending payment, 1 canceled; tune-ups used 0–2).
- **Reviews** (14, Google, isDemo, 13 five-star and 1 four-star, dated 5 to 200 days ago), each naming the problem and often the tech: e.g. Dana K. (Lenexa, Furnace repair, 5★, 6 days ago): "No heat on the coldest night so far. Kayla was here by 8 the next morning, showed me the cracked ignitor and had it running in 40 minutes. Price was exactly what she quoted." Owner response "Thanks Dana. Stay warm." · Mark H. (Olathe, AC repair, 5★): "Capacitor went out in July. Luis had a spare on the truck." · Rosa G. (Overland Park, New system, 5★): "Three companies quoted us. Copperline was the only one that did a load calculation and told us we didn't need the bigger unit." · Steve P. (Shawnee, Tune-up, 4★): "Good tune-up, a bit later than the window but Cody texted ahead." Owner response "Thanks Steve. We're tightening our windows." Write the remaining ten in the same plain voice, covering heat pump, duct cleaning, thermostat, Comfort Club and same-day visits. Give each 1–3 topics.
- **Feedback**: none. **NotificationLog**: none (don't seed fake notification results).
## Images (generate them, AI people only)
Write one script (backend/scripts/generate-images.ts) that generates every image with `gpt-image-2.5-flare` through the project's proxied OPENAI_API_KEY at https://api.openai.com/v1/images/generations (quality "high", 1536x1024 unless noted), four at a time, skipping files that already exist, converting to JPEG (quality 82, max 1600px wide) with sharp into webapp/public/images/. Start it in the background as soon as the schema exists and keep building while it runs; until a file exists the UI shows a frost box with the Sample chip. Style for all: photorealistic, natural light, Kansas suburban neighborhoods (brick and siding ranch and two-story houses, mature oaks, late autumn), neutral colours, no text, no logos except the fictional "COPPERLINE" lettering where stated, no watermarks, faces natural, adults only.
- hero/tech-condenser.jpg (1600x900): a technician in a charcoal work shirt kneeling beside an outdoor AC condenser next to a brick ranch house, gauges connected, late afternoon light.
- services/<slug>.jpg (6): a condenser fan from above; a furnace burner compartment opened in a clean basement with a flashlight beam; a modern heat pump outdoor unit on a pad beside siding; a technician measuring a living room with a tablet showing a floor plan (no readable text); a technician's gloved hands replacing a furnace filter; a duct cleaning hose at a floor register.
- team/<name>.jpg (5, 1024x1280 portraits): Luis (Latino man, 40s, mustache, charcoal work shirt), Kayla (Black woman, 30s, braids tied back, charcoal shirt), Andre (Black man, 40s, short beard, cap), Priya (South Asian woman, 30s, hi-vis vest over the shirt), Cody (white man, early 20s, beanie). All with a small copper-colored chest patch with no readable text, neutral garage or driveway background.
- team/owner-van.jpg: a white man in his 40s (Theo) standing by a white service van with "COPPERLINE" in ink block letters and a copper wave stripe, suburban street.
- club/filter.jpg: a technician sliding a fresh pleated filter into a furnace.
- og.jpg (1200x630): compose with sharp: the hero photo with an ink gradient, the logo mark and "Copperline Heating & Air / Heat and AC repair, done the same day." in white Archivo-like bold type. Use it as og:image and twitter:image.
## Local SEO
- index.html: title "Copperline Heating & Air | Furnace & AC Repair in Overland Park, KS", a matching description, Open Graph and Twitter tags, theme-color #14202B, the new favicons.
- Each public route sets its own title, description and absolute canonical (canonical domain from Settings, else window.location.origin) and injects HVACBusiness JSON-LD from the live Business facts (name, telephone, email, url, image, priceRange "$$", address with locality/region/postal code only, areaServed ZIPs, openingHoursSpecification, a service catalogue with prices; no aggregateRating while reviews are demo).
- Prerender for crawlers: a small Vite plugin (closeBundle) writes dist/<route>/index.html for /, /services/<slug>, /plans, /review and /privacy with that route's title, meta, JSON-LD and a plain semantic HTML snapshot of the main text inside #root (React replaces it on load), reading the same seed data module the backend seeds from. It also writes dist/sitemap.xml, dist/robots.txt and dist/llms.txt (business facts, services with prices, plans, ZIPs, hours, contact, FAQ). Static files use absolute URLs only (canonical domain from the backend at build time, else VITE_SITE_URL); when no domain is known, leave the canonical tag and the robots Sitemap line out. Server-built absolute URLs always use https:// except on localhost. Also serve live versions at /api/seo/llms.txt and /api/seo/sitemap.xml.
## Motion, states, accessibility
- Framer Motion, subtle: sections fade up 12px once in view (400ms), cards stagger 60ms, header shadow on scroll, accordion height animation, bottom bar slides up on load, dispatch blocks animate to their new slot on drop (layout animation), status button on /tech gives a short scale press and a success tick. Respect prefers-reduced-motion. No parallax.
- Loading: skeletons for reviews, the dispatch board and admin tables. Errors: friendly inline messages with the phone number on public pages ("We couldn't book that. Your details are still here. Try again or call (913) 555-0186."; form values kept, draft in localStorage), toasts in admin. Empty states with a next step ("No jobs today. Drag a request from Unassigned to start the day.").
- Labels on every input, visible copper focus rings (frost-300 on ink), 44px touch targets, alt text on every image, lazy-loaded images except the hero.
## Build order (small files)
Build it in small source files (one component per file, no file over ~250 lines), in this order, and get each step running before the next:
1. Prisma schema, seed modules (backend/src/seed/*.ts), auto-seed on empty DB, the demo date shift (startup + hourly) and DemoState; Better Auth with the seeded owner, sign-up disabled and session IP/UA blanking; authSecret. Start the image script in the background.
2. Public API (/api/public/site returns everything the home page needs in one request; availability endpoint for days and windows; services; POST /api/bookings; POST /api/club/join; POST /api/feedback; booking photo upload with token) and the notification pipeline. Tech API (/api/tech/login, /api/tech/jobs, status updates). Test every route with curl against $BACKEND_URL.
3. Theme tokens, fonts, logo, layout (demo bar, utility row, header, emergency strip, phone bottom bar, footer).
4. Home sections in order (each its own file under src/components/home/), the booking card and /booked, attribution and GTM.
5. /services/:slug, /plans and /plans/welcome, /review, /privacy, 404.
6. Admin: login, layout, Today, Dispatch (drag and drop with @dnd-kit; phone list mode), Bookings with CSV, Customers and equipment, Comfort Club, Offers, Services, Technicians, Reviews, Content, Service area, Settings with test booking and notification log, Publish checklist. Then /tech.
7. SEO plugin, favicon and OG image.
8. Run everything, then test at 1440px and 390px: book from the hero (pick a window and watch its spot count drop), book an urgent no-heat, join the Comfort Club, see the bookings in admin, drag one from Unassigned onto Kayla at 2:00, sign in as Kayla at /tech and move a job to On my way → Arrived → Job done and see it on the board, add equipment to a customer, export CSV, edit an offer and a service price and see them on the home page, switch the emergency strip off and on, rate 2 and 5 stars on /review. Fix every error and console warning.
9. Clean up before you finish: delete every record you created while testing (bookings, customers, events, notification logs, photos, members, feedback), reset the reference counter (the next booking is CL-2048), and delete every Session and Verification row. The admin must show exactly the seeded data. Make sure backend/prisma/dev.db is tracked in git (`git check-ignore backend/prisma/dev.db` prints nothing), run `PRAGMA wal_checkpoint(TRUNCATE); VACUUM;` on it, and check dev.db-wal is 0 bytes. Don't sign in again afterwards. Delete the refs/ folder and any other downloaded reference screenshot: other companies' screenshots must not ship with the site.
Build it fully, run it, and fix every error. Deliver the complete app, not a plan.More templates
All templates- View template

Nelson CRM
WebA CRM site in surreal collage: clouds torn like paper, marble statues, starry skies and an electric blue UI
- View template

Orbit CRM
WebAn AI CRM site in electric blue, pixel type and halftone Roman emperors, with live HTML product mocks.
- View template

Qredible
WebA cobalt-sky SaaS site where the product UI sinks into pink-tipped grass hills, with a live workflow builder
- View template

Porchlight CRM
WebA real estate agent CRM: today's showings first, listing pages that book tours, and commission on every deal.