# Reference map

All paths are relative to the extracted bundle unless stated otherwise. `source/frontend-v1/` preserves the original repository-relative paths for the curated source snapshot. `assets/public/` preserves paths below the web app's `public/` directory. See the root README for the exact included inventory and how to serve the catalogue.

Story links below target the local server started from the bundle root. If reading this file outside that server, open Storybook and search the displayed family name or use the stable story ID. The page and component references are existing v1 states. The separate synthetic soccer preview uses existing components with handoff-only fixture data; none of these is a v2 design.

## Start with these pages

| Reference | Story | What to inspect |
|---|---|---|
| Existing homepage | [Landing / Full Page — Desktop](../storybook/?path=/story/core-landing-page--desktop) | Overall comic composition, hero, market rows, activity and section rhythm. |
| Existing homepage on phone | [Landing — Mobile Sections and Brand](../storybook/?path=/story/core-landing-page--mobile-sections-and-brand) | Mobile composition and artwork/label fit. |
| Existing memecoin market | [Market Detail — All Star Live](../storybook/?path=/story/meme-madness-market-detail--all-star-live) | Shared starting point for memecoin and stock page design. |
| Market on phone | [Market Detail — All Star Live at 390](../storybook/?path=/story/meme-madness-market-detail--all-star-live-at-390) | Chart, prediction controls and compact hierarchy. |
| Closed market | [Market Detail — Betting Closed](../storybook/?path=/story/meme-madness-market-detail--betting-closed) | Closed-entry treatment. The story's legacy name is not a product-copy recommendation. |
| Resolved market | [Market Detail — Resolved](../storybook/?path=/story/meme-madness-market-detail--resolved) | Result and ongoing page hierarchy. |
| Cade Cup | [Cade Cup / Landing — Default](../storybook/?path=/story/pages-cade-cup--default) | Existing soccer-field shell, waiting state and campaign composition. |
| Sports event centre | [Sports / Markets — No Live Matches](../storybook/?path=/story/pages-sports--no-live-matches) | Soccer page shell and empty state. |

The existing sports and Cade Cup page stories mainly cover empty/unavailable states. They are not proof of a live populated match. Use the following handoff-only fixture to inspect the existing soccer components without a sports provider or live feed:

| Synthetic reference | Story | Use |
|---|---|---|
| Moving soccer ball | [Ball Movement](../storybook/?path=/story/handoff-soccer-reference--ball-movement) | Click **Advance demo ball** to inspect the existing ball movement, trail and field/scoreboard composition. |
| Waiting field | [Waiting for Match](../storybook/?path=/story/handoff-soccer-reference--waiting-for-match) | Empty field and waiting-band treatment. |
| Break state | [Half Time](../storybook/?path=/story/handoff-soccer-reference--half-time) | Centred ball and break-state message. |
| Phone fixture | [Mobile](../storybook/?path=/story/handoff-soccer-reference--mobile) | Same synthetic demonstration at the phone viewport. |

Teams, scores, play positions and events in this fixture are fictional. The source is [tooling/handoff.stories.tsx](../tooling/handoff.stories.tsx); it wraps existing `SoccerPitchViz` and `SoccerScoreboard` components and does not implement football or baseball. Audio is disabled and sports sound files are omitted from the handoff.

For machine-readable listings, use [component inventory](../catalog/component-inventory.json), [source story inventory](../catalog/story-inventory.json), [shape inventory](../catalog/shape-inventory.json), and [asset inventory](../catalog/asset-inventory.json). The source story inventory records repository metadata; the [built Storybook index](../storybook/index.json) is the authority for stories actually present in the portable viewer.

## Brand, foundations and controls

| Family | Stable story link |
|---|---|
| Current wordmark | [Cade Wordmark — Ink](../storybook/?path=/story/design-system-21-brand-cade-wordmark--ink) |
| Current compact mark | [Cade C Mark — Mark](../storybook/?path=/story/design-system-21-brand-cade-c-mark--mark) |
| Brand assets | [Cade Brand — All Assets](../storybook/?path=/story/design-system-21-brand-cade-brand--all-assets) |
| Palette, including explicitly labelled older sets | [Color Tokens — Audit](../storybook/?path=/story/design-system-01-foundations-color-tokens--audit) |
| Type sizes | [Type Scale — Desktop](../storybook/?path=/story/design-system-03-typography-type-scale--desktop) / [Mobile](../storybook/?path=/story/design-system-03-typography-type-scale--mobile) |
| Hard shadows | [Elevation — Ladder](../storybook/?path=/story/design-system-01-foundations-elevation--ladder) |
| Primary action | [CTA Slat — Primary](../storybook/?path=/story/design-system-05-buttons-cta-slat--primary) |
| Outcome pair | [Slat Button — Wager Pair](../storybook/?path=/story/design-system-05-buttons-slat-button--wager-pair) |
| Input | [Field — Empty](../storybook/?path=/story/design-system-07-inputs-field--empty) |
| Header | [Desktop Header — Rest](../storybook/?path=/story/design-system-10-navigation-desktop-header--rest) |
| Chart | [Live Source Chart — Default](../storybook/?path=/story/design-system-14-market-live-source-chart--default) |
| Prediction ticket | [Market Predict Ticket — Initial](../storybook/?path=/story/market-predict-ticket-confirmed-states--initial) |
| Round status | [Round Clock — Running](../storybook/?path=/story/duel-round-clock--running) |

Use the Storybook sidebar and Controls to inspect the full catalogue and variants. The explicit stable IDs may retain older hierarchy names; their readable sidebar titles are the current organisation.

## Source locators

The following are original `frontend-v1` paths. Look under `source/frontend-v1/` for included files; these locators also let the team identify an originating file without granting repository access.

| Area | Original path(s) |
|---|---|
| Current foundation tokens | `packages/tokens/src/design-tokens.ts` |
| Existing chrome/theme compatibility | `packages/tokens/src/theme-contract.ts`, `packages/tokens/src/tailwind-preset.ts` |
| CSS tokens and type bindings | `apps/web/app/globals.css` |
| Shared design-system components | `apps/web/app/components/design-system/` |
| Generic UI primitives | `apps/web/app/components/ui/` |
| Site chrome | `apps/web/app/components/header/` |
| Existing homepage | `apps/web/app/landing/components/CadeLandingResponsiveShell.tsx`, `CadeLandingPageShell.stories.tsx`; other components under the same folder |
| Memecoin detail page | `apps/web/app/meme-madness/market/[marketKey]/page.tsx`, `page.stories.tsx` |
| Market UI and prediction ticket | `apps/web/app/components/market/duel-frame/` |
| Price/source chart | `apps/web/app/components/LiveSourceChart.tsx` |
| Cade Cup shell | `apps/web/app/cade-cup/components/CadeCupPageShell.tsx`, `CadeCupLiveMatchBoard.tsx`, `CadeCupLiveMarketPreview.tsx` |
| Sports shell | `apps/web/app/sports/components/SportsPageShell.tsx`, `SoccerEventPanel.tsx` |
| Soccer field and animation | `apps/web/app/sports/components/SoccerPitchViz.tsx`, `SoccerPitchEffects.tsx`, `soccer-ball-motion.ts`, `use-soccer-marker-motion.ts` |
| Sports surrounding UI | `apps/web/app/sports/components/SoccerScoreboard.tsx`, `SoccerEventLog.tsx`, `SoccerMatchInfoPanel.tsx`, `SoccerPredictionMarkets.tsx`, `SportsArcadeTradeTicket.tsx` |
| Current logo wrapper and provenance | `apps/web/app/components/design-system/brand/CadeWordmark.tsx`, `CadeBrandSheet.tsx` |

Source is supplied for dimensions, construction and behaviour inspection. It can reference app dependencies absent from a curated extraction; it is not a drop-in implementation package.

## Artwork locators

| Asset folder/file | Role |
|---|---|
| `assets/public/design-system/brand/cade-wordmark.svg` | Current full Cade mark |
| `assets/public/design-system/brand/c-mark.svg` | Current compact C-mark |
| `assets/public/design-system/brand/` | Current PFP, banner and social assets, alongside any explicitly legacy exports |
| `assets/public/design-system/` | Exported component artwork, icons, panels and other design-system assets |
| `assets/public/assets/sports/soccer-field-v2.svg` | Existing soccer field artwork, rendered below the live ball layer |
| `assets/public/assets/sports/soccer-scoreboard-frame-v2.svg` | Existing scoreboard backing |
| `assets/public/assets/cade-cup/upcoming-field-waiting-band-v5.svg` | Existing field waiting treatment |
| `assets/public/design-system/charts/sports-playfieldviz-gridiron.svg` | Static gridiron reference; not the new football renderer |
| `assets/public/design-system/charts/sports-playfieldviz-diamond.svg` | Static baseball-field reference; not the new baseball renderer |
| `brand-kit-legacy/` | Legacy Pumpcade materials, clearly separated from current Cade authority |

Snapshots and reference renders in the bundle are dated packaging evidence. The portable gallery uses the bundled Barlow Condensed, Inter and JetBrains Mono fallback fonts under `fonts/`, each with an OFL licence. Use any future production shots supplied by Scott as additional visual references, and identify them separately from these renders.

## Coin-art completeness

The local artwork is included, but generated per-token character plates normally live on the asset CDN. Existing Storybook mocks return gray test plates or letter medallions. Do not treat those as the intended hero design. Original authored [Doge](../assets/public/landing/figma/cade-landing/hero-slot-a.png) and [Pepe](../assets/public/landing/figma/cade-landing/hero-slot-b.png) artwork is included; [capture notes](../references/README.md) explain this boundary.