Repository navigation
Keycaps and Appearance
A key carries up to four legends. Primary, secondary and tertiary can each be set independently, and placement follows from which are filled:
| Filled | Placement |
|---|---|
| Primary only | Centred |
| Primary + secondary | Primary moves down, secondary above it, pair centred |
| Anything else | Secondary and tertiary take the top corners, primary the bottom left |
The function legend is separate: it always takes the bottom right corner, set smaller, and is the one legend that needs a primary set first.
Legends are set in the system sans with slightly tightened tracking; anything
past four characters drops a size so Backspace sits on a cap the way A
does.
The Home key checkbox draws a subtle bar near the bottom of the cap, the
way F and J carry a ridge on a real board.
L drops United Kingdom ISO, 100% — the full‑size Mac layout with arrow
cluster and keypad — into the middle of the view, stepping clear of anything
already there. Its Enter is a true iso-enter L shape.
M drops the Mac fn row — brightness, Mission Control, Spotlight, dictation,
Do Not Disturb, media and volume — as twelve 1u keys grouped in fours. Each
cap shows its icon in place of the primary legend and keeps its F1…F12 as
the corner legend.
Layouts live in js/layouts.js and icon glyphs in
js/icons.js, both as plain data.
Rectangular is the default and Circle is the knob shape R places.
Two more are stepped, true‑L keycaps rather than a bounding rectangle:
| Shape | Real footprint |
|---|---|
| ISO Enter | 1.5u top row, 1.25u home row, right‑flush |
| Big‑Ass Enter | 1.5u top row, 2.25u home row, right‑flush |
Picking a stepped shape snaps the key to its real footprint if the room is free. The notch is a fixed width, so widening the key afterwards only grows the cap.
Four palettes, picked from the swatches at the top right: Light (paper white), Retro (warm paper and beige caps), Nord (cool slate with a frost accent) and Dark (neutral greys, off pure black). Auto is on by default and follows the system light/dark setting; picking a palette by hand turns it off. The choice is remembered.