Themes and brands
Light and dark, times four brands: one set of components. Themes and brands only ever change semantic tokens.
The same card, every brand
The markup is identical in every pane. Only the tokens differ. Each example is pinned to its brand with brand="…", so the Preview brand switch doesn't change them; every other example in these docs follows the switch.
Show code
<div class="card sm-stack" style="padding:20px">
<p class="sm-h3">One system, many brands</p>
<p>Same markup. Different tokens.</p>
<a class="btn-primary" href="#">Start a project</a>
</div> How it works
- Components only use semantic tokens:
action.primary, neverember-600. - A theme file gives every semantic token a value. Light and dark are two theme files with identical names.
- A brand adds two more files that override some of those names. Anything a brand doesn't override falls back to Somnia DS.
- An attribute switches them:
data-theme="dark"ordata-brand="gulo", on the whole page or on any element. - Brands can change typefaces too, through the
font.heading,font.bodyandfont.monotokens. The Media Dreams logo never changes: it uses the primitives directly.
// tokens/brands/spotlight.light.json
{
"$name": "Spotlight.me",
"color": {
"action": {
"primary": { "$value": "{color.spotlight.gold-800}" }
}
}
} What each brand changes
Spotlight
Spotlight.me is a social discovery app we designed. Its brand is Void Black and Spotlight Gold. Gold is too light for text on a light background, so the light theme uses a darker gold (4.9:1 on Linen) for links and buttons, with white labels. Headings and body text are Inter, as on the Spotlight screens.
| Token | Light | Dark |
|---|---|---|
color.surface.page | #F7F5F0 | #0E0E10 |
color.surface.raised | #FFFFFF | #18181C |
color.surface.callout | #FCF5DD | #FCF5DD |
color.text.primary | #0E0E10 | #F0EDE6 |
color.text.secondary | #4A4852 | #A8A5AF |
color.text.on-callout | #0E0E10 | #0E0E10 |
color.action.primary | #8A6406 | #F5C842 |
color.action.on-primary | #FFFFFF | #0E0E10 |
color.border.subtle | rgba(14,14,16,0.12) | rgba(240,237,230,0.12) |
color.border.callout | #8A6406 | #8A6406 |
color.feedback.error | #C13D0A | #FF7A3D |
color.status.open | #1D9E75 | #1D9E75 |
color.focus.ring | #8A6406 | #F5C842 |
color.inverse.page | #0E0E10 | #F7F5F0 |
color.inverse.raised | #18181C | #FFFFFF |
color.inverse.text | #F0EDE6 | #0E0E10 |
color.inverse.text-secondary | #A8A5AF | #4A4852 |
color.inverse.border | rgba(240,237,230,0.12) | rgba(14,14,16,0.12) |
color.inverse.accent | #F5C842 | #8A6406 |
color.print.rule | #A8A5AF | #A8A5AF |
font.heading | Inter, system-ui, 'Segoe UI', Arial, sans-serif | Inter, system-ui, 'Segoe UI', Arial, sans-serif |
font.body | Inter, system-ui, 'Segoe UI', Arial, sans-serif | Inter, system-ui, 'Segoe UI', Arial, sans-serif |
font.mono | 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace | 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace |
typography.heading-tracking | -0.02em | -0.02em |
color.action.hover | #8A6406 | #F5C842 |
color.border.field | rgba(14,14,16,0.12) | rgba(240,237,230,0.12) |
color.code.surface | #FFFFFF | #18181C |
color.code.text | #0E0E10 | #F0EDE6 |
color.code.border | rgba(14,14,16,0.12) | rgba(240,237,230,0.12) |
color.print.text | #0E0E10 | #F0EDE6 |
color.print.text-secondary | #4A4852 | #A8A5AF |
color.print.accent | #8A6406 | #F5C842 |
color.tag.text | #0E0E10 | #F0EDE6 |
color.highlight.icon | #8A6406 | #F5C842 |
color.chat.button | #8A6406 | #F5C842 |
color.chat.icon | #FFFFFF | #0E0E10 |
color.chat.ring | #F7F5F0 | #0E0E10 |
Gulo
gulo.com is our outdoor survival brand, launching with its own online store. The theme follows the Gulo style guide: on dark pages buttons are Amber Fang with black labels (5.2:1) and turn Claw Gold on hover. Amber is only 3:1 on Bone White, so light pages use Ember for actions (5.9:1) and keep Amber for label stripes and prices. Secondary text is Stone on dark and Slate on light. Headings are Barlow Condensed and body text Barlow, both open-licensed; headings and buttons are in capitals, and corners are squarer (4 px cards, 3 px buttons and fields).
| Token | Light | Dark |
|---|---|---|
color.surface.page | #EFEFED | #1A1714 |
color.surface.raised | #FFFFFF | #23201C |
color.surface.callout | #F6ECD9 | #F6ECD9 |
color.text.primary | #1A1714 | #EFEFED |
color.text.secondary | #5F5E5A | #BDB9B2 |
color.text.on-callout | #1A1714 | #1A1714 |
color.action.primary | #854F0B | #B4812A |
color.action.on-primary | #FFFFFF | #1A1714 |
color.border.subtle | rgba(26,23,20,0.14) | rgba(239,239,237,0.12) |
color.border.callout | #854F0B | #854F0B |
color.focus.ring | #854F0B | #CF9A3A |
color.inverse.page | #1A1714 | #EFEFED |
color.inverse.raised | #23201C | #FFFFFF |
color.inverse.text | #EFEFED | #1A1714 |
color.inverse.text-secondary | #BDB9B2 | #5F5E5A |
color.inverse.border | rgba(239,239,237,0.12) | rgba(26,23,20,0.14) |
color.inverse.accent | #B4812A | #854F0B |
color.print.rule | #BDB9B2 | #BDB9B2 |
font.heading | 'Barlow Condensed', 'Arial Narrow', sans-serif | 'Barlow Condensed', 'Arial Narrow', sans-serif |
font.body | Barlow, Arial, sans-serif | Barlow, Arial, sans-serif |
font.mono | 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace | 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace |
shape.card | 4px | 4px |
shape.control | 3px | 3px |
shape.field | 3px | 3px |
typography.heading-case | uppercase | uppercase |
typography.heading-tracking | 0.02em | 0.02em |
typography.button-case | uppercase | uppercase |
typography.button-tracking | 0.06em | 0.06em |
color.action.hover | #854F0B | #CF9A3A |
color.border.field | rgba(26,23,20,0.14) | rgba(239,239,237,0.12) |
color.code.surface | #FFFFFF | #23201C |
color.code.text | #1A1714 | #EFEFED |
color.code.border | rgba(26,23,20,0.14) | rgba(239,239,237,0.12) |
color.print.text | #1A1714 | #EFEFED |
color.print.text-secondary | #5F5E5A | #BDB9B2 |
color.print.accent | #854F0B | #B4812A |
color.tag.text | #1A1714 | #EFEFED |
color.highlight.icon | #854F0B | #B4812A |
color.chat.button | #854F0B | #B4812A |
color.chat.icon | #FFFFFF | #1A1714 |
color.chat.ring | #EFEFED | #1A1714 |
Neutral
Neutral is no brand at all: greys and the device's own fonts. It shows the structure of a system without a brand in the way, which is how we start a client's system before their brand arrives.
| Token | Light | Dark |
|---|---|---|
color.surface.page | #F4F4F4 | #121212 |
color.surface.raised | #FFFFFF | #1E1E1E |
color.surface.callout | #EDEDED | #EDEDED |
color.text.primary | #171717 | #EDEDED |
color.text.secondary | #595959 | #A3A3A3 |
color.text.on-callout | #171717 | #171717 |
color.action.primary | #262626 | #EDEDED |
color.action.on-primary | #FFFFFF | #121212 |
color.border.subtle | rgba(0,0,0,0.12) | rgba(255,255,255,0.12) |
color.border.callout | #262626 | #262626 |
color.focus.ring | #262626 | #EDEDED |
color.inverse.page | #121212 | #F4F4F4 |
color.inverse.raised | #1E1E1E | #FFFFFF |
color.inverse.text | #EDEDED | #171717 |
color.inverse.text-secondary | #A3A3A3 | #595959 |
color.inverse.border | rgba(255,255,255,0.12) | rgba(0,0,0,0.12) |
color.inverse.accent | #EDEDED | #262626 |
color.print.rule | #A3A3A3 | #A3A3A3 |
font.heading | system-ui, -apple-system, 'Segoe UI', Roboto, Arial, sans-serif | system-ui, -apple-system, 'Segoe UI', Roboto, Arial, sans-serif |
font.body | system-ui, -apple-system, 'Segoe UI', Roboto, Arial, sans-serif | system-ui, -apple-system, 'Segoe UI', Roboto, Arial, sans-serif |
font.mono | ui-monospace, SFMono-Regular, Menlo, Consolas, monospace | ui-monospace, SFMono-Regular, Menlo, Consolas, monospace |
color.action.hover | #262626 | #EDEDED |
color.border.field | rgba(0,0,0,0.12) | rgba(255,255,255,0.12) |
color.code.surface | #FFFFFF | #1E1E1E |
color.code.text | #171717 | #EDEDED |
color.code.border | rgba(0,0,0,0.12) | rgba(255,255,255,0.12) |
color.print.text | #171717 | #EDEDED |
color.print.text-secondary | #595959 | #A3A3A3 |
color.print.accent | #262626 | #EDEDED |
color.tag.text | #171717 | #EDEDED |
color.highlight.icon | #262626 | #EDEDED |
color.chat.button | #262626 | #EDEDED |
color.chat.icon | #FFFFFF | #121212 |
color.chat.ring | #F4F4F4 | #121212 |
Anything a brand doesn't list falls back to Media Dreams' values, such as the callout and status colours. Want to try your own? Use the theme builder.