# CANON — What is your Canon?
# https://whatsyourcanon.com
# Publisher: VaultSpark Studios LLC — https://vaultsparkstudios.com
# License: Proprietary — All Rights Reserved, VaultSpark Studios LLC
# Contact: hello@whatsyourcanon.com
# Status: Private Beta (S155, June 2026)

## About

CANON is a cross-category taste identity social platform. It lets people curate
their definitive lists across 25 categories — film, television, music, books,
games, podcasts, food, restaurants, travel, art, photography, fashion,
architecture, sports, fitness, tech, science, philosophy, nature, comedy,
theater, dance, animation, and more.

The core proposition: "What is your Canon?" — a permanent record of who you are
through what you love. CANON generates Taste DNA profiles, archetype identities,
compatibility scores with other users, and AI-powered discovery features.

## Key pages

- / — Marketing home with live proof wall and feature overview
- /explore — Public Canon items, Zeitgeist pulse, Canon of the Week, community index
- /discover — Main discovery hub: Category Terrain Map (All Time + This Month toggle), oracle prophets, faction alliances, trending
- /discover/oracle-prophets — Leaderboard of most accurate taste predictors (curators with high verified prediction accuracy)
- /{username}/bridges — Public Bridge Walker Atlas: a curator's cross-category Canon with Bronze/Silver/Gold tier progression
- /discover/genealogy/[item_id] — Public item lineage pages and Genealogy Atlas roots
- /discover/genealogy/bridges — Cross-category bridge items (works spanning 2+ categories in the influence graph)
- /contact — Contact page: Brevo-backed contact form plus hello@whatsyourcanon.com fallback, with support, press, and partnership paths
- /feeds — Human-readable feed directory for RSS, JSON Feed, OPML, per-user feed templates, agents.json, llms.txt, and sitemap
- /about — Platform philosophy, values, origin story, all 25 categories
- /pricing — Free tier vs CANON Pro ($5/month) comparison
- /guide — How to build, shape, share, and play on CANON
- /faq — 23 questions across 6 categories: basics, building your Canon, Taste DNA, identity features (Bridge Walker, Timeless Canon, archetypes, factions), social, and account
- /updates — Product changelog (reverse chronological)
- /download — Android APK + iOS beta
- /press — Media kit, quick facts, boilerplate, brand assets
- /privacy — Privacy policy
- /terms — Terms of service
- /signup — Create account
- /login — Sign in

## Machine-readable

- /agents.json — Full agent manifest (endpoints, capabilities, JSON-LD)
- /sitemap.xml — Full URL sitemap
- /feed.xml — Platform-wide RSS 2.0 feed of recent public Canon items (last 100 across all curators, 30-min cache)
- /feed.json — Platform-wide JSON Feed 1.1 feed of recent public Canon items (last 100 across all curators, 30-min cache)
- /{username}/feed.xml — Per-curator RSS 2.0 feed of their most recent 50 public Canon items (1-hour cache)
- /{username}/feed.json — Per-curator JSON Feed 1.1 feed of their most recent 50 public Canon items (1-hour cache)
- /feeds.opml — OPML 2.0 export of the platform feed plus active public curator RSS feeds for feed readers and AI agents
- /feeds.json — Machine-readable feed directory listing platform and per-user feed templates for agents. schemaVersion 1.0 feed directory contract includes platform, perUserTemplates, discovery, liveSample, and liveSampleMeta status/detail/count/checkedAt fields
- /api/contact — Contact form POST endpoint. Sends founder copy plus sender acknowledgement when BREVO_API_KEY is configured; returns honest 503 when email is unavailable.
- /.well-known/security.txt — Responsible disclosure contact
- /robots.txt — Crawl permissions
- /api/discover/genealogy-constellations — Read-only JSON of consensus lineage clusters
- /api/discover/lineage-gaps?item={catalog_item_id} — Read-only JSON of high-confidence Add-to-Canon lineage gap prompts
- /api/discover/genealogy/bridges — Cross-category bridge items: works bridging 2+ categories (filterable, JSON)
- /api/ai/taste-ancestry?user_id={user_id} — AI-generated taste ancestry narrative for a public profile (7d cache)
- /api/profile/{username}/bridge-walker-receipt — Public, bounded JSON receipt for Bridge Walker eligibility from public bridge-item claims
- /api/og?mode=bridge-walker&username={username}&bridges={count}&t1={title1} — Dynamic share card for Bridge Walker achievement (CDN-cacheable, no auth required)
- /api/og?mode=genealogy-constellation — Dynamic share card for public Genealogy Atlas pages
- /api/ai/taste-destiny — Auth-gated. AI oracular prophecy for the authenticated user: where their taste is heading, 3 specific destiny items (7d Haiku cache)
- /api/discover/memory-curation — Auth-gated. The user's oldest Canon items (365d+) surfaced for keep/archive/pin curation
- /api/discover/category-terrain — Public. Live bubble-chart data of category claim counts across the platform (CDN-cached 10 min)
- /{username}/bridges — Public. Bridge Walker Personal Atlas page: a user's cross-category Canon grouped by category with tier badges (Bronze/Silver/Gold)
- /api/profile/{username}/memory-anchors — Public, bounded. A user's explicitly pinned/memory-anchored Canon items (oldest, most treasured claims)
- /api/discover/category-terrain?since=30d — Public. Category claim counts restricted to the last 30 days (momentum view, CDN-cached 5 min)
- /api/ai/destiny-resonance — Auth-gated. Find other curators who share the authenticated user's AI-predicted destiny items (ILIKE fuzzy-matched against catalog)

## AI features on-platform

- Taste DNA: Voyage AI embeddings + dimension inference across 5 axes
- Archetype inference: 8 archetypes (Archivist, Curator, Enthusiast, Pioneer,
  Contrarian, Eclectic, Nostalgic, Visionary)
- Weekly Discovery Brief: Haiku-generated personalized recommendations
- Evolution Arc: narrative of taste identity shift over time
- Oracle Predictions: structured prediction market for taste futures
- Taste Compatibility: Jaccard + archetype scoring vs other users
- Faction Assignment: taste-similarity-based social grouping (6 factions)
- Canon Chat: AI assistant aware of your full taste profile
- Genealogy Atlas: public influence graph pages, mobile card fallback, lineage rivalry comparisons, profile lineage receipts, Add-to-Canon lineage gap prompts, dynamic constellation share cards, consensus constellations, cross-category bridge detection, Bridge Walker profile receipts, taste ancestry AI narratives, and weekly digest genealogy prompts
- Taste Destiny AI: Haiku-generated oracular prophecy about where the user's taste is heading, with 3 specific predicted items (7d cache, auth-gated)
- Canon Memory Curation: surfaces oldest Canon items (365d+) for keep/archive/pin curation actions (auth-gated)
- Category Terrain Map: live platform-wide bubble chart of category claim counts, deterministic SVG layout (public, CDN-cached 10 min). Supports All Time vs This Month toggle — ?since=30d shows taste momentum (which categories are being claimed NOW vs historically dominant)
- Bridge Walker Personal Atlas: /{username}/bridges public page — cross-category Canon grouped by category, Bronze/Silver/Gold tier badges
- Memory Pin Showcase: public /{username} profiles show a "Timeless Canon" section for items explicitly memory-pinned by the curator — permanent identity anchors
- Destiny Resonance: auth-gated. Given the user's AI-predicted destiny items, finds other public curators who have claimed the same items (ILIKE fuzzy-match), sorted by resonance depth
- Timeless Canon Profile OG: profiles with memory-pinned items generate a dark-gold share card (◆ glyph, archetype, up to 3 pinned titles) as the top-priority OG image; CDN-cached (s-maxage=3600)
- Terrain Growth % Tooltip: hovering a category node in the Category Terrain Map's This Month view shows ↑N% growth rate vs all-time baseline, revealing category momentum
- Discover Curator Spotlight: most-active public curator for the week is surfaced on /discover with avatar, bio, and recent Canon items; ISR-cached for performance
- Per-user RSS feeds: every public profile exposes /{username}/feed.xml with that curator's latest public Canon items, escaped XML, 1-hour cache, and profile metadata autodiscovery
- OPML Curator Feed Export: /feeds.opml bundles the platform feed plus active public curator feeds into a portable subscription list for RSS readers and AI agents
- JSON Feed Export: /feed.json and /{username}/feed.json mirror the RSS surfaces in JSON Feed 1.1 for agents and modern readers
- Feed Directory JSON: /feeds.json lists the canonical RSS, JSON Feed, OPML, profile, sitemap, agents.json, and llms.txt locations in one cacheable agent manifest
- Contact form: /contact posts to /api/contact for Brevo transactional forwarding and sender acknowledgement; hello@whatsyourcanon.com remains visible as the on-domain fallback

## Platform facts

- Founded: 2026 by VaultSpark Studios LLC
- Stack: Next.js 15 (App Router), Supabase, Cloudflare, Anthropic Claude (Haiku)
- Categories: 25 (film, television, music-albums, music-songs, books, games,
  podcasts, food, restaurants, travel, art, photography, fashion, architecture,
  sports, fitness, tech, science, philosophy, nature, comedy, theater, dance,
  animation, other)
- Pricing: Free (core features) + CANON Pro ($5/month, Taste DNA + AI + imports)
- Platforms: Web (whatsyourcanon.com), Android (beta APK), iOS (TestFlight, coming)

## Agent notes

- /explore returns live public items (SSR, revalidated)
- Public profiles at /[username] include taste identity cards, DNA dimensions,
  compatibility badges, oracle champion status, Bridge Walker badge receipts, and faction affiliation
- The /api/og route generates dynamic OpenGraph images for social sharing
- Authentication: Supabase SSR (email/password + Google OAuth)
- Public read-only JSON exists for genealogy constellations, lineage rivalries, and lineage gap prompts; public genealogy pages expose item lineage, share-card metadata, and comparison context for agents