|
1 | 1 | # Example Brand Guide |
2 | 2 |
|
3 | | -Canonical source for the Example identity. Replace each placeholder before publishing the first consumer. |
| 3 | +Canonical source for the Example identity. Every section below is a |
| 4 | +placeholder — fill it in before publishing the first consumer. |
4 | 5 |
|
5 | 6 | ## Identity |
6 | 7 |
|
7 | | -Describe what Example is, who it serves, and what it must not be confused with. |
| 8 | +Describe what Example is, who it serves, and what it must not be |
| 9 | +confused with. |
8 | 10 |
|
9 | 11 | ## Mark |
10 | 12 |
|
11 | | -Document primary mark, clear space, minimum size, and approved variants. |
| 13 | +Document the primary mark, clear space, minimum size, and approved variants. |
12 | 14 |
|
13 | 15 | ## Color |
14 | 16 |
|
15 | | -| Role | Light | Dark | Usage | |
16 | | -| ------ | --------- | --------- | ------------------ | |
17 | | -| Paper | `#f5f5f0` | `#151515` | Page surfaces | |
18 | | -| Ink | `#151515` | `#f5f5f0` | Primary content | |
19 | | -| Muted | `#666660` | `#aaa9a0` | Supporting content | |
20 | | -| Line | `#d0d0c8` | `#3a3a36` | Borders and rules | |
21 | | -| Accent | `#6cff8f` | `#6cff8f` | Focus and emphasis | |
| 17 | +The shipped tokens are neutral greys plus a functional focus color. They exist |
| 18 | +so the toolkit renders legibly out of the box, not because they are the brand. |
| 19 | +Replace the values in `tokens.css`, then record them here. |
| 20 | + |
| 21 | +| Token | Light | Dark | Usage | |
| 22 | +| ----------- | ----- | ---- | ----------------- | |
| 23 | +| `bg` | | | Page background | |
| 24 | +| `bg-raised` | | | Raised surfaces | |
| 25 | +| `fg` | | | Primary text | |
| 26 | +| `fg-muted` | | | Supporting text | |
| 27 | +| `border` | | | Borders and rules | |
| 28 | +| `focus` | | | Focus rings | |
| 29 | + |
| 30 | +Two rules worth keeping whatever the palette becomes: |
| 31 | + |
| 32 | +- Name tokens for the role a color plays, not a material it imitates. Roles |
| 33 | + survive a redesign; metaphors have to be renamed or quietly start lying. |
| 34 | +- Give every color a job. A single decorative accent applied wherever a page |
| 35 | + looks flat is how unrelated products end up looking identical. |
| 36 | + |
| 37 | +Verify each foreground against the surfaces behind it — WCAG AA is 4.5:1 for |
| 38 | +normal text, and a focus ring needs 3:1. Assert it in a test so the palette |
| 39 | +cannot drift. |
22 | 40 |
|
23 | 41 | ## Typography |
24 | 42 |
|
|
0 commit comments