Skip to content
Prose on this page is AI-drafted and under revision.
The rules the system holds itself to

Design Principles

How eiDotter thinks.

Behaviour, then look

Two kinds of rule live here. The first is about behaviour โ€” how an interface should treat the person using it. Those rules are universal: they hold whether the screen glows amber or sits clean and white.

The second is about look โ€” and that's a theme, a choice. Today eiDotter wears DOS. The behaviour underneath never changes.

Your attention belongs to you.

How it behaves ยท universal

The nine

  1. Start from the real context

    We design from real people, real data, and real screens โ€” not from assumptions or yesterday's conventions. Then we test it with the people who'll use it, and change what doesn't work.

  2. Immediate, visible feedback

    Every action shows its effect at once. The system never leaves you wondering what just happened โ€” or whether it even heard you.

  3. Make it perceivable

    What you can do is visible. Controls look like what they do; related things sit together; you recognise, you don't have to remember.

  4. The user is never at fault

    Modes are traps, so we remove them. There's always a way out and a way back. When something goes wrong, that's our bug to fix โ€” not your mistake to feel bad about.

  5. Show the data, honestly

    Density over decoration. We show the whole picture and the fine detail in the same view โ€” and never bend the truth to make a chart look tidier.

  6. Less, but better

    Every element earns its place or it's gone. If it needs a manual, it isn't finished. Built to last, not to chase this year's trend.

  7. Aligned with you, never extractive

    We optimise for you finishing your task and getting on with your life โ€” never for time-on-screen. No dark patterns, no manufactured urgency. Your attention belongs to you.

  8. You own your data

    Open, portable, and accessible to everyone โ€” accessibility is a gate, not a feature, so nothing ships that locks people out. No lock-in, ever.

  9. A tool for understanding

    Software should help you understand โ€” your work, your data, your world โ€” not just transact. We build instruments for thought, not prettier databases.

How it's built ยท universal

Design in roles, not raw colour

A button is a primary surface, never #FFB000. We style by semantic role and let the theme supply the value. That single discipline is what lets the same components wear a different face without rewriting a line โ€” and it's why a re-theme is a swap, not a rebuild.

How it looks ยท per theme

One system, more than one face

Today, eiDotter wears DOS: amber phosphor on near-black, sixteen CGA colours, one type weight, square corners. The look is a constraint we hold ourselves to, not a costume we take off when it's inconvenient โ€” restraint as a feature.

But the nine above aren't about amber. They're about behaviour, and behaviour travels. So a modern, clean theme is on the way: the same discipline, the same accessibility, the same respect for your attention โ€” a different face. Pick the one that fits your audience; the quality underneath doesn't change.

Read on

These principles ship with the design system in guidelines/design-principles.md, and the components that embody them live in the Storybook.