Changelog

0.1.0 (2026-07-15)

Added

• tokens: author canonical token source and build pipeline (9af4de9)

What the designer shipped in Figma, version by version. This is the upstream changelog — the downstream counterpart (what the codebase adopted) is the dated changelog in docs/style-guide.md. The two cross-reference by version ↔ PR.

Format: newest first. Each entry cites the Figma file/node it came from and the design-vN tag of the landing commit.

Not yet imported — noted for a future pass. A second Claude Design project, SWARM PROTOTYPE (https://claude.ai/design/p/efb8bef9-8de1-45d6-b603-35b7d59ebe6d, owner "Tucker"), holds full working-prototype pages built on top of the claude-design v1 mirror below: 00_Family Portal.dc.html, 01_Camp Department.dc.html, Camp Directors.dc.html, Coaches Corner.dc.html, Owners.dc.html, Canvas.dc.html, plus a standalone family-portal HTML file. These map closely to the persona set in docs/personas.md and go well beyond tokens/components into real page/route territory (camp-ops tables, incident logs, compliance tracking, staff assignment, communications) — out of scope for the tokens+components pass this changelog entry covers. Revisit when a screen-migration pass (runbook Part C) is scoped.

claude-design v1 — 2026-07-06 — Secondary source import (website + registration + dashboard)

First mirror of the Claude Design "Beestera Design System" project (https://claude.ai/design/p/5a748042-2339-4d70-82f6-5ce0a5bbed2d), imported via the DesignSync MCP connector per the runbook's Secondary source: Claude Design section. Committed under design/claude-design/export/ (own VERSION, this shared changelog) — Figma stays authoritative on any token/component overlap per the A3 rule.

• New surfaces not yet covered by the Figma export: full marketing site (home / camp listing / camp detail), a single-page 6-section camp registration flow (session → player → parent → medical/emergency → waivers → review & payment, with a sticky order summary and HIVE20 promo code), and a Club Portal dashboard shell (sidebar nav, topbar, KPI stat cards, player table, upcoming-camps rail). Delivered as cosmetic HTML/JSX reference kits under ui_kits/website/ and ui_kits/dashboard/, plus 21 rendered token/component specimen cards under preview/.
• Token overlap check (A3 rule applied): the --bee-* custom-property tokens in colors_and_type.css overlap heavily with the existing Figma-derived @theme SSOT (packages/ui/src/styles/tokens.css) — same brand yellow #FFD700→#FCA000 ramp and the same zinc neutral ramp. Figma wins on overlap; nothing here should overwrite packages/ui/src/styles/tokens.css values. Net-new tokens worth reconciling on the next porting pass: the gradient tokens (--bee-gradient-hive-overlay, --bee-gradient-hex-*), the 5-tier shadow ladder (flat/subtle/card/float/glow), and the Inter secondary-UI family (used heavily in the registration form labels; not yet in the @theme font stack).
• Fonts: Sweet Sans Pro (all weights, licensed) is specified but this import could not carry the .otf files themselves through the connector (see below). Open Sans / Inter / Anton are Google Fonts loaded by URL. Anton is an explicit placeholder for the licensed Zuume / Zuume Edge display font used only for the "thrive in the hive" promo wordmark — note for follow-up: the source project's own fonts/ directory lists real Zuume/ZuumeEdge .ttf files (Zuume_Black.ttf, ZuumeEdge-{Black,Bold,ExtraBold,ExtraLight}{,Italic}.ttf, plus 1-/2- prefixed duplicates) even though the project's own README/CSS still describe Zuume as "licensed, not supplied." Worth asking the design owner whether the licensed Zuume Edge font is now available to wire in for real, since the Anton substitution may no longer be necessary.
• Import gap — binary assets not mirrored. The DesignSync connector's get_file truncates any file over 256 KiB, which corrupts binary content. The following were not pulled into this copy (only assets/zuume-arch.png made it, since it and it alone was under the cap): assets/bee-icon-{black,white,full}.png, assets/logo-mark-{black,white}.png, assets/wordmark-{black,white}.png, assets/hex-outline.png, assets/hive-pattern.png, assets/hero-camp-photo.png, and all ~40 files under fonts/ (Sweet Sans Pro .otf + the Zuume/ZuumeEdge .ttf files noted above). The generated build artifact _ds_bundle.js (a Babel-compiled concatenation of the same .jsx sources already mirrored individually) was also intentionally omitted as a derived file, not a design source. Re-export path: use Claude Design's "Send to Claude Code Web" from the project page to seed these binaries directly into a workspace, or increase the connector's per-file cap.

Downstream adoption: see the docs/style-guide.md v3 changelog for the codebase-side entry — gradient-brand + shadow-glow tokens and the PromoBanner + StepProgress primitives landed; CampCard, Footer, TopNav, and a generic Sidebar/Topbar were deliberately deferred (see that entry for why). No screens ported yet.

v1 — 2026-06-25 — Foundation port

Initial port of the design-system foundation from the "Beestera Design System" Figma file. Scoped to pages 00 Brand (node 28:577) and 00 | CSS & Responsive Standards (node 2018:29051) — the whole file was not pulled.

• Tokens reconciled (Figma vs live site) and landed in the @theme SSOT (apps/web/src/styles/global.css):
  • Brand honey/yellow scale (Yellow/50…900; brand primary #FFD700, gradient → #FCA000).
  • Zinc neutral ramp (#FAFAFA … #09090B) + white/black.
  • Semantic status (success / danger / warning / info).
  • Typography families (Open Sans primary; Sweet Sans Pro Heavy caps accent), 8-role type scale, letter-spacing.
  • Spacing (4px base / 8px grid), radii, shadows, breakpoints (768px tablet threshold; 1320px max content).
• Pipeline decision recorded as ADR-0011 (manual-curated Figma → @theme).
• Upstream export artifacts committed under design/export/ — the round-trip baseline (runbook Part B). Re-exports overwrite these, so a future git diff is exactly what changed in Figma:
  • tokens/tokens.json — raw foundation values (105 colours, 25 type styles) extracted from the scoped node JSON. The Variables REST API is 403 on this plan, so values are read from node fills / text styles, not /variables/local.
  • foundations/css-source-of-truth.json — verbatim text blocks of the Figma frame "Beestera Source of Truth: CSS + Responsive Standards" (node 2032:54), in document order.
  • assets/{logos,primary-icon,wordmark,hex-default}.svg — exported brand marks (the wordmark/logos carry embedded raster; hex-default is clean vector). components/ (01 Components) and screens/ (Part C) stay empty.

Downstream adoption: see the docs/style-guide.md v1 changelog for the codebase-side entry (the components/ui/ primitives + the /internal/styleguide route built on these tokens).