~/enjoy/about.txt

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.

~/enjoy/read-this-first.txt

Read this first

  1. These values are the system. Every number on this page exists in css/enjoy-core.css. Use the tokens; do not invent parallel ones.
  2. Search for an existing part before building a second one. Almost everything is a window, a button, a meter or a row.
  3. 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.
  4. Token names are roles. --tint is the soft fill, not "the aqua"; in the dark theme it is a deep teal and the name is still true.
  5. --feature appears once per screen. It is a content pane, never chrome, a button or an accent. --live is a dot, never a fill or a text colour.
  6. No blur, no gradient, no second typeface. These three refusals are the system.
~/enjoy/01-colour

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.

--groundThe desk. Every window sits on it.#F2ECDC#24211C
--surfaceWindow, panel and control fill.#FAF6EA#2E2A24
--inkEvery outline, glyph and letter.#22201C#F0E8D6
--tintSoft fill: wallpaper, meters, active rows, selection.#BCDFE1#2F5A5D
--tint-2Second soft fill: markers, knobs, notes.#F2CDAA#6E4A31
--featureThe one saturated field. One pane per screen.#2B7BC7#2566A6
--on-featureText on the feature field. Pinned in both themes.#FAF6EA#FAF6EA
--liveTiny live-state dots. Nothing else.#D0472E#EC6A48
--shadow-inkWhat every hard shadow is cut from.#22201C#0B0A08

derived inks and shadows

tokenlightdarkjob
--ink-dimink at 0.72ink at 0.72Secondary text, ledes, state tags.
--ink-offink at 0.5ink at 0.5Disabled labels only, always with a dashed outline beside it.
--ink-faintink at 0.35ink at 0.35Progress rails and the dotted rules between table rows.
--shadow-win3px 3px 0 rgba(34,32,28,.9)3px 3px 0 rgba(11,10,8,.9)Window depth.
--shadow-ctl2px 2px 0 --shadow-inksameControl depth: buttons, chips, toggles, chips of paint.
--shadow-lift3px 3px 0 --shadow-inksameA hovered control, lifted one pixel.

contrast floor

pairlightdarkrule
--ink on --ground13.8:113.2:1Body text anywhere on the desk.
--ink on --surface15.1:111.7:1Body text inside a window.
--ink-dim on --surface6.2:16.8:1Secondary text clears AA at every size.
--ink on --tint / --tint-211.5 / 10.9:16.3 / 6.4:1Text on an active row, a meter or a note.
--on-feature on --feature4.1:15.5:1Large text only. Nothing on the feature field is set below 24px.
~/enjoy/02-type

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.

--fs-readout10:24
--fs-displayOne field is allowed to shout
--fs-display-sA secondary display line
--fs-uiSpecimen Title In Title Case
--fs-bodybody text, buttons and rows - the default voice of the desk.
--fs-title~/any/window - title bar
--fs-labellvl use cap

scale

tokensizeleadingwhere
--fs-readoutclamp(38px, 5vw, 52px)1.1The desk numeral, and the page's one h1.
--fs-display28px1.6Feature-pane lines (floored at 24px) and section headings.
--fs-display-s22px1.3A secondary display line inside a window.
--fs-ui14px1.55Emphasised body, ledes, the primary line of an info card.
--fs-body13px1.55The default: body, buttons, rows, fields.
--fs-title12px1.55Window titles, menu words, icon labels, tooltips.
--fs-label11px1.55Meter labels, state tags, table headers. Tracked +0.06-0.08em.
~/enjoy/03-space

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.

tokenvaluebartypical job
--sp-14px
Chip padding, tray actions.
--sp-26px
Traffic dots, icon to label.
--sp-38px
Inside a button, specimen to its tag.
--sp-410px
Row padding, glyph to text.
--sp-514px
Button sides, menu bar gaps.
--sp-616px
Window body padding.
--sp-722px
Between windows in one group.
--sp-834px
Between windows on the desk.

measure and breakpoints

namevaluewhat happens
--measure1140pxThe desk stops widening. Past this, windows just get more wallpaper around them.
--prose62chRunning text never runs wider.
1020pxmax-widthSide-by-side groups stack; desktop icons move from a column to a row.
760pxmax-widthSplit windows stack their side list above the pane; the menu bar drops its wordmark.
420pxmax-widthWindow padding tightens to 12px.
~/enjoy/04-form

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-win10px
Windows, the screen stage.
--r-ctl8px
Buttons, fields, the menu bar, notes.
--r-knob6px
The toggle knob, tooltips, icon labels.
--r-pill999px
Chips, meter tracks, the toggle track.

depth

--shadow-win: 3px 3px 0
--shadow-lift: hovered control
--shadow-ctl: 2px 2px 0
pressed: no shadow, sunk 2px
disabled: dashed, no shadow
~/enjoy/05-motion

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.

lift and sink, 80ms

10:24

the tick, 1s steps
tokenvaluewhere
--t-press80msButton lift and sink, toggle knob, tooltip fade. Seen constantly, so kept almost instant.
--easeease-outThe only curve. Do not introduce a second.
--t-blink1s, steps(1, end)The readout's colon. A step, not a fade - clocks tick.
hovertranslate(-1px, -1px)Plus --shadow-lift. The largest displacement a control ever makes upward.
presstranslate(2px, 2px)Shadow removed. The control lands on its own shadow.
~/enjoy/06-screen

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.

Static fallback - flat SVG, the same tokens
Live - move the pointer across it

uniforms - js/tide.js

uniformvaluewhat it does
uDrift0.12Wave speed. Slow enough that the tide reads as wallpaper, not weather.
uSwell0.6How far the crest leans toward the pointer's height. The back wave leans half as far.
uReach0.18Width of the lean, in stage widths. A hand under the water, not a spike.
uBuoy14pxBuoy radius. It floats at 70% across at rest and follows the pointer when engaged.
uLine2pxThe outline weight, matching --line. The front wave and the buoy wear it.
uShadow3pxThe buoy's hard offset, matching --shadow-win. The waves cast none - they are wallpaper.
uGround, uTint, uTint2, uInk, uShadetokensRead from --ground, --tint, --tint-2, --ink, --shadow-ink at runtime, and re-read on every theme change.
springk 40 / d 7The 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.

~/enjoy/07-components

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

rest - hover - press
open linklink as button
with glyph
disabled: dashed, --ink-off

chip and icon button

chip: pill button, same states
icon button: 36px round

field

rest - type to focus
disabled: dashed

toggle and tooltip

off - click it
on: --tint track
disabled: dashed
ink bubble, square caret tooltip: hover or focus

pill meter

lvl
use
cap
--tint or --tint-2 fill, 3ch lowercase label

side list

hover: --ground; active: --tint - click a row

transport

1:12 / 3:33
prev / play-pause / next, progress rail with a --tint-2 knob, level

tray item and info card

Specimen title that runs long enough to clip
tray item: thumb, clipping title, glyph actions
Specimen Title secondary line - detail
info card: stacked mono lines

desktop icon

hover: --tint label
press: inverted label
~/enjoy/08-motifs

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

~/any/window
body, 13-14px mono on the surface.
  1. Frame: 2px ink, --r-win, surface fill.
  2. Traffic dots: three outlined circles, left.
  3. Title: 12px path voice, centred.
  4. A 2px rule between bar and body.
  5. Shadow: 3px 3px 0, zero blur.

wave wallpaper - behind everything

2-3 huge slow --tint shapes, flat, fixed to the viewport

readout and menu bar

10:24

a quiet second line

readout: one big numeral, blinking tick
menu bar: a slim window with no title bar

desktop icons - hand-drawn line glyphs, 2.5 stroke

~/enjoy/09-composition

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.

status

10:24

a quiet second line

lvl
use
Specimen item in the tray
note.txt

A small window

~/specimen - split 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

Specimen item - one line 0:47 / 3:33

anatomy

partas builtwhy it is that
Desk gap--sp-7 / --sp-8Windows never touch. The desk showing between them is what makes each one an object.
Small windows.windowReadout, 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--inverseThe frame takes the ink. It is how the feature pane is announced, so it appears at most once per screen.
Side list.split-sideOn the surface, not the feature. Navigation stays calm so the pane beside it can be loud.
Feature pane--feature, 24px floorThe one saturated field. The current line is marked with a > and full opacity, never with a second colour on the field.
Foot bar.split-footControls go back on the surface. Buttons never sit on the feature field.
Live dot--live, 8pxThe only red on the desk. One dot, pushed to the row's end.
~/enjoy/10-rules

Rules

The refusals matter more than the permissions.

do.txt
  • 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 --feature once 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.
do-not.txt
  • 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 --feature for chrome, buttons or accents, or put small text on it.
  • Use --live as a fill or a text colour. It is a dot.
  • Run the tide behind body text or beside a feature pane.