How this site is designed
The page is treated as an instrument: a graphite panel, a chrome nameplate, and amber readouts.
I have spent eight years on software that watches other software, and I write about making AI agents observable, reversible and accountable. An instrument does that job. It does not talk. It gives a reading.
The two other things I care about how they look end up in the same place. I like liquid metal, and I make music as CHROMAVECT. Both are a device with a metal case and an amber display.
24,933GitHub stars on Dolt, DoltHub’s main database
179on Argon, my project
Seven rules
- 1
A reading comes before an adjective.
Every post has two numbers, and they are drawn, not written. If something can be drawn it is not described.
- 2
One colour of its own, spent only on the point.
Amber marks the one thing a figure wants you to look at: that bar, that square, that line. The baseline is grey. Text is always ink and never tinted.
- 3
Metal, not a black hole.
Surfaces are graphite grey. A dark panel carries a slight gradient, like a sheet of metal. Pure black is left to the work shown here.
- 4
The work brings its own colour.
Projects appear as screenshots of their own home pages in one shared window frame, with their own marks. The page stays quiet and gives the colour to them.
- 5
Things that sit side by side each get their own shape.
Three cards never use the same kind of figure. The numbers decide the form: bars for a change, areas for a before and after, a line through gates for something that got past, squares for a share.
- 6
Move once, then stop.
A figure draws itself the first time it appears and then holds still. Nothing loops. Two things answer the pointer and are still otherwise: the metal of the name, and the readout under the open-source list.
- 7
The site reports on itself.
The footer names the build and what this page cost to load, as your browser measured it. The changelog lists every change.
Colour
Page
#efefedlight /#17181adarkThe ground
Raised surface
#e3e3e0light /#202124darkWindow frames, table heads
Ink
#101113light /#ededebdarkAll text
Secondary text
#5a5b5elight /#a4a5a8darkLabels, captions
Baseline grey
#55565alight /#717276darkThe baseline in a figure
Amber
#c57200light /#f5a11fdarkThe point in a figure, and nothing else
Plate
#2b2d31to#141517, both themesThe top of the home page, and the band of numbers under a post's title
Amber and the baseline grey were checked as a pair on both grounds. They stay apart for readers with colour-vision deficiencies, and each clears a 3:1 contrast against the page. The dark-theme amber is a little brighter than the checker suggested. That is deliberate: it is the only readout colour, not one of several.
Type
- Geist
One bad decision, six missing layers
Headings, body text, numbers and labels. One plain sans for everything a person reads.
- Syne
Jake Wang
A wide face, for the name only. It is the logo.
- Geist Mono
git revert --no-edit HEAD
Code, and nothing else.
Why not another colour
I run three other things, each with a palette. Put this site next to any of them and you should tell them apart in three seconds.
| Property | Palette | So this site uses |
|---|---|---|
| argonlabs.tech | Deep blue-black, pale violet | No blue, no violet |
| lineupfinder.com | Deep blue, many neon colours | No neon, no more than one colour |
| CHROMAVECT | Pure black, an electric blue ring, chrome | No electric blue |
| jakewang.io | Graphite grey, chrome, amber |
Two directions were tried and dropped. The first was pure black and white. It separated the site from Argon, but it was too dark and too cold, and the charts had no colour. The second took a ginger from my cat's fur. Sampled from the photograph it came out as a terracotta, #a0674a, which is close to the default accent on a lot of AI-generated pages. Amber is yellower and brighter.
The dark surfaces follow the Material Design guidance on dark themes: a dark grey shows depth and is easier on the eyes under light text than pure black, and the accent covers only a small part of the screen. The graphite here is one step lighter than Material's, because the page also has to carry photographs and screenshots.
Four questions before any change
- Is this colour going on something other than the point? Then take it off.
- Is this dark area pure black? Then make it graphite.
- Does this row of things all look the same? Then let the numbers pick the form.
- Next to argonlabs.tech, can you tell the two apart in three seconds?
Credits
The liquid metal on the name is drawn with Paper Shaders, used under the Apache 2.0 licence. Where WebGL is not available, the name is set in plain CSS.