Preview brand Custom

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.

One system, many brands

Same markup. Different tokens.

Start a project

One system, many brands

Same markup. Different tokens.

Start a project
Media Dreams
Show code
html
<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>

One system, many brands

Same markup. Different tokens.

Start a project

One system, many brands

Same markup. Different tokens.

Start a project
Spotlight

One system, many brands

Same markup. Different tokens.

Start a project

One system, many brands

Same markup. Different tokens.

Start a project
Gulo

One system, many brands

Same markup. Different tokens.

Start a project

One system, many brands

Same markup. Different tokens.

Start a project
Neutral

How it works

  1. Components only use semantic tokens: action.primary, never ember-600.
  2. A theme file gives every semantic token a value. Light and dark are two theme files with identical names.
  3. A brand adds two more files that override some of those names. Anything a brand doesn't override falls back to Somnia DS.
  4. An attribute switches them: data-theme="dark" or data-brand="gulo", on the whole page or on any element.
  5. Brands can change typefaces too, through the font.heading, font.body and font.mono tokens. The Media Dreams logo never changes: it uses the primitives directly.
json
// 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.

TokenLightDark
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.subtlergba(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.borderrgba(240,237,230,0.12)rgba(14,14,16,0.12)
color.inverse.accent#F5C842#8A6406
color.print.rule#A8A5AF#A8A5AF
font.headingInter, system-ui, 'Segoe UI', Arial, sans-serifInter, system-ui, 'Segoe UI', Arial, sans-serif
font.bodyInter, system-ui, 'Segoe UI', Arial, sans-serifInter, 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.fieldrgba(14,14,16,0.12)rgba(240,237,230,0.12)
color.code.surface#FFFFFF#18181C
color.code.text#0E0E10#F0EDE6
color.code.borderrgba(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).

TokenLightDark
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.subtlergba(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.borderrgba(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.bodyBarlow, Arial, sans-serifBarlow, Arial, sans-serif
font.mono'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace
shape.card4px4px
shape.control3px3px
shape.field3px3px
typography.heading-caseuppercaseuppercase
typography.heading-tracking0.02em0.02em
typography.button-caseuppercaseuppercase
typography.button-tracking0.06em0.06em
color.action.hover#854F0B#CF9A3A
color.border.fieldrgba(26,23,20,0.14)rgba(239,239,237,0.12)
color.code.surface#FFFFFF#23201C
color.code.text#1A1714#EFEFED
color.code.borderrgba(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.

TokenLightDark
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.subtlergba(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.borderrgba(255,255,255,0.12)rgba(0,0,0,0.12)
color.inverse.accent#EDEDED#262626
color.print.rule#A3A3A3#A3A3A3
font.headingsystem-ui, -apple-system, 'Segoe UI', Roboto, Arial, sans-serifsystem-ui, -apple-system, 'Segoe UI', Roboto, Arial, sans-serif
font.bodysystem-ui, -apple-system, 'Segoe UI', Roboto, Arial, sans-serifsystem-ui, -apple-system, 'Segoe UI', Roboto, Arial, sans-serif
font.monoui-monospace, SFMono-Regular, Menlo, Consolas, monospaceui-monospace, SFMono-Regular, Menlo, Consolas, monospace
color.action.hover#262626#EDEDED
color.border.fieldrgba(0,0,0,0.12)rgba(255,255,255,0.12)
color.code.surface#FFFFFF#1E1E1E
color.code.text#171717#EDEDED
color.code.borderrgba(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.