Workflows

🚀 Gnomad Studio — Website Launch Checklist

- Google Analytics 4 (GA4) — Add gtag.js script to <head> of every page using Measurement ID

  • davidcole-swarm
  • workflows
Raw markdown Manifest JSON ← Agent Kit

🚀 Gnomad Studio — Website Launch Checklist

Living document. Both David and the Swarm can add items here at any time. Every website we build must pass this checklist before being handed off to the client.

📊 Analytics & Tracking

  • Google Analytics 4 (GA4) — Add gtag.js script to <head> of every page using Measurement ID
    • For Next.js: Use next/script with strategy="afterInteractive" in app/layout.tsx
    • For static HTML sites: Add gtag snippet directly to <head>
    • For Vite/React SPAs: Use react-ga4 or add to index.html
  • Google Search Console — Verify domain ownership (DNS TXT record or HTML meta tag)
  • UTM Parameters — Set up Apple Maps action buttons with ?utm_source=apple_maps

🗺️ Maps & Local SEO

  • JSON-LD Local Business Schema — Add to <head>. Include:
    • @type: LocalBusiness + specific type (e.g., WebDesign, Restaurant)
    • name, url, telephone, address with full postal address
    • areaServed: List city + surrounding ZIP codes
    • sameAs: Links to Google Business Profile, Facebook, LinkedIn
    • openingHours if applicable
  • NAP Consistency — Name, Address, Phone must be character-for-character identical across:
    • Website footer (every page)
    • Google Business Profile
    • Apple Business Connect
    • Facebook Page
    • Any directory listings (Yelp, BBB, etc.)
  • Apple Business Connect — Domain verification TXT record added to DNS
  • Google Business Profile — Claimed, verified, and link added to sameAs in schema

🔍 SEO Fundamentals

  • Title Tags — Unique, descriptive title on every page (<= 60 chars)
  • Meta Descriptions — Compelling description on every page (<= 160 chars)
  • OpenGraph Tags — og:title, og:description, og:image, og:url on all pages
  • Canonical URLs — <link rel="canonical"> on all pages
  • robots.txt — Present and correct (User-agent: * / Allow: /)
  • sitemap.xml — Generated and submitted to Google Search Console
  • H1 Tag — One unique <h1> per page, keyword-relevant
  • Image Alt Text — All images have descriptive alt attributes

🎤 Voice Search (Siri / Alexa / Google Assistant)

  • FAQ Section — Add to homepage or dedicated /faq page with questions like:
    • “Who provides the best [service] in [city]?”
    • “How much does a [city] [service] cost?”
  • FAQ Schema (JSON-LD) — Wrap FAQ content in FAQPage schema so Siri can speak answers directly
  • Answer-Ready Copy — At least 3 questions answered in 1–2 direct sentences

⚡ Performance

  • Images — Compressed to WebP, max 200KB per image
  • Lighthouse Score — Mobile performance >= 85, Desktop >= 90
  • Core Web Vitals — LCP < 2.5s, CLS < 0.1, FID/INP < 200ms
  • HTTPS — SSL certificate active and redirecting HTTP → HTTPS

📱 Mobile

  • Mobile Responsive — Tested on iPhone and Android breakpoints
  • Click-to-Call — All phone numbers wrapped in <a href="tel:+1XXXXXXXXXX">
  • Click-to-Email — All email addresses wrapped in <a href="mailto:...">
  • Touch Targets — All buttons/links >= 44x44px
  • Viewport Meta Tag — <meta name="viewport" content="width=device-width, initial-scale=1">
  • Separate Mobile Footer — A fixed bottom bar with 3–4 buttons max (e.g., Call, Email, Portal, Menu). Use md:hidden to show only on mobile.
  • Desktop Footer Hidden on Mobile — The full desktop footer must use hidden md:flex (or equivalent) so it does NOT appear on mobile screens. Only the mobile bottom bar is shown.
  • Large Visual Elements Hidden on Mobile — Hero videos, large showcase sections, decorative animations, and multi-column layout elements that don’t scale well must be hidden on mobile using hidden md:block or equivalent. Mobile gets a simplified, text-first layout.

🔒 Security & Compliance

  • ADA / WCAG 2.1 AA — Color contrast ratios meet minimum, keyboard navigable
  • Privacy Policy — Page exists and linked in footer
  • No Console Errors — Browser devtools shows zero errors on all pages

🚀 Deployment

  • PM Pre-Build Checklist — Run full checklist from PM_ORCHESTRATOR (vite.config base, HashRouter, no absolute paths)
  • Static Export or Server Build — Confirm output type matches hosting platform
  • Environment Variables — All secrets configured in hosting platform (not hardcoded)
  • Custom Domain — Pointing correctly, SSL active
  • 404 Page — Custom, on-brand error page exists

🤝 Client Handoff

  • Google Analytics access — Client invited as Editor in GA4 property
  • Google Business Profile — Client invited as Manager
  • Login credentials — Delivered securely to client
  • CMS / Admin training — If applicable, 15-min walkthrough recorded or conducted
  • Client Portal profile — Created in gnomadstudio.org/client-portal with correct tier

📝 David’s Add-It-Here Section

Add any new standard requirements below as you discover them:

  • (add items here)

Last updated: 2026-02-27 | Maintained by Gnomad Studio Swarm + David Cole