# TagTheBuild

TagTheBuild is a platform where creators upload build photos, place interactive clickable hotspots tagging components with links and pricing, and publish shareable pages.

## Canonical URL Format

Public builds use the format: `/b/{publicId}/{slug}`
Individual images use: `/b/{publicId}/{slug}/i/{imagePublicId}`

## API Endpoints

### Build JSON API
- `GET /api/b/id/{publicId}` — Full build data including images, hotspots, parts, and plans

### Build Markdown (LLM-friendly)
- `GET /api/llm/builds/{publicId}.md` — Plain markdown summary of a published build

### Build HTML Snapshot (Crawler-friendly)
- `GET /api/public-html/builds/{publicId}` — Server-rendered semantic HTML with full metadata, JSON-LD, and structured content

### Discovery
- `GET /api/seo/sitemap.xml` — XML sitemap of all published builds
- `GET /api/seo/build-feed.json` — JSON feed of published builds with metadata

### Categories
- `GET /category/{slug}` — Server-rendered HTML page listing all builds in a category. Slugs: sauna, cold-plunge, home-gym, pc-setup, van-build, workshop, garage, kitchen, bathroom, electrical, other.

### Sitemap
- `GET /sitemap.xml` — XML sitemap (301 to /api/seo/sitemap.xml). Includes all pages plus image:image extensions for every build image.

## Content Structure

Each build contains:
- Title, subtitle, description, category
- Creator profile (display name, bio, avatar)
- Multiple images with interactive hotspot tags
- Each hotspot links to products with prices, merchant info, and affiliate status
- Optional plan files (PDFs, images)
- Estimated total cost based on tagged parts