# Twenty One Run Brand Hub

This site provides official Twenty One Run brand assets and guidelines for humans and AI tools.

## Preferred AI entrypoints

- Plain-HTML AI reference: https://brandhub.twentyonerun.com/ai
- Compact brand JSON: https://brandhub.twentyonerun.com/brand.json
- Inline brand JSON with raw SVG source strings (fallback when direct SVG fetches fail): https://brandhub.twentyonerun.com/brand-assets-inline.json
- Plain-text raw XXi logo SVG (no HTML, no JS): https://brandhub.twentyonerun.com/logo-svg.txt
- Full asset manifest JSON: https://brandhub.twentyonerun.com/brand-assets.json
- Full asset ZIP bundle (~28 MB, all logos/coaches/events/email): https://twentyonerunbrandhub.lovable.app/__l5e/assets-v1/43619e93-f4ab-4f53-9be8-a37f907fccca/brand-assets-bundle.zip
- Brand guide markdown: https://brandhub.twentyonerun.com/brand-guide.md
- Human assets page: https://brandhub.twentyonerun.com/assets

## Sandboxes that can't fetch external URLs

If CDN/origin fetches are blocked, fetch `/brand-assets-inline.json` once. It mirrors the main manifest's `version` and embeds:

- Every logo as `inline.svg` (vector source) plus `inline.png200` (200px PNG raster).
- Every coach as `inline.circle64` — a 64x64 transparent PNG, 2x retina for the 32px display used in email schedule blocks.

Each `dataUri` drops straight into `<img src="...">`. For larger coach sizes or other variants, the original `images.original | square | circle` URLs remain in the same object.


## How to use this brand hub

Use the manifest JSON instead of browser scraping. It contains direct public URLs for:

- Logos and wordmarks
- Coach photos in original, square, and transparent circle PNG variants
- Event photography under `events[]` (e.g. In-House Ultra 2025)
- Email campaign photography under `email[]` (e.g. 4th of July storefront, DES News, Long Run Edge)
- Söhne font URLs
- Coach names, roles, and class details

For round coach avatars, use `coaches[].images.circle` from `/brand-assets.json`. Do not recreate circles in the browser unless a new crop is required.

For square coach cards, use `coaches[].images.square`.

For source images, use `coaches[].images.original`.

If `brandhub.twentyonerun.com` is unavailable in a sandbox, use `twentyonerunbrandhub.lovable.app` with the same paths.

## Brand summary

- Brand name: Twenty One Run
- Primary palette: Asphalt #000000 and Snow #FFFFFF, with Dirt #E1CCB6 and Stone #C8D8E4 supporting.
- Secondary accents: Red #FF0000, Green #4ABF33, Blue #0066EF, Yellow #FFB000. Use sparingly.
- Typeface: Söhne family — Breit for display, Schmal for condensed headlines, Buch/Halbfett for body/UI, Mono for labels/buttons.
- Voice: bold, direct, energetic, warm, and human. Have an edge, but don't cut.
- Layout: Swiss-inspired grid, generous whitespace, sharp precision, hard-offset monochrome shadows.

## Important constraints

- Do not recolor, rotate, stretch, outline, or add shadows to logos.
- Do not place logos on busy backgrounds.
- Do not use unapproved colors for core brand marks.
- Do not shorten the brand name to TOR or 21 Run in customer-facing copy.