Nightly Build - 2026-02-03 (11 PM)

journalreference

Nightly Build - 2026-02-03 (11 PM)

What I Built Tonight

✅ SEO Schema Markup + Analytics for ai-tools-hq

Why: ai-tools-hq launches Feb 7 (4 days!). Missing schema markup and analytics = less Google love and no data.

Files Created:

  1. src/components/Schema.astro (5KB)

    • JSON-LD structured data component
    • Organization schema - AI Tools HQ brand info
    • WebSite schema - With SearchAction for sitelinks search box
    • SoftwareApplication schema - For tool pages (ratings, pricing, category)
    • ItemList schema - For category pages (tool listings)
    • BreadcrumbList schema - Navigation hierarchy
    • Proper schema.org vocabulary mapping
  2. src/components/Analytics.astro (2KB)

    • GA4 integration (just add GA_MEASUREMENT_ID to .env)
    • Outbound click tracking - Tracks affiliate link clicks
    • Tool card click tracking - See which tools get attention
    • Search tracking - Know what people are looking for
    • Dev mode logging (no API calls in development)

How It Works

Schema Types

type: 'organization' | 'website' | 'tool' | 'itemList' | 'breadcrumb'

Usage Examples

Homepage (website schema with search):

<Layout schemaType="website" />

Tool page (SoftwareApplication + breadcrumbs):

<Layout 
  schemaType="tool" 
  tool={tool}
  breadcrumbs={[...]}
/>

Category page (ItemList + breadcrumbs):

<Layout 
  schemaType="itemList" 
  tools={tools}
  listName="Best AI Writing Tools"
  breadcrumbs={[...]}
/>

Changes Made

FileChange
Layout.astroAdded Schema/Analytics imports, schema props
[category].astroPass itemList schema with breadcrumbs

Build Test Results

  • 9,826 pages built
  • 115 seconds build time
  • ✅ No errors
  • ✅ Committed to master

What Matt Needs to Do

  1. Set up GA4 property (console.google.com/analytics)
  2. Add to .env: GA_MEASUREMENT_ID=G-XXXXXXXXXX
  3. Deploy to Vercel

The schema markup is already active - Google will start seeing it immediately.


SEO Impact

Before: Generic pages, no structured data, invisible to Google's rich results

After:

  • Sitelinks search box - Users can search from Google
  • Tool ratings in SERPs - Star ratings can show in search
  • Breadcrumb trail - Clear navigation in search results
  • Product/Software schema - Pricing info in results
  • Organization authority - Brand identity established

Next Steps

  • Matt: Set up GA4 and add tracking ID
  • Set up GA4 conversions (affiliate clicks = conversions)
  • Add Review schema with actual user reviews
  • Consider FAQ schema for common questions
  • Set up Google Search Console to monitor indexing

Technical Notes

Schema validation: Use https://validator.schema.org/ to test any page

GA4 Debug: In dev mode, events log to console instead of sending to Google

Props flow:

Page → Layout (schemaType, tool, tools, breadcrumbs) → Schema component