Brand Kit — flow doc

Living doc — how the Brand Kit works now. For why, see ADR-0065 and the use-case (UC-901). For history, see the spec. This doc is rewritten in place as the flow changes; it does not restate the ADR/spec.

What it is

A public, no-login page at plings.io/brand where print vendors, partners, press and the Plings team self-serve the official brand assets. It is also the human-facing edition of the brand guidelines (the canonical machine values live in docs/brand/design-system.md).

How it works

• Route: /brand → src/pages/Brand.tsx, a public route in src/App.tsx (no auth wrapper), reachable from the footer “Brand Kit” link (src/components/Footer.tsx).
• Data: a single typed manifest, src/data/brandAssets.ts, describes every published asset (logos + variants + formats, colours, font weights, guidelines/letterhead paths). The page renders from this manifest — adding an asset is a manifest edit.
• Assets: static files under public/static/brand/ served by Vercel’s CDN. Downloads are plain <a href download> — no JS download logic, no backend, no GraphQL.
• Sections (src/components/brand/):
  • LogoGallery — one card per lockup; variant selector (Standard/Black/White) swaps preview + downloads; a light/dark surface toggle so white logos are visible; a full-lockup vector card (AI/EPS/PDF).
  • ColorPalette — five swatches; clicking HEX/RGB/CMYK copies the value (sonner toast).
  • Typography — Poppins Bold + Light specimen (Poppins is the app’s default font).
  • FontKit — each Poppins weight + a “Download all (zip)”; links the OFL licence.
  • Stationery — the letterhead template (AI/EPS/JPG; no PDF export exists).
  • Guidelines — construction, variations, safe zone and do/don’t rendered natively, plus a link to the full guidelines PDF.

Boundaries

• Excluded assets: personal business cards and non-Plings files (e.g. Grönteknik) are deliberately not published.
• Not published yet: PSD editing sources and SVG logo exports (ROADMAP backlog).
• Web is a presenter of curated assets; it does not generate or edit artwork.

Related

• Decision: ADR-0065
• Use-case: UC-901
• Canonical colours/typography: design-system.md
• History: docs/specs/2026-07-04-brand-kit-page-design.md