# ZABA & ZINGO — Brand & Design System

**The single source of truth. Ratified 2026-07-11. Everything that carries the ZABA & ZINGO
name follows this repo — finally, once and for all.**

Modelled on the `design-md.wildwildagents` export format (MD · CSS · Tailwind · JSON), with more detail.

---

## Files

| File | What it is |
|------|-----------|
| [`01-CI.md`](01-CI.md) | Corporate identity — motto, slogan, wordmark, DBE/GFYS, non-negotiables |
| [`02-TYPOGRAPHY.md`](02-TYPOGRAPHY.md) | Full type system — two voices, cap-accent, scales, slogan, @font-face |
| [`03-COLORS.md`](03-COLORS.md) | Palette — dark + creme themes, per-world accents, semantic tokens, AA contrast |
| [`04-DESIGN.md`](04-DESIGN.md) | Design system — shape, space, elevation, motion, components, do/don't |
| [`05-CSS.md`](05-CSS.md) | Paste-ready `zz.css` (tokens + base + components), HTML skeleton |
| [`06-TAILWIND.md`](06-TAILWIND.md) | Tailwind v4 `@theme` + v3 config + component `@layer` |
| [`tokens.json`](tokens.json) | Machine-readable tokens (feed to any tool / AI) |
| [`AGENT-BRIEF.md`](AGENT-BRIEF.md) | One-block brief to paste into any build prompt |
| [`index.html`](index.html) | Live preview of the whole system (dark/creme toggle) |
| `fonts/` | Self-hosted Noto Serif Display ExtraCondensed + PP Neue Montreal |

---

## The system in 8 lines

- **Name/wordmark:** `ZABA & ZINGO` — with `&`, UPPERCASE, one colour, accent by weight.
- **Motto:** `DON'T BELIEVE EVERYTHING` (DBE). **Slogan:** `Reality isn't given. It's chosen.`
- **Fonts:** Noto Serif Display ExtraCondensed (display/brand) + PP Neue Montreal (sans/body). No third font.
- **Colour:** warm-dark `#22201f` ⇄ creme `#fffada`, ink `#f3eee4`, **one accent Terra `#A53A2A`**.
- **Shape:** rounded (6/8/10/14/18/pill). **Never cut-corner** — that's sign.it.
- **Elevation:** flat, no shadows; 1px hairlines.
- **Every frontend:** DE/EN + dark/creme toggle, i18n persistent, EN default.
- **Hard law:** no emojis · SVG icons only · no native controls · additive · AA contrast both themes.

---

## Sources (extracted, not invented)

- `discord.zabazingo.eu/typography.html` — ZZ Typography System v1 (2026-05-14)
- `collection.zabazingo.eu` · `moon.` · `mars.` — storefront design source of truth
- `hub2.zabazingo.eu` — token export (dark + creme)
- `keychain.zabazingo.eu/vault-desktop.html` — radius scale
- `zabazingo-docs` `03_TYPOGRAFIE.md` — ratified brand rules chapter

## Guard

`hooks/guard-zabazingo-wordmark.sh` — fails a commit if a wordmark drops the `&` or splits into
two colours. Keep it wired in the consuming project's `settings.json` PostToolUse.

---

*Extract from the live references, never re-invent from memory. When a rule here conflicts with an
older build, this repo wins.*