Contributing

For the people who build with Somnia DS: our own team, the specialists in our network, and client teams working from a copy of it. Changes start with a real page that needs them.

Who this is for

Somnia DS is Media Dreams' own system, so most changes come from us. When a specialist joins a project, or a client takes Somnia DS as the starting point for their own system, this is how a new component or a change gets proposed, so the system stays consistent rather than collecting one-off fixes.

From idea to release

  1. Check that nothing existing already does the job, or could with a small change.
  2. Propose it as an issue in the repository (or an email to hello@mediadreams.co.uk): the problem, where it shows up, and a sketch.
  3. Agree the name and the tier: primitive, semantic, component or pattern.
  4. Build it with tokens only, in light and dark, with keyboard and screen reader behaviour.
  5. Document it here with a live example, rules, and do's and don'ts.
  6. Release it with a changelog entry and the right version bump.

What makes a good addition

  • It's needed in at least two places, or it's the one right way to do something risky.
  • It passes contrast in every theme and brand.
  • It has a plain name that says what it's for.
  • It doesn't add a second way to do something Somnia DS already does.