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
| Page | Where it comes from |
|---|---|
| Overview | The 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, Components | Made by Somnia DS from the brand's tokens. Change a token and these pages change with the site. |
| Logo, Tone of voice, Imagery | Written 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 own | Built 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
// 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.' },
],
},