enjoy
Personal computing as a warm hobby. Every element is a window or a desk object - a 2px ink outline, a surface fill and a hard offset shadow - sitting on a sunny desk under big lazy waves. One mono face does all the talking.
Two things to hold on to. Depth is a hard offset, never a blur:
3px for a window, 2px for a control, and pressing a control takes its
shadow away. And there is exactly one saturated field per screen
- --feature - so everything else stays soft enough for
that one pane to be heard.
Read this first
- These values are the system. Every number on this page exists in
css/enjoy-core.css. Use the tokens; do not invent parallel ones. - Search for an existing part before building a second one. Almost everything is a window, a button, a meter or a row.
- No ad-hoc values. No raw hex, no one-off sizes, no new easing curve. Every outline is
--line, every shadow is one of the three offsets. - Token names are roles.
--tintis the soft fill, not "the aqua"; in the dark theme it is a deep teal and the name is still true. --featureappears once per screen. It is a content pane, never chrome, a button or an accent.--liveis a dot, never a fill or a text colour.- No blur, no gradient, no second typeface. These three refusals are the system.
Colour
Nine paints. Each chip shows the sunny desk on the left and the same desk after dark on the right, so both themes are on screen at once. The dark theme is hand-authored: a lamp-lit brown desk, cream ink, and the soft fills pulled down until cream text sits on them comfortably.
derived inks and shadows
| token | light | dark | job |
|---|---|---|---|
| --ink-dim | ink at 0.72 | ink at 0.72 | Secondary text, ledes, state tags. |
| --ink-off | ink at 0.5 | ink at 0.5 | Disabled labels only, always with a dashed outline beside it. |
| --ink-faint | ink at 0.35 | ink at 0.35 | Progress rails and the dotted rules between table rows. |
| --shadow-win | 3px 3px 0 rgba(34,32,28,.9) | 3px 3px 0 rgba(11,10,8,.9) | Window depth. |
| --shadow-ctl | 2px 2px 0 --shadow-ink | same | Control depth: buttons, chips, toggles, chips of paint. |
| --shadow-lift | 3px 3px 0 --shadow-ink | same | A hovered control, lifted one pixel. |
contrast floor
| pair | light | dark | rule |
|---|---|---|---|
| --ink on --ground | 13.8:1 | 13.2:1 | Body text anywhere on the desk. |
| --ink on --surface | 15.1:1 | 11.7:1 | Body text inside a window. |
| --ink-dim on --surface | 6.2:1 | 6.8:1 | Secondary text clears AA at every size. |
| --ink on --tint / --tint-2 | 11.5 / 10.9:1 | 6.3 / 6.4:1 | Text on an active row, a meter or a note. |
| --on-feature on --feature | 4.1:1 | 5.5:1 | Large text only. Nothing on the feature field is set below 24px. |
Typography
One face: ui-monospace, "SF Mono", Menlo, Consolas, monospace
- the platform's own mono, so nothing is downloaded. Seven sizes, no
second family, no all-caps. lowercase for actions, Title Case for
things.
scale
| token | size | leading | where |
|---|---|---|---|
| --fs-readout | clamp(38px, 5vw, 52px) | 1.1 | The desk numeral, and the page's one h1. |
| --fs-display | 28px | 1.6 | Feature-pane lines (floored at 24px) and section headings. |
| --fs-display-s | 22px | 1.3 | A secondary display line inside a window. |
| --fs-ui | 14px | 1.55 | Emphasised body, ledes, the primary line of an info card. |
| --fs-body | 13px | 1.55 | The default: body, buttons, rows, fields. |
| --fs-title | 12px | 1.55 | Window titles, menu words, icon labels, tooltips. |
| --fs-label | 11px | 1.55 | Meter labels, state tags, table headers. Tracked +0.06-0.08em. |
Space and layout
Eight spacing steps, one desk measure, three breakpoints. Windows get 16px of padding inside and 34px of desk between them - the desk is always allowed to show.
| token | value | bar | typical job |
|---|---|---|---|
| --sp-1 | 4px | Chip padding, tray actions. | |
| --sp-2 | 6px | Traffic dots, icon to label. | |
| --sp-3 | 8px | Inside a button, specimen to its tag. | |
| --sp-4 | 10px | Row padding, glyph to text. | |
| --sp-5 | 14px | Button sides, menu bar gaps. | |
| --sp-6 | 16px | Window body padding. | |
| --sp-7 | 22px | Between windows in one group. | |
| --sp-8 | 34px | Between windows on the desk. |
measure and breakpoints
| name | value | what happens |
|---|---|---|
| --measure | 1140px | The desk stops widening. Past this, windows just get more wallpaper around them. |
| --prose | 62ch | Running text never runs wider. |
| 1020px | max-width | Side-by-side groups stack; desktop icons move from a column to a row. |
| 760px | max-width | Split windows stack their side list above the pane; the menu bar drops its wordmark. |
| 420px | max-width | Window padding tightens to 12px. |
Form
Three moves give every object its silhouette: one 2px ink outline, a friendly radius, and a hard offset shadow. Nothing else - no hairlines, no second border weight, no blur.
radii
| --r-win | 10px | Windows, the screen stage. | |
| --r-ctl | 8px | Buttons, fields, the menu bar, notes. | |
| --r-knob | 6px | The toggle knob, tooltips, icon labels. | |
| --r-pill | 999px | Chips, meter tracks, the toggle track. |
depth
Motion
Cozy and tiny. Controls lift and sink in 80ms, the readout's colon ticks
once a second, and that is all. Only transform,
box-shadow, opacity and a fill colour are
allowed to move.
10:24
the tick, 1s steps| token | value | where |
|---|---|---|
| --t-press | 80ms | Button lift and sink, toggle knob, tooltip fade. Seen constantly, so kept almost instant. |
| --ease | ease-out | The only curve. Do not introduce a second. |
| --t-blink | 1s, steps(1, end) | The readout's colon. A step, not a fade - clocks tick. |
| hover | translate(-1px, -1px) | Plus --shadow-lift. The largest displacement a control ever makes upward. |
| press | translate(2px, 2px) | Shadow removed. The control lands on its own shadow. |
Screen
One optional surface treatment: the wallpaper tide. The desk's wave wallpaper comes alive - two lazy waves drift, the front one wears the system's ink outline, and an outlined buoy rides it. Move across the right-hand stage: the tide leans toward the pointer and the buoy follows along the crest.
uniforms - js/tide.js
| uniform | value | what it does |
|---|---|---|
| uDrift | 0.12 | Wave speed. Slow enough that the tide reads as wallpaper, not weather. |
| uSwell | 0.6 | How far the crest leans toward the pointer's height. The back wave leans half as far. |
| uReach | 0.18 | Width of the lean, in stage widths. A hand under the water, not a spike. |
| uBuoy | 14px | Buoy radius. It floats at 70% across at rest and follows the pointer when engaged. |
| uLine | 2px | The outline weight, matching --line. The front wave and the buoy wear it. |
| uShadow | 3px | The buoy's hard offset, matching --shadow-win. The waves cast none - they are wallpaper. |
| uGround, uTint, uTint2, uInk, uShade | tokens | Read from --ground, --tint, --tint-2, --ink, --shadow-ink at runtime, and re-read on every theme change. |
| spring | k 40 / d 7 | The pointer is followed on a spring, softer than a control's, so the tide has weight and settles. |
Where it belongs: an empty frame, a hero behind a readout, a screen with nothing in it yet. Not behind body text, and never on the same screen as a feature pane - the tide is soft on purpose, and the feature field should not have to compete with moving water.
Components
Every state here is live markup. Hover lifts a control 1px and grows its shadow; press sinks it flat onto the desk; disabled goes dashed at half ink; focus is a 2px ink ring. Tab through them.
button
chip and icon button
field
toggle and tooltip
pill meter
side list
transport
tray item and info card
desktop icon
Motifs
What makes the desk recognisable at a glance - not the palette. Each motif keeps the same three moves: 2px ink, surface fill, hard offset.
window - the master container
- Frame: 2px ink,
--r-win, surface fill. - Traffic dots: three outlined circles, left.
- Title: 12px path voice, centred.
- A 2px rule between bar and body.
- Shadow: 3px 3px 0, zero blur.
wave wallpaper - behind everything
readout and menu bar
10:24
a quiet second line
desktop icons - hand-drawn line glyphs, 2.5 stroke
Composition
The parts assembled into one specimen desk: a small window of readout and meters, and one inverse-chrome split window that spends the screen's single feature field. The copy is about the desk itself, so what a reader takes away is the arrangement.
10:24
a quiet second line
A small window
Windows sit on a warm desk
Edges are two pixels of ink
One field is allowed to shout
The rest keeps its voice down
anatomy
| part | as built | why it is that |
|---|---|---|
| Desk gap | --sp-7 / --sp-8 | Windows never touch. The desk showing between them is what makes each one an object. |
| Small windows | .window | Readout, meters and a tray item stacked in one frame; a field and two buttons in another. Grouping is by window, not by whitespace. |
| Inverse chrome | .window--inverse | The frame takes the ink. It is how the feature pane is announced, so it appears at most once per screen. |
| Side list | .split-side | On the surface, not the feature. Navigation stays calm so the pane beside it can be loud. |
| Feature pane | --feature, 24px floor | The one saturated field. The current line is marked with a > and full opacity, never with a second colour on the field. |
| Foot bar | .split-foot | Controls go back on the surface. Buttons never sit on the feature field. |
| Live dot | --live, 8px | The only red on the desk. One dot, pushed to the row's end. |
Rules
The refusals matter more than the permissions.
- Put every group in a window, with a title that names it.
- Keep every outline at
--line(2px) in ink. - Keep every shadow a hard offset: 3px for windows, 2px for controls, gone on press.
- Spend
--featureonce per screen, on a content pane, with type at 24px or more. - Use lowercase for actions and Title Case for things.
- Check both themes with the menu bar toggle. Dark is hand-authored, not derived.
- Add a blurred shadow. Ever.
- Add a gradient. Flat fills only - the shader included.
- Add a hairline or a second border weight.
- Add a second typeface, or set anything in all-caps.
- Use
--featurefor chrome, buttons or accents, or put small text on it. - Use
--liveas a fill or a text colour. It is a dot. - Run the tide behind body text or beside a feature pane.