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
- Check that nothing existing already does the job, or could with a small change.
- 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.
- Agree the name and the tier: primitive, semantic, component or pattern.
- Build it with tokens only, in light and dark, with keyboard and screen reader behaviour.
- Document it here with a live example, rules, and do's and don'ts.
- 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.