Skip to content
All articles
2 min readDesignCraft

Why we designed the dark theme first

Our dark theme is the primary design, and the light theme is a second design in its own right. Building both on purpose costs more than inverting a palette, and the difference is visible.

Most software treats dark mode as a filter: take the light design, flip the values, ship it. We went the other way. This site's dark theme is the designed experience — warm near-black, amber light, the atelier at night — and the light theme is its own separate design, tuned by hand until it earned the switch.

An inversion is not a design

Inverting a palette preserves the arithmetic and loses the character. An amber that glows against near-black turns to glare on white. Shadows that read as depth in the dark read as dirt in daylight. Chroma that feels rich on an ember ground feels garish on paper. Every color relationship you tuned carefully in one theme arrives in the other theme subtly wrong.

So our light theme is a recalibration rather than a reflection: warm paper instead of clinical white, the same amber family deepened until it holds its weight as text, borders and surfaces re-balanced for an environment where elevation means something different.

The discipline of two palettes

  • Every token exists twice. Each color is hand-tuned per theme, so a change to one is never automatically safe in the other.
  • Contrast is tuned, not assumed. Text sits deliberately clear of accessibility thresholds in both themes. Strengthening a color means darkening it in light and brightening it in dark; a blanket adjustment helps one theme by harming the other.
  • Every state is checked in both lights. A hover that lifts a card in the dark can gray it out in the light. Nothing ships checked in only one theme.
A theme is a promise that someone looked at every screen in that light.

The cost is straightforward: double the tuning, double the checking, and a standing rule that no palette change is trivial. We pay it because the alternative is shipping half our audience an afterthought. We default to dark because that is where this brand lives — but if you prefer to read in the light, you get a design, and never an apology.

Lightforge Software