# The Bee Team - Pollinator Oasis Product Canon

> The four canonical documents for Pollinator Oasis, the Crown Bees pollination app built by The Bee Team (Dave Hunter + Scott Sands): what is live today, what we build next, the desired experience by persona and flow, and the design language it is all built in.

The markdown linked below is the single source of truth - the same files the team edits, served verbatim. The web and PDF renders are generated views of it and are never edited separately. Each document states its own maturity: approved canon, or draft on the v0.x track. Read the As-Built Spec first for what is actually live; it is reconciled against the running code, never speculative.

Shipped skin: btt-server v61 . client EAS build 24 + OTA 3c52b3f5 . running ac5969c.

## Canon documents

- [As-Built Spec - v1.0.11 (Live . canon)](https://bt-canon.pages.dev/as-built-spec.md): The current-state map of Pollinator Oasis - the shipped screens, the auth reality, the routes, and the design system - reconciled against the running code, never speculative.
- [To Build Spec - v0.2 (Draft)](https://bt-canon.pages.dev/to-build-spec.md): The near-term roadmap - what ships next, in what order, at what level of effort - the bridge from what is live to the desired experience.
- [UX Flow Atlas - v0.2 (Draft)](https://bt-canon.pages.dev/ux-flow-atlas.md): The experience canon - the three personas (The Bee SME, The Hobbyist, The Newbee) mapped across the user flows. The words and the journeys carry the value; images are never pixel canon.
- [Design System - v1.0 (Approved . canon)](https://bt-canon.pages.dev/design-system.md): The visual and interaction language the product is built in - the Crown Bees brand. Two colors, one typeface, warm neutrals, and a small, disciplined component vocabulary.

## Full corpus

- [llms-full.txt](https://bt-canon.pages.dev/llms-full.txt): All four canon documents concatenated in reading order, for loading the entire canon in one fetch.

## Optional

- [As-Built Spec (PDF)](https://bt-canon.pages.dev/pdf/as-built-spec.pdf): The human-facing render - same content as the markdown, no new information.
- [To Build Spec (PDF)](https://bt-canon.pages.dev/pdf/to-build-spec.pdf): The human-facing render - same content as the markdown, no new information.
- [UX Flow Atlas (PDF)](https://bt-canon.pages.dev/pdf/ux-flow-atlas.pdf): The human-facing render - same content as the markdown, no new information.
- [Design System (PDF)](https://bt-canon.pages.dev/pdf/design-system.pdf): The human-facing render - same content as the markdown, no new information.