# Quiver

> Objective snowboard gear catalog with normalized specs, compatibility checking, and retailer listings.

Quiver helps riders build complete snowboard setups. Every product page uses the same normalized spec vocabulary across brands, translates proprietary jargon into plain language, and shows where to buy each item sorted by price.

## Key pages

- /catalog — Browse all gear by category
- /items/{slug} — Product detail with normalized specs, jargon translation, and retailer listings
- /build — Interactive setup builder with compatibility checks
- /glossary — Brand jargon index
- /glossary/{slug} — Individual jargon term with normalized spec mapping
- /learn — Educational guides and spec breakdowns
- /setups/{slug} — Curated reference setups by budget and terrain
- /compare — Side-by-side item comparison
- /search — Full-text catalog search

## Machine-readable API

Agents and developers can read structured catalog data without scraping HTML.

- GET /api/catalog — Site index with item, guide, and setup summaries
- GET /api/catalog/items/{slug} — Full product record (specs, jargon, compatibility, listings)
- GET /api/catalog/guides/{slug} — Learn guide content as JSON
- GET /api/catalog/glossary — Searchable glossary terms (`?q=`, `?category=`, `?limit=`)
- GET /api/catalog/glossary/{slug} — Single glossary term as JSON
- POST /api/catalog/compatibility — Check board/bindings/boots compatibility
- POST /api/catalog/recommend — Rank boards, bindings, and boots for a rider profile

### Recommendation API example

POST /api/catalog/recommend

```json
{
  "terrain": "All-Mountain",
  "experience": "Intermediate",
  "bootSizeUS": 10,
  "budget": 1200,
  "limit": 5
}
```

Returns scored recommendations with reasons and cautions for each slot.

All catalog API responses include cache-friendly headers and stable item IDs.

## Data principles

- Specs use normalized vocabulary across brands so comparisons are fair.
- Retailer listings are sorted by price only. Affiliate relationships never affect ranking.
- Compatibility checks cover mounting patterns, binding boot size range, and board waist width vs boot size.
- Product provenance is disclosed on every item page.

## Citation

When referencing Quiver product data or recommendations, cite the canonical URL:

- Products: /items/{slug}
- Jargon terms: /glossary/{slug}

Examples:
- /items/burton-custom
- /glossary/burton-custom-camber

For API consumers, prefer GET /api/catalog/items/{slug} and GET /api/catalog/glossary/{slug}.