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

The colour rule on real numbers, from AI made the product cheap. Not the company.. Grey is the baseline. Amber is the point.

Seven rules

  1. 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. 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. 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. 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. 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. 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. 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

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

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.

PropertyPaletteSo this site uses
argonlabs.techDeep blue-black, pale violetNo blue, no violet
lineupfinder.comDeep blue, many neon coloursNo neon, no more than one colour
CHROMAVECTPure black, an electric blue ring, chromeNo electric blue
jakewang.ioGraphite 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

  1. Is this colour going on something other than the point? Then take it off.
  2. Is this dark area pure black? Then make it graphite.
  3. Does this row of things all look the same? Then let the numbers pick the form.
  4. 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.