Steam Shark - brand

Design system source of truth for Steam Shark: color and spacing tokens, the icon/component set, and the full spec doc. Figma is the visual design surface; this repo is what the extension, API docs site, and marketing site actually import from.

Structure

brand/
├── README.md            # this file — what the repo is, how it's organized
├── DESIGN.md             # comprehensive design system spec, written to be AI-readable
├── CHANGELOG.md          # changelog of the design system (Keep a Changelog format)
├── guidelines/
│   ├── logo.md           # logo usage: clear space, minimum size, don'ts
│   ├── color.md          # color usage rules, accessibility/contrast notes
│   ├── typography.md     # type scale, font usage
│   └── voice-tone.md     # writing/voice guidelines
├── tokens/                # machine-readable design tokens (source of truth for imports)
│   ├── colors.json
│   ├── spacing.json
│   └── typography.json
└── logo/                  # logo source files and exports
    ├── svg/
    ├── png/
    └── favicon/

• DESIGN.md is the entry point — self-contained enough to hand to an AI on its own, and links out to guidelines/ and tokens/ for deeper detail.
• tokens/ holds the actual values consumed by the extension, docs site, and marketing site — never hardcode a value elsewhere that's defined here.
• guidelines/ holds the prose rules (usage, do/don't) behind each token category.
• logo/ is the canonical source for brand marks; other repos should copy/import from here, not vice versa.