Preview brand Custom

A brand’s guidelines

Every brand on Somnia DS can have a guide of its own: how it looks, how it sounds, and the files people ask for. Most of it is made from the brand's tokens, so it cannot fall out of step with the site.

What is in one

PageWhere it comes from
OverviewThe key colours, the typefaces, the list of pages and the downloads, read from the site's settings, tokens and brand files.
Colour, Typography, Spacing and shape, ComponentsMade by Somnia DS from the brand's tokens. Change a token and these pages change with the site.
Logo, Tone of voice, ImageryWritten for the brand, as text files in the site's src/content/brand/. The logo page shows the logo itself in light and dark.
Pages of the brand's ownBuilt by the site, for guidance that needs live examples, such as a logo animation. Listed under brandGuide.pages.

Downloads

  • Design tokens as JSON and as CSS: every colour, font and size, light and dark.
  • The logo as SVG and as a PNG 2,400 pixels wide, with a light-on-dark version, when the brand keeps its logo as a file (src/brand/logo.svg, logo-dark.svg).
  • The icons and the share image the site already has: the browser tab icon, the 512 pixel app icon, and the picture a link shows on social media.

Who can see it

By default a guide is unlisted: search engines are asked not to index it and the site's own search leaves it out. It is for sharing by link, with a printer, a partner or a new member of staff. Set listed: true to make it public, as Media Dreams does.

A new brand's first guide

A new site starts with templates for the logo, voice and imagery pages, each marked as not yet written. The build warns about each one until it is written for the brand and the mark removed, so a template is hard to leave in place by accident.

An example

Media Dreams' brand guidelines are made this way. Four of its pages come from Media Dreams' tokens; the rest (story, logo, icons, tone of voice, imagery, logo animation, video, templates) are pages of its own.

Turning it on

js
// somnia.config.mjs
features: { brandGuide: true },
brandGuide: {
  label: 'Brand guidelines', // the guide's name, in its menu and titles
  listed: false,             // true: public and in search; false: shared by link only
  pages: [                   // optional: pages the site builds itself, for live examples
    { slug: 'logo-animation', label: 'Logo animation', blurb: 'The intro, the loader and the sting.' },
  ],
},