How Lanework picked its colour palettes
Every board, lane and card in Lanework can carry a colour, and the colours come from two palettes: sixteen icon tints and sixteen backgrounds. This is how those palettes were put together, what a review of them turned up, and what I decided afterwards.
Colours have names
A board stores a colour as a name, like fern or smokey-ocean, in the plain Markdown frontmatter of the file that uses it. A hand-written #RRGGBB is still legal. A name Lanework doesn’t know falls back quietly instead of raising an error.
The two palettes are the foregrounds, which tint an icon (icon.color), and the backgrounds, which fill a card or band (background.color).
Two rosters, paired hue for hue
Each roster is four neutrals plus a twelve-stop hue ring. The light tint ring and the deep background ring name the same hues in the same order, so a card can carry a fern icon on a smokey-fern background and the two belong together. Each pair below shows the foreground on the left, the background on the right, and the hue angle of each in degrees.
The neutrals are the exception: soapstone exists only as a foreground, and shale only as a background.
Filling the holes, not picking by taste
On 2026-08-09 the set grew from 12 foregrounds and 12 backgrounds to 16 and 16. The four new stops went into the four widest gaps in the hue ring: yellow-green at 64°, jade at 158°, indigo at 238° and magenta at 312°. Saturation and brightness for each came from the existing statistics of its table, so the new stops sit inside the family instead of standing out from it.
On the axis below, foregrounds sit above the line and backgrounds below, with dot size growing with saturation. The four stops added in August are outlined.
Yours to override
Since 2026-09-01 a machine’s config can redefine any of these names or add new ones, under config.foreground-colors and config.background-colors. The palettes are a starting point, not a cage.
What a review found
Before the design sittings, I laid both palettes out on real board plates, one light and one dark, with each foreground tinting a card’s icon and the paired background drawn as its stripe. The numbers are contrast ratios of each foreground against the card behind it. 3:1 is the WCAG minimum for icons and large text, and anything under it is marked low.
The rings had been set by statistics in August, never reviewed on the raised cards of the board. What the plates show:
- On the white card, 6 of the 12 coloured foregrounds fall under 3:1: rich-grapefruit, smokey-tangerine, rich-lime, fern, light-jade and light-teal, at 2.2 to 2.7.
- On the dark card (
#2A2A2F), nearly all pass. Only pale-violet and deep-cool-granite fall under 3:1, at about 2.9. - All 12 coloured backgrounds hold white text at 5.7:1 or better, shown below. None of them had a variant for light appearance.
What the sittings decided
The review went to two design sittings on 2026-10-01. The first ruled on the foregrounds:
- Keep the twelve hues and tune lightness only. Every colour name already on disk stays valid.
- A light value and a dark value per name, instead of one hex for both appearances.
- The eleven tints, no greys, in every picker.
- Foreground values approved as drawn. Hue and chroma held fixed in OKLCH, with lightness solved for each name: 3.4:1 on the white card in light appearance and 5.0:1 on the dark card in dark, for all twelve. Before, they spanned 2.2 to 4.9 on white and 2.9 to 6.6 on dark.
The second sitting went further on the backgrounds, and overturned part of the first:
- One master list of named colours. Every entry has a base, a light and a dark value. The base is what the variants are tuned from. A picker palette is a selection of names from the list.
- A name resolves by appearance. The light variant in light, the dark variant in dark. A
#RRGGBBis literal and draws as written in both. - A soft background roster replaces the deep one. Light is the base lightness minus 0.07. Dark is the base lightness minus 0.05 with chroma scaled by 0.92, in OKLCH.
- Lane bands draw the background name’s variant directly. Softening a colour on the fly at draw time was retracted: it creates more problems than it solves, and it is reversible if it turns out wrong.
- Obsidian and chalk leave the pickers and stay in the master list. Straw and mint are new.
- Backgrounds are renamed as a clean break before release. The old names stay as retired names that carry their successor’s values, in no picker.
- Pickers write names, never a hex, except for an arbitrary colour from the system panel, which is stamped as it is. A picker can never write a retired name.
- Aluminum was the same
#9B9B9Bas a foreground and a background, so it is now one entry in the master list and out of the background picker. The soft grey isfog.
These are design decisions. The colours themselves reach the app as separate work.