# Boilerplate SEO Site - AI Crawler Info

## Site Purpose
This is a programmatic SEO (pSEO) site that generates location-based service pages and educational blog content.

## Structure
- Dynamic pSEO routes: /{category}/{keyword}
- Blog routes: /blog, /blog/{slug}
- Each pSEO page contains: comparison tables, local service information, and AI-generated content
- Blog articles provide guides, tips, news, and reviews
- Content is optimized for "Answer First" format

## Data Source
- Database: Cloudflare D1 (SQLite)
- Images: Cloudflare R2
- AI Content: OpenRouter API (Claude/Gemini)

## Main Routes
- / - Homepage with featured content
- /{category}/{keyword} - Dynamic service pages (pSEO)
- /blog - Blog listing with all published articles
- /blog/{slug} - Individual article pages
- /sitemap.xml - Full sitemap including all pages and articles

## Content Types & Page Types

The site uses a flexible page type system. Default types:

### pSEO Legacy (pseo-legacy)
Location-based service pages following "Answer First" structure:
1. Direct answer in first paragraph
2. Detailed comparison table
3. Location-specific insights
4. Call-to-action
5. Related services and articles

Route pattern: /{category}/{keyword}

### Blog Article (article)
Editorial content with author attribution for E-E-A-T compliance:
- Introduction with hook
- Key points section
- Detailed analysis
- Practical tips
- Conclusion with CTA

Route pattern: /blog/{slug}

Custom page types can be created via the admin panel at /admin/page-types with configurable:
- Title/meta/H1 templates
- AI system prompts
- Content sections
- Custom fields

## Structured Data
All pages include JSON-LD structured data:
- BreadcrumbList for navigation
- BlogPosting for articles (with author info)
- WebPage for static pages
- LocalBusiness/Product for pSEO pages (configurable per page type)

## Last Updated
2026-01-21