Project /2025
Flatcap
A visual system for long hours at a screen, in two modes, and its adaptations to the tools I use every day.
Render
What it is
Flatcap started in 2025 as a dark editor theme. Version 2.0 is a semantic system, “quiet precision”: matte graphite surfaces, a single mineral blue for interaction, and color only when it informs. It has two separately tuned modes, Slate (dark) and Daylight (light), with 43 color roles in each, IBM Plex and Cascadia typography, and rules for contrast, focus, density and motion. Every adaptation is generated from one tokens file.
Version 1 was inspired by the Nord theme, which is no longer part of the palette. The FreshRSS style builds on the structure of that reader’s Nord theme. The Stylus styles start from community work, credited to their authors in the repository.
What it does
- Two modes, Slate and Daylight, with 43 color roles each. Daylight is not an inverted Slate: its values were tuned separately.
- Colors named by purpose (surfaces, text, interaction, feedback, syntax and data) and typography by role: IBM Plex Sans for the interface and Cascadia Code for code.
- Contrast targets of 7:1, 5:1 and 3:1 checked by script across 372 color pairs, with increased contrast and reduced motion accounted for.
- Seven adaptations generated from a single tokens file: VS Code, Obsidian, Windows Terminal, Firefox, FreshRSS, Stylus (Gemini, Gmail, Instagram and Reddit) and the OpenClaw interface.
- Published on the VS Code Marketplace, the Obsidian theme directory, Firefox Add-ons and ClawHub; the rest live in open repositories.
The palette
Slate · surfaces
- #191d22
- #20252b
- #292f36
- #323a43
- #263e53
Daylight · surfaces
- #f3f5f7
- #fafbfc
- #ffffff
- #e6ebf0
- #dce9f4
Slate · accent and feedback
- #9bbfdf
- #9fc3ad
- #d8bc87
- #e2a0a5
Daylight · accent and feedback
- #285d85
- #32664d
- #765319
- #a43f4a
What I did
- Redesigned the system for 2.0: replaced version 1’s numbered palette with semantic roles and added the light mode.
- Built a Python generator that produces each adaptation from a single tokens file, and a check that fails when a color stops meeting its contrast target.
- Migrated the seven adaptations to 2.0. Each one documents how roles map, its limits, and what was tested and what wasn’t.
- Documented the system: principles, palette, typography, motion and accessibility, with an interactive example and a portable guide for agents.
- I maintain it in open repositories and keep refining it as I use it.
Images
-
Illustrative recreation with fictional data: the system in Slate and Daylight.
-
VS Code, Slate.
-
VS Code, Daylight.
-
Obsidian, Slate.
-
Obsidian, Daylight.
-
Windows Terminal, Slate.
-
Windows Terminal, Daylight.
-
Firefox, Slate.
-
Firefox, Daylight.
-
FreshRSS, Slate.
-
FreshRSS, Daylight.
-
OpenClaw, Slate.
-
OpenClaw, Daylight.
-
Stylus on Reddit, Daylight.
-
Stylus on Gmail, Slate.