Skip to main content

Website Build Directive

Value: $7,500 Timeline: 5-7 days Tools: Google Antigravity, React/Tailwind, Vercel/Netlify


Purpose​

Build a complete, conversion-optimized website using the StoryBrand framework and AI-assisted development in Antigravity. Every website follows the same proven structure but is customized to the client's brand and services.


Inputs​

InputSourceRequired
CLIENT.mdClient folderYes
Brand visualsassets/visuals/Yes
Logo filesClientYes
Domain accessClientYes
Hosting decisionClientYes

Deliverables​

PagePurpose
HomepageStoryBrand structure, primary conversion
AboutGuide positioning, authority building
Services (5+)Individual service pages, SEO-optimized
ContactBooking/inquiry, location info
BlogContent hub (infrastructure)
LegalPrivacy policy, terms

Technical Deliverables​

  • Mobile-responsive design
  • Page speed <3 seconds
  • Schema markup (LocalBusiness, FAQ, Service)
  • Analytics integration
  • Form integration (GHL)
  • Booking widget integration

Homepage Structure (StoryBrand)​

Above the Fold (Hero)​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ HEADER: Logo | Nav | Phone | CTA Button β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ β”‚
β”‚ HEADLINE: Clear value proposition β”‚
β”‚ (What they get + Who it's for) β”‚
β”‚ β”‚
β”‚ SUBHEAD: Elaborate on the benefit β”‚
β”‚ β”‚
β”‚ [PRIMARY CTA] [SECONDARY CTA] β”‚
β”‚ β”‚
β”‚ HERO IMAGE: Aspirational outcome β”‚
β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Copy Formula:

  • Headline: "Get [Result] Without [Pain Point]"
  • Subhead: "We help [target customer] achieve [outcome] through [method]"
  • Primary CTA: Direct action ("Schedule Consultation")
  • Secondary CTA: Transitional ("Learn More" or lead magnet)

Section 2: Problem/Stakes​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ "Are you experiencing..." β”‚
β”‚ β”‚
β”‚ [Problem 1] [Problem 2] [Problem 3] β”‚
β”‚ β”‚
β”‚ Short paragraph on internal problem β”‚
β”‚ (How it makes them FEEL) β”‚
β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Section 3: Guide Introduction​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ "We understand..." β”‚
β”‚ β”‚
β”‚ Empathy statement β”‚
β”‚ β”‚
β”‚ IMAGE AUTHORITY CREDENTIALS β”‚
β”‚ (Team/Founder) - Years experience β”‚
β”‚ - Certifications β”‚
β”‚ - Results delivered β”‚
β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Section 4: The Plan (3 Steps)​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ "How It Works" β”‚
β”‚ β”‚
β”‚ β”Œβ”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β” β”‚
β”‚ β”‚ 1 β”‚ β”‚ 2 β”‚ β”‚ 3 β”‚ β”‚
β”‚ β”‚ Step β”‚ β”‚ Step β”‚ β”‚ Step β”‚ β”‚
β”‚ β”‚ Name β”‚ β”‚ Name β”‚ β”‚ Name β”‚ β”‚
β”‚ β””β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚ β”‚
β”‚ [CTA BUTTON] β”‚
β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Section 5: Services Overview​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ "Our Services" β”‚
β”‚ β”‚
β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚ β”‚ Service β”‚ β”‚ Service β”‚ β”‚ Service β”‚ β”‚
β”‚ β”‚ Image β”‚ β”‚ Image β”‚ β”‚ Image β”‚ β”‚
β”‚ β”‚ Name β”‚ β”‚ Name β”‚ β”‚ Name β”‚ β”‚
β”‚ β”‚ Brief β”‚ β”‚ Brief β”‚ β”‚ Brief β”‚ β”‚
β”‚ β”‚ [More] β”‚ β”‚ [More] β”‚ β”‚ [More] β”‚ β”‚
β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Section 6: Success (Transformation)​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ "Imagine..." β”‚
β”‚ β”‚
β”‚ Success story / transformation narrative β”‚
β”‚ β”‚
β”‚ TESTIMONIALS β”‚
β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚ β”‚ "Quote from happy customer..." β”‚ β”‚
β”‚ β”‚ - Name, Title β”‚ β”‚
β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚ β”‚
β”‚ β˜…β˜…β˜…β˜…β˜… Google Rating | XX Reviews β”‚
β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Section 7: Failure (Stakes)​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ "Don't let [problem] continue..." β”‚
β”‚ β”‚
β”‚ Brief paragraph on what happens if they β”‚
β”‚ don't act (subtle, not fear-mongering) β”‚
β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Section 8: Final CTA​

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ "Ready to [get result]?" β”‚
β”‚ β”‚
β”‚ [LARGE PRIMARY CTA BUTTON] β”‚
β”‚ β”‚
β”‚ "Or call us: (XXX) XXX-XXXX" β”‚
β”‚ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Logo β”‚
β”‚ β”‚
β”‚ NAP (Name, Address, Phone) β”‚
β”‚ Hours of Operation β”‚
β”‚ β”‚
β”‚ Quick Links | Services | Legal β”‚
β”‚ β”‚
β”‚ Social Icons β”‚
β”‚ β”‚
β”‚ Β© 2025 Business Name. All rights reserved. β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Service Page Structure​

Each service page follows this template:

1. HERO
- H1: [Service Name] in [Location]
- Subhead: Key benefit
- CTA button
- Hero image (service-specific)

2. WHAT IT IS
- Clear explanation of the service
- Who it's for
- What to expect

3. BENEFITS (not features)
- Benefit 1 with icon
- Benefit 2 with icon
- Benefit 3 with icon

4. PROCESS
- Step-by-step what happens
- Timeline expectations
- Before/after (if applicable)

5. PRICING (if applicable)
- Starting at pricing
- What's included
- Financing options

6. FAQ SECTION
- 5-7 questions (use FAQ schema)
- Address common objections
- Include pricing questions

7. RELATED SERVICES
- Cross-link to complementary services

8. CTA
- Strong call to action
- Multiple contact methods

Technical Specifications​

Performance​

  • Lighthouse score: 90+ on all metrics
  • First Contentful Paint: <1.5s
  • Largest Contentful Paint: <2.5s
  • Cumulative Layout Shift: <0.1

SEO​

  • Unique title tag per page (60 chars)
  • Unique meta description per page (155 chars)
  • H1 on every page (keyword-optimized)
  • Image alt text on all images
  • Internal linking structure
  • XML sitemap
  • robots.txt configured

Schema Markup​

{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "[Business Name]",
"image": "[Logo URL]",
"address": {
"@type": "PostalAddress",
"streetAddress": "[Street]",
"addressLocality": "[City]",
"addressRegion": "[State]",
"postalCode": "[ZIP]"
},
"telephone": "[Phone]",
"openingHours": "[Hours]",
"priceRange": "$$"
}

Integrations​

  • Google Analytics 4
  • Google Tag Manager
  • Facebook Pixel
  • GHL forms (webhook)
  • Booking widget
  • Live chat (if applicable)

Antigravity Development Workflow​

GEMINI.md Rules for Website Builds​

# Website Build Rules

## Stack
- React 18+
- Tailwind CSS
- Framer Motion (animations)
- React Hook Form (forms)
- Vercel/Netlify deployment

## Component Structure
- Use functional components
- Keep components small and focused
- Separate concerns (UI, logic, data)

## Styling
- Use Tailwind utility classes
- Follow mobile-first approach
- Create consistent spacing scale
- Use CSS variables for brand colors

## Performance
- Lazy load images below fold
- Use next/image or optimized images
- Minimize JavaScript bundle
- Implement proper caching

## Accessibility
- Semantic HTML
- ARIA labels where needed
- Keyboard navigation
- Color contrast compliance

Copy Templates by Industry​

Medical Spa Headlines​

  • "Look as Vibrant as You Feelβ€”Without Surgery"
  • "Subtle Enhancement, Natural Results"
  • "Expert Care. Personalized Plans. Real Results."

Cleaning Service Headlines​

  • "Come Home to Clean"
  • "Your Weekend, Returned"
  • "A Spotless Home Without Lifting a Finger"

HVAC/Duct Cleaning Headlines​

  • "Breathe Easier. Save Money. Stay Safe."
  • "See What's Hiding in Your Ducts"
  • "Clean Air for Your Family"

Restoration Headlines​

  • "When Disaster Strikes, We Take Control"
  • "From Crisis to Normalβ€”Fast"
  • "24/7 Emergency Response. 25 Years of Trust."

Carpet Cleaning Headlines​

  • "Carpets So Clean You'll Walk Barefoot"
  • "The Clean You Can Feel"
  • "Fresh From the Fibers Up"

Process​

Step 1: Planning (Day 1)​

  1. Review CLIENT.md and BrandScript
  2. Gather all assets (visuals, logo, copy)
  3. Create sitemap and page list
  4. Write homepage copy
  5. Client approval on wireframe

Step 2: Build Foundation (Day 2-3)​

  1. Set up project in Antigravity
  2. Configure GEMINI.md rules
  3. Build component library
  4. Create homepage structure
  5. Implement navigation

Step 3: Build Pages (Day 3-5)​

  1. Homepage complete
  2. About page
  3. Service pages (1 per day)
  4. Contact page
  5. Blog infrastructure

Step 4: Polish (Day 5-6)​

  1. Add all imagery
  2. Implement animations
  3. Mobile optimization
  4. Speed optimization
  5. Form testing

Step 5: SEO & Launch (Day 6-7)​

  1. Schema markup
  2. Meta tags
  3. Analytics setup
  4. Final testing
  5. Deploy
  6. Submit to Search Console

Quality Checklist​

Content​

  • All BrandScript elements present on homepage
  • Clear CTA above the fold
  • Contact info in header and footer
  • All services have dedicated pages
  • FAQ sections with schema

Design​

  • Brand colors consistent
  • Typography hierarchy clear
  • Images optimized and crisp
  • Mobile navigation works
  • Buttons/CTAs prominent

Technical​

  • Page speed <3 seconds
  • Mobile-responsive all breakpoints
  • Forms submit correctly
  • Analytics tracking
  • Schema validates
  • SSL certificate active

SEO​

  • Unique title tags
  • Unique meta descriptions
  • H1 on every page
  • Image alt text
  • Internal links
  • Sitemap submitted

Learnings​

Update as you discover what works.


Changelog​

DateChangeAuthor
2025-12-04Created directiveClaude