BreederHQ Marketing Website

Modern, high-performance marketing website for BreederHQ with enterprise-level visitor intelligence and analytics.

Built with Astro 5 + Tailwind CSS 4.

🚀 Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

📚 Documentation

All documentation is in the .docs folder (excluded from git/deployment):

• Quick Start Guide - Get up and running in 15 minutes
• Strategic Advantages - All features & capabilities
• Implementation Summary - What was built & why
• Architecture - Technical details & data flow

🎯 What's Built In

✅ Visitor Intelligence - See which companies visit your site ✅ Lead Enrichment - Auto-enrich contacts with company data ✅ Multi-Channel Distribution - Slack, HubSpot, Zapier, your CRM ✅ Conversion Tracking - GA4, Meta, LinkedIn, Twitter pixels ✅ Performance Monitoring - Core Web Vitals tracking ✅ SEO Optimization - Comprehensive meta tags & structured data

🛠️ Tech Stack

• Framework: Astro 5.x
• Styling: Tailwind CSS 4.x
• Hosting: Vercel
• Analytics: GA4 (loads only after the visitor accepts analytics cookies)
• Language: TypeScript

📦 Project Structure

breederhq-www/
├── .docs/              # Documentation (gitignored)
├── src/
│   ├── components/     # Reusable components
│   │   ├── Analytics.astro
│   │   ├── SEOHead.astro
│   │   ├── ContactForm.astro
│   │   └── CTAButton.astro
│   ├── layouts/        # Page layouts
│   ├── pages/          # Routes & API endpoints
│   │   ├── api/
│   │   │   ├── contact.ts
│   │   │   └── track-visitor.ts
│   │   └── *.astro
│   ├── lib/            # Utilities
│   │   ├── tracking.ts
│   │   ├── performance.ts
│   │   └── server/
│   ├── config/         # Configuration
│   └── styles/         # Global styles
├── public/             # Static assets
├── .env.example        # Environment template
└── package.json

🔧 Configuration

1. Copy environment template:

   cp .env.example .env
   

2. Add your API keys (see Quick Start)

3. Deploy to Vercel:

   vercel
   vercel env add PUBLIC_GA4_MEASUREMENT_ID
   vercel --prod
   

Required Vercel Environment Variables for Lead Notifications

Variable	Required	What it does
SLACK_WEBHOOK_URL	Yes	Posts "New Lead Submitted!" to Slack #leads channel. A repeat of the same email and message within 7 days is not re-posted, and a clear vendor pitch is posted as "Possible Solicitation" without an alert; the submission itself is always saved and answered the same way
RESEND_API_KEY	Yes	Sends email notifications via Resend
NOTIFICATION_EMAIL	Yes	Email address that receives lead notifications (e.g., [email protected])
CLEARBIT_SECRET_KEY	Optional	Enriches leads with company/person data
HUBSPOT_API_KEY	Optional	Auto-creates CRM contacts
ZAPIER_WEBHOOK_URL	Optional	Forwards leads to Zapier

If any required variable is missing, that notification channel silently skips. Check Vercel dashboard > Settings > Environment Variables if notifications stop working.

📊 Features

Analytics & Tracking

• Google Analytics 4 with custom events
• Consent banner: analytics scripts load only after Accept (src/lib/consent.ts)
• Multi-platform conversion tracking
• Core Web Vitals monitoring

Lead Capture

• Smart contact forms with validation
• Automatic lead enrichment (Clearbit)
• Real-time Slack notifications (#leads channel)
• Email notifications via Resend (NOTIFICATION_EMAIL)
• CRM integration (HubSpot, Zapier)

Visitor Intelligence

• Company identification
• High-value visitor alerts
• Behavioral tracking
• UTM attribution

💰 Cost

Free Tier (everything you need to start):

• Google Analytics 4
• Slack webhooks
• Social media pixels
• Vercel hosting

Paid Tier (when ready to scale):

• Clearbit Reveal: $99/month (see which companies visit)
• HubSpot Starter: $45/month (CRM)

📝 License

Proprietary - BreederHQ, Inc.

---

For detailed setup instructions, see .docs/QUICK-START.md