Files
dawnline/DESIGN.md
T
Aemeath dc0f159447
Build packages / CI (push) Blocked by required conditions
Build packages / Version (push) Waiting to run
CI / Web (format, types, tests, bundles) (push) Blocked by required conditions
CI / ShellCheck (push) Blocked by required conditions
CI / ucode static checks (push) Blocked by required conditions
CI / ucode compiles and tests pass (OpenWrt 24.10) (push) Blocked by required conditions
CI / ucode compiles and tests pass (OpenWrt 25.12) (push) Blocked by required conditions
Dawnline 0.14.0
- A device is renamed where its name stands on its card: a click on the
  name, Return or Space on it, or Rename in the ⋯ menu turns it into a
  field with the name selected. Return saves, and the words shimmer until
  the router answers. Esc or a click elsewhere puts the old name back. The
  rename window is gone, and the page no longer redraws under a name being
  edited
- Device names take up to 20 characters: letters of any language, digits,
  spaces and - _ . The router refuses anything else when a device is added
  or renamed, so a name can't carry symbols into configurations, file
  names or the AmneziaVPN key. The portal and the admin turn a character
  like that away as it is typed: the field shakes, its outline goes red
  and a short line says why. Suggested names (a phone's model, "Phone 2")
  are stripped of such characters and cut to fit. Names set before this
  stay as they are
- LAN Bypass: Add a device, in the portal and in the admin, has a switch
  that keeps the device's own local network (printer, TV, NAS) reachable
  while it is connected. It is off by default and stays as chosen; the
  admin's device drawer shows it. With home and internet access the switch
  says which addresses still lead to the home network
- Health warns when a server's home network is on one of the subnets home
  routers come with (192.168.0.x, 192.168.1.x and others). People with
  home access who connect from a network on the same addresses reach your
  home instead of their own, LAN Bypass or not
- The router tells when a device can't connect properly. After the problem
  lasts three minutes, the portal card and the admin drawer name it:
  can't finish connecting (the network may block it), connected but no
  data (an outdated configuration, and the card offers Reconnect), on two
  devices at once, or a connection that keeps dropping. Activity lists
  these under Problems, one line per device per hour, and says when the
  device connects normally again
- The set-up sheet's connection line follows what the device does:
  waiting, can't finish, connected, or connected but no data. The sheet
  closes by itself only once data comes through. On the device itself and
  for a router, the steps regroup to what fixes the problem: "Set it up
  again" when the handshake never finishes, "Add the connection again"
  ("Import the configuration again" for a router) when no data comes
- Set-up in the portal: a QR code too long for a camera to read gives its
  place to a code that opens the set-up link (a LAN Bypass configuration
  or a long AmneziaVPN key can be that long). A TV, box or NAS added from
  a phone gets the steps for setting up from another device. Back from
  "Open on the device" keeps the kind, LAN Bypass and the name typed. The
  packet-size note under the kinds is gone
- The portal on phones keeps its place: nothing jumps when an access row
  opens or folds, a notice comes or goes, or Safari redraws the cards. A
  reload, or coming back from the VPN app, opens where the page was. Cards
  glide to their new height, and an animation interrupted half-way goes on
  from where it is instead of snapping. A double click no longer closes
  the sheet it just opened
- In the admin, a device's drawer has its own MTU and keep-alive (empty
  means the server's), each with a Change dialog. A change touches only
  that device's configuration and restarts nothing on the router. Opening
  the drawer no longer counts as handing out the configuration: "Update
  config" stays until the new configuration is shown as a QR code,
  downloaded or copied ("Show the new configuration"). New keys set the
  device up again, as the portal's Reconnect does
- "Speed now" on a server's Overview is live: one point a second over the
  last two minutes, all there as soon as the Overview opens. The agent
  keeps those two minutes in memory and writes them out only while someone
  is looking
- Disguise values that AmneziaWG refuses or crashes on are stopped before
  they reach the kernel. That covers overlapping H1-H4, Jmin above Jmax,
  broken I1-I5 tags, padding under 12 with header protection, and more.
  Import and restore refuse them. After a hand edit in uci, the server's
  tunnel stays down and Health and the service log say why and what to do.
  Errors are full sentences in the reader's language
- The header protection key no longer shows in the status that read-only
  users can see: the Server page says only that the key is set, and each
  device's configuration still has it. The server no longer turns off
  WireGuard's protection against handshake floods (devices keep
  DisableCookies). A device can't be added with a server's own key
- An AmneziaWG update whose kernel module can't be swapped (another
  AmneziaWG interface holds the old one) no longer fails. It is installed,
  the tunnels come back on the old module, and Health and Components say
  the update starts after a reboot. On apk firmware, an install that apk
  left at the old version counts as failed. A module installed by hand is
  recorded, so after a firmware upgrade Health can tell that it is gone
- Dawnline reads only its own tunnels, each one separately. Another
  AmneziaWG interface on the router no longer slows the agent's
  once-a-second check, has its keys read or breaks Dawnline's reads. A
  portal request reads only that person's server: one process however many
  servers there are
- Fewer false disconnects: a tunnel that netifd sets up again no longer
  logs everyone as leaving and coming back, and a device with a long
  keep-alive stays online between handshakes. One configuration on two
  devices isn't logged as roaming every few seconds, and new keys end the
  old session at once. A tunnel that is missing devices is synced within a
  minute, and traffic across a tunnel restart is no longer undercounted
- Renaming a server no longer restarts its tunnel. If a tunnel's interface
  is edited outside Dawnline (LuCI, uci), the watchdog sets it up again
  with Dawnline's settings and names only the changed options. The routing
  rules for "Internet like a home device" change one at a time, new ones
  first, so traffic never falls between them. Health and the Server page
  warn when the address's AAAA record isn't this router's, or the router
  has no public IPv6: devices that prefer IPv6 fail to connect
- The README screenshots come in English and Russian; the portal's are
  taken from its demo. The demo has a switch beside × in the set-up sheet
  to show each state of the connection line. In Russian, long labels in
  the admin's wide option buttons wrap under their icon. DESIGN.md
  describes the switch, renaming on the card, the shimmer, the shake and
  how the portal scrolls. New tests cover link states, the meter, access,
  Health, firewall rules, network settings and packages
2026-10-22 00:11:50 +03:00

108 KiB
Raw Blame History

version, name, description, colors, typography, rounded, spacing, components
version name description colors typography rounded spacing components
alpha Dawnline Portal The personal portal of Dawnline (an AmneziaWG access server for OpenWrt): one page per person with their devices, their access and the set-up of a new device. Near-black and quiet, surfaces that step up in brightness instead of borders, one sky-blue accent, colour only for state, physical spring motion, and text that changes in place letter by letter.
bg raised field knob seg line line-glass text text-2 text-3 accent accent-ink accent-soft ok ok-soft warn bad bad-soft selection-bg selection-fg scrim bar toast toast-fg qr-bg light-bg light-raised light-field light-knob light-seg light-line light-text light-text-2 light-text-3 light-accent light-accent-soft light-ok light-ok-soft light-warn light-bad light-bad-soft light-selection-bg light-selection-fg light-scrim light-bar light-toast light-toast-fg light-qr-bg
#080808 #121212 #161616 #232323 rgba(237, 237, 237, 0.05) rgba(255, 255, 255, 0.06) rgba(255, 255, 255, 0.07) #ededed #8c8c8a #4f4f4e #4eafff #ffffff rgba(78, 175, 255, 0.13) #57d64b rgba(87, 214, 75, 0.14) #ff8a3d #ff5c5c rgba(255, 92, 92, 0.13) rgba(131, 209, 255, 0.25) #64c6ff rgba(8, 8, 8, 0.8) rgba(237, 237, 237, 0.13) #232323 #ededed #0a0a0a #f2f2f1 #ffffff #f3f3f2 #e8e8e7 #ffffff rgba(0, 0, 0, 0.07) #0b0b0b #6d6d6b #a6a6a4 #2b9dff rgba(43, 157, 255, 0.12) #33a328 rgba(51, 163, 40, 0.12) #ee6a12 #e5484d rgba(229, 72, 77, 0.1) rgba(78, 175, 255, 0.22) #0a76cf rgba(236, 236, 235, 0.62) rgba(11, 11, 11, 0.11) #0b0b0b #f2f2f1 #ffffff
body display-number card-title-alone section-title sheet-title empty-title value card-title button button-strong input step-title row-title breadcrumb question-text desc menu-item toast meta pill-label label-sm tooltip divider-label axis axis-xs calendar-head mono-link mono-code
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 15px 400 22px -0.011em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 36px 600 40px -0.045em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 22px 500 28px -0.03em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 20px 500 28px -0.025em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 20px 500 28px -0.5px
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 18px 500 24px -0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing fontFeature
Geist 17px 500 24px -0.02em "tnum"
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 16px 500 22px -0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 16px 500 22px -0.015em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 16px 600 22px -0.015em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 16px 500 24px -0.012em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 16px 500 24px -0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 15px 500 22px -0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 15px 400 22px -0.15px
fontFamily fontSize fontWeight lineHeight
Geist 15px 400 21px
fontFamily fontSize fontWeight lineHeight
Geist 14px 400 20px
fontFamily fontSize fontWeight lineHeight
Geist 14px 500 20px
fontFamily fontSize fontWeight lineHeight
Geist 14px 500 20px
fontFamily fontSize fontWeight lineHeight
Geist 13px 400 18px
fontFamily fontSize fontWeight lineHeight
Geist 13px 600 18px
fontFamily fontSize fontWeight lineHeight
Geist 12px 500 16px
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 12px 500 12px -0.1px
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist 12px 500 22px 0.06em
fontFamily fontSize fontWeight lineHeight
Geist 11px 500 16px
fontFamily fontSize fontWeight lineHeight
Geist 10px 500 14px
fontFamily fontSize fontWeight lineHeight
Geist 9px 600 10px
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist Mono 13px 400 22px 0px
fontFamily fontSize fontWeight lineHeight letterSpacing
Geist Mono 12px 400 18px 0px
sheet card notice qr-big qr-dense row menu badge qr field tile kind inner key way-end chip bar full
36px 28px 24px 24px 22px 20px 20px 18px 18px 16px 16px 14px 14px 12px 11px 10px 3px 999px
gutter page-top page-bottom page-max access-column columns-gap stack-gap crumbs-below section-head-below grid-gap card-padding sheet-padding sheet-width sheet-edge open-row-gap tile-gap notice-below
16px 40px 112px 1072px 384px 36px 40px 32px 12px 10px 8px 24px 400px 16px 10px 8px 22px
button-primary button-tint button-soft button-danger button-small knob field go-button go-button-ready device-card usage-block accordion-row accordion-row-inset sheet menu menu-item toast tooltip notice segmented segmented-pill kind-tile option-row switch switch-on badge link-row update-pill language-pill name-chip qr-code qr-code-big
backgroundColor textColor typography rounded height padding
{colors.accent} {colors.accent-ink} {typography.button-strong} {rounded.full} 48px 0 20px
backgroundColor textColor typography rounded height padding
{colors.accent-soft} {colors.accent} {typography.button-strong} {rounded.full} 48px 0 20px
backgroundColor textColor typography rounded height padding
{colors.knob} {colors.text} {typography.button} {rounded.full} 48px 0 20px
backgroundColor textColor typography rounded height padding
{colors.bad} #ffffff {typography.button-strong} {rounded.full} 48px 0 20px
rounded height padding
{rounded.full} 40px 0 16px
backgroundColor textColor rounded size
{colors.knob} {colors.text} {rounded.full} 32px
backgroundColor textColor typography rounded height padding
{colors.field} {colors.text} {typography.input} {rounded.field} 48px 0 4px 0 16px
backgroundColor textColor rounded width height
{colors.knob} {colors.text-3} {rounded.key} 48px 40px
backgroundColor textColor rounded width height
{colors.accent} {colors.accent-ink} {rounded.key} 48px 40px
backgroundColor rounded padding
{colors.raised} {rounded.card} 8px
backgroundColor rounded padding height
{colors.field} {rounded.row} 12px 14px 12px 16px 66px
backgroundColor typography rounded height padding
{colors.raised} {typography.row-title} {rounded.row} 52px 0 8px
backgroundColor rounded height
{colors.field} {rounded.row} 52px
backgroundColor rounded width padding
{colors.raised} {rounded.sheet} 400px 0 24px 24px
backgroundColor rounded padding width
{colors.field} {rounded.menu} 6px 224px
typography rounded height padding
{typography.menu-item} {rounded.inner} 40px 0 12px
backgroundColor textColor typography rounded height padding
{colors.toast} {colors.toast-fg} {typography.toast} {rounded.full} 42px 0 18px 0 13px
backgroundColor textColor typography rounded height padding
{colors.toast} {colors.toast-fg} {typography.tooltip} {rounded.full} 26px 0 10px
backgroundColor rounded padding
{colors.raised} {rounded.notice} 14px 18px 14px 14px
backgroundColor rounded height padding
{colors.field} {rounded.field} 48px 0 4px
backgroundColor rounded height
{colors.seg} {rounded.key} 40px
backgroundColor rounded height
{colors.field} {rounded.kind} 56px
backgroundColor textColor rounded padding
{colors.field} {colors.text} {rounded.field} 12px 12px 12px 14px
backgroundColor rounded width height
{colors.knob} {rounded.full} 44px 26px
backgroundColor rounded width height
{colors.accent} {rounded.full} 44px 26px
backgroundColor rounded height padding
{colors.field} {rounded.badge} 60px 0 14px 0 12px
backgroundColor typography rounded height padding
{colors.field} {typography.mono-link} {rounded.inner} 44px 0 4px 0 14px
backgroundColor textColor typography rounded height padding
rgba(255, 138, 61, 0.14) {colors.warn} {typography.pill-label} {rounded.full} 32px 0 12px 0 10px
backgroundColor textColor rounded height padding
{colors.knob} {colors.text} {rounded.full} 32px 0 8px 0 12px
backgroundColor typography rounded height padding
{colors.field} {typography.mono-link} {rounded.chip} 32px 0 10px 0 12px
backgroundColor rounded size
{colors.qr-bg} {rounded.qr} 148px
backgroundColor rounded size
{colors.qr-bg} {rounded.qr-big} 208px

DESIGN.md — the Dawnline personal portal

This file describes the personal portal (web/src/portal, plus the parts of web/src/shared it uses): its look, its components and, in its own part, its motion. The admin pages inside LuCI follow rules/ui-design.md and the LuCI theme and are not covered here.

The front matter follows the DESIGN.md draft format (alpha). The prose sections come in that format's order. Motion Design, Content & Voice, Accessibility, Live audit and Source map are extra sections after them.

How this was researched (2026-10-20, Dawnline 0.11.0). Two passes:

  1. The code. Every stylesheet in web/src/portal/styles, the motion engine (motion.ts), every UI module (ui/), the page (page/) and the flows (flows/).
  2. The live demo (dawnline-demo.vercel.app, the real portal over an in-page router). I went through every scenario, sheet, menu, picker and button at desktop width (1138 px) and phone width (375 px), in dark and in light, in English and in Russian. A recorder hooked Element.prototype.animate, transitionrun and animationstart, so every duration, delay and easing in this file was seen running, not only read. Spring durations and overshoot were computed from the same function the portal uses (see Motion → Springs).

Where code, older plans and the live page disagree, the live page wins. The disagreements are listed in Live audit.


Overview

The portal is one person's page on a router. It opens from a personal link with no account and no cookie, and it has three jobs:

  • show the person's devices;
  • show their access (what it reaches, how much data, until when);
  • set up a new device in about a minute.

The router serves it as a CGI process under a strict CSP, which forbids inline scripts and style= attributes. It is plain TypeScript, with no framework, and it does not poll.

Lineage. The look was approved as a mockup (Oct 2026). It borrows from four places:

  • skiper-ui: skiper21's palette, accent, highlight and tab pill, and skiper103's bouncy accordion;
  • iconiqui: the breadcrumb and the edge fades (dia-text);
  • aicss.dev: the busy orb, "Orbs B4 Converge";
  • Vercel's Geist: the type.

Personality. Calm, dark and tactile. The page is near-black (#080808). There are no borders: each layer is a step brighter than the one under it. One sky blue is the only accent. Every other colour means a state. The UI is made of big round shapes (36 px sheets, 28 px cards, pills), and glass icons are the only illustration.

Principles

  1. Structure over text. Tiles, rings, bars, calendars and pills say it before a sentence does. Summaries come first ("38.6 GB / 100 GB"), details sit one tap deeper (the accordion).
  2. Depth from brightness, not lines. Each layer goes bg → raised → field → knob, every step a little lighter. A ring is drawn inset, and only to mean something: focus, the picked tile, this device, a notice's tone.
  3. Colour is meaning. Accent blue means action or "you are here". Green means fine or connected, orange means attention or paused, red means stopped, out or destructive. Grey is everything else.
  4. One place per fact. The count sits beside "Your devices", the usage sits on its card, and the access sits in its rows. Nothing is repeated.
  5. Nothing blinks. A change happens where it is: text morphs letter by letter, cards glide to their new places, a sheet glides to its new height. A repaint never flashes.
  6. Physical, interruptible motion. Springs are given as stiffness and damping, and each animation starts from where the element stands right now.
  7. The keyboard never animates. Escape closes a sheet or a menu instantly. Reduced motion keeps fades and drops all travel.
  8. Honest states. Paused, out of data, outside the hours, a plain-HTTP link: each is said once, where it matters, in the state's colour.

Colors

All colours are CSS custom properties in styles/tokens.css. The dark theme comes first. Light applies under @media (prefers-color-scheme: light), with no toggle: the page follows the system, and its QR codes repaint in place when the system theme changes.

Surfaces: the brightness ladder

Token Dark Light Role Where
--bg #080808 #f2f2f1 The ground body, the edge fades
--raised #121212 #ffffff Things on the ground device cards, accordion rows, sheet, notices, the "gone" card
--field #161616 #f3f3f2 Things inside raised usage block, inputs, segmented track, inset rows, tiles, badges, QR row, menu
--knob #232323 #e8e8e7 Controls on anything knobs, soft buttons, step numbers, hover fills, toast (dark)
--seg rgba(237,237,237,.05) #ffffff + --seg-shadow The picked pill in the app picker .seg-pill
--line rgba(255,255,255,.06) rgba(0,0,0,.07) The only hairline "OR" divider, menu separator and inner rim, light QR rim

The measured luminance steps are tiny. In dark, raised vs bg is 1.07:1, field vs raised 1.04:1 and knob vs raised 1.19:1. In light they are 1.12, 1.11 and 1.23. Hierarchy comes from the shape and the radius as much as from the fill, so do not add borders to make a level visible.

Text ladder

Token Dark Light Use
--text #ededed #0b0b0b Titles, values, current crumb, bold steps
--text-2 #8c8c8a #6d6d6b Secondary lines: statuses at rest, labels, hints, sheet subs, head values, accordion chevrons
--text-3 #4f4f4e #a6a6a4 Faint: counts ("3 of 4"), "OR", axis ends, placeholders, idle picker icons, the limit note, chevrons in badges

.desc is --text at opacity: .6, not --text-2, so it stays readable inside rows of any fill.

Accent and states

Token Dark Light Meaning
--accent #4eafff #2b9dff Primary action, "this device", today, links in hints, the selection ring, a field's caret and selection, a switch that is on
--accent-ink #ffffff #ffffff Text on a filled accent button, the knob of a switch that is on
--accent-soft blue @ 13% blue @ 12% Tinted "Connect", the Demo chip, a primary badge's icon tile
--ok / --ok-soft #57d64b / 14% #33a328 / 12% Connected, included, the way filling green, the arrival ring
--warn #ff8a3d #ee6a12 Not set up yet, settings changed, outside hours, Reconnect, ends soon, a link that fails (the card's line; the way's can't finish and no data)
--bad / --bad-soft #ff5c5c / 13% #e5484d / 10% Out of data, access ended, Remove, errors
--sel-bg / --sel-fg rgba(131,209,255,.25) / #64c6ff rgba(78,175,255,.22) / #0a76cf ::selection
--bar text @ 13% text @ 11% Chart bars, meter and ring tracks

Tint recipes (keep them)

All tints come from color-mix, never from new hex values:

Recipe Where
color-mix(in srgb, var(--knob), var(--text) 6%) hover of knob, soft button, language pill, pinned keys; at rest, the file card's icon and a nested row's soft buttons inside an inset row
… var(--text) 10% pressed or open (aria-expanded) knob and language pill
… var(--text) 12% hover of a nested row's soft buttons inside an inset row (the router's "Configuration" in "Set it up again")
color-mix(in srgb, var(--accent) 82%, transparent) hover of the filled accent button
accent 20% / 24% over transparent hover / active of the tinted button
`color-mix(in srgb, var(--warn --bad) 10%, var(--raised))+inset 0 0 0 1px tone 22%`
warn 14% → hover 22% the Update pill
color-mix(in srgb, var(--raised), var(--knob) 40%) hover of an accordion row (inset rows and the option row: field + knob 50%)
color-mix(in srgb, var(--knob) 65%, var(--field)) the app picker's track, the badges, the file card and a nested inset row inside an inset row (a badge's and that row's hover: knob)
color-mix(in srgb, var(--accent) 26%, transparent) a field's selection wash
color-mix(in srgb, var(--warn) 14%, transparent) the way's router end when the device can't finish (accent 14% while waiting)
color-mix(in srgb, var(--accent) 32%, transparent) inset 1px ring of the card of "this device"
color-mix(in srgb, var(--text) 16%, transparent) inset 1.5px focused field
color-mix(in srgb, var(--accent) 65%, transparent) 2px outline, offset 2px :focus-visible everywhere

Overlays and floating colours

  • Scrim: dark rgba(8,8,8,.8), light rgba(236,236,235,.62), both with backdrop-filter: blur(8px).
  • Toast and tooltip: #232323 on dark. On light they invert to #0b0b0b with #f2f2f1 text.
  • QR card: #0a0a0a "night" (light dots) on dark, #ffffff "day" (dark dots) on light, with a 1px --line rim in light.

Glass icon tones

Glass icons (ui/glass.ts) draw a tinted back shape, the same shape blurred behind a frosted pane, a rim and white detail strokes. Their colours come only from classes, because the CSP drops style=.

Tone Dark a → b Light a → b Used for
t-grey #cfcfcd → #5a5a59 #a9a9a7 → #3d3d3c Device cards (default), access rows, Add
t-blue #a6d9ff → #1d84e6 #7cc4ff → #0a6fd6 This device, first device, kinds, reach tiles that are on, the LAN Bypass row when on, "Set it up again", lock
t-green #a8f29c → #3aa32c #82e070 → #2e8a22 "Everything works" (demo)
t-orange #ffc08f → #ec6a12 same as dark Warn notices, Reconnect question
t-red #ffadad → #dc3a3a #ff9090 → #c92a2a Bad notices, Remove question

Frosted pane: dark --gi-a .58 / --gi-b .14 white with a .5 rim and no edge stroke. Light uses a .72 / .5 grey pane, a .9 rim and an rgba(0,0,0,.11) edge, with dark detail strokes.

Contrast (measured, WCAG 2.x)

Pair Dark Light Verdict
text on bg / raised 17.1 / 16.0 17.6 / 19.7 AAA
text-2 on raised / field 5.6 / 5.4 5.2 / 4.7 AA
text-3 on bg / raised / field 2.4 / 2.3 2.2 / 2.4 below AA: decorative only
accent text on raised 7.9 2.9 AA in dark only
white on accent (primary buttons) 2.4 2.9 below AA, a known trade-off of the skiper21 palette
white on bad (Remove) 3.0 3.9 AA large only
ok / warn / bad text on raised 9.9 / 8.0 / 6.2 3.3 / 3.1 / 3.9 dark AA, light below AA at 13 px

These ratios feed the findings in Live audit.


Typography

Families: Geist (variable, 100–900) and Geist Mono. They are self-hosted as woff2 next to portal.css (CSP font-src 'self'). Geist ships in Latin and Cyrillic subsets split by unicode-range, Geist Mono in Latin. Fallbacks are -apple-system, system-ui, 'Segoe UI', sans-serif and ui-monospace, 'SF Mono', Menlo, monospace, all with font-display: swap.

Base: 400 15px/22px, letter-spacing: -0.011em, -webkit-font-smoothing: antialiased. Body cursor: default, because the page is an app, not a document. Fields, the link and the configuration keep the I-beam.

Scale (measured live)

Role Size / line Weight Tracking Where
Display number 36 / 40 600 −0.045em Days left in "Access until"
Card alone title 22 / 28 500 −0.03em "Access paused", "This link no longer works"
Section title 20 / 28 500 −0.025em "Your devices", "Your access"
Sheet title 20 / 28 500 −0.5px View heads, question titles
Empty title 18 / 24 500 −0.02em "Add your first device"
Value 17 / 24 500 −0.02em Weekly usage on a card
Card title 16 / 22 500 −0.02em Device name
Button 16 / 22 500 (600 on accent, tint, red) −0.015em .btn (.sm: 15 px)
Input 16 / 24 500 −0.012em Name fields (16 px stops iOS zoom)
Step title 16 / 24 500 −0.02em "1 Get AmneziaVPN"
Row title 15 / 22 500 −0.02em Accordion heads, notice title, month total
Option title 15 / 22 500 −0.015em "LAN Bypass" in its option row
Breadcrumb 15 / 22 400 (current 500) −0.15px Server › person
Question text 15 / 21 400 — Remove / Reconnect body
Desc / sub / value line 14 / 20 400 — Row descriptions, sheet subs, head values
Menu item, toast 14 / 20 500 — ⋯ menu, toast
Meta 13 / 18 400 — Card status, usage label, hints, "how to" paths, limit note, the option row's line, the way's second line
Pill label 13 600 — Update pill, Demo chip
Small label 12 / 16 500 — Kind labels, badge top line, reach tile sub, "Copy…" labels
Divider 12 500 +0.06em "OR" (the only positive tracking)
Axis 11 (10 for hours) 500 — Month and hours axes
Calendar head 9 / 10 600 — Weekday initials
Mono link 13 400 0 Link rows, name chips
Mono code 12 / 18 400 0 .conf view; the file card icon is mono 10 / 600

Rules

  • Tracking tightens as size grows: −0.011em for body, −0.02em at 15–17 px, −0.025em to −0.045em for titles and numbers. Mono is always 0.
  • Only 400, 500 and 600. 500 marks a title or a value, 600 marks a filled button, a number on display, a pill or a step number.
  • Numbers that change use .num (tabular-nums), so a morph or a hover readout never shifts its neighbours.
  • Mono is for things typed or copied by hand: addresses, links, hostnames, the configuration. Names stay in Geist.
  • One line where it fits: names, statuses, crumbs and link rows end in an ellipsis. The full text goes in title.
  • text-wrap: balance for short centred paragraphs (first device, "gone" card, secure sheet). pretty for left-aligned question text.
  • No uppercase except the "OR" divider. No ellipsis on buttons: "Remove", never "Remove…". "…" appears only for progress and truncation. The single exception is another app's own menu label quoted verbatim ("Import Tunnel(s) from File…").
  • Russian runs 20–30% longer. Every new string is checked at 375 px in Russian (rules/i18n.md).

Layout

Page frame

  • .page: max-width: 1072px, centred. The side gutter is max(16px, safe-area). The top is 40px + safe-area-top and the bottom 112px, so the end of the scroll clears the bottom fade.
  • No navbar. The page opens with a breadcrumb row: 32 px high and 32 px above the content. The Dawnline mark sits in a 32 px box (logo 24 px), then server › person, then on the right the language pill and the QR knob. Without a server name the place reads "Dawnline". The browser tab title is the place too.
  • Edge fades sit above the page and under every overlay:
    • top: 80 px plus the safe area, a bg → 75% → 0 gradient with backdrop-filter: blur(12px), masked 1 → .88 @44% → 0. It shows only once scrollY > 2, so the breadcrumb at rest stays crisp.
    • bottom: 96 px, a plain bg → transparent gradient interpolated in oklab.

Columns and order

Width Layout
< 560 One column. "Your access" first (order: -1), then "Your devices". Device grid in one column.
560–959 One column, device grid in two columns (gap 10).
≥ 960 Two columns: devices on the left (fluid), access on the right (384px, position: sticky; top: 84px + safe-area). Column gap 36 (40 when stacked).

Other breakpoints and container queries:

Condition Effect
≤ 380px A code row stacks (code above its words)
≤ 440px The scan line puts the menu path under its label for every app
≥ 760px The sheet becomes a centred dialog (below that, a bottom drawer)
@container (≤ 300px) on the app picker Items shrink to 44 px, padding 12
@container (≤ 330px) on kinds Tiles 50 px high, labels 11.5 px

Single card mode

When there is nothing else to show (access paused, the link stopped working, the page could not load), the page becomes one card in the middle of the screen with the breadcrumb above it.

  • The card: .gone, radius 36, padding 32 24 28, a 56 px glass icon, a 22 px title and a balanced line of text.
  • The breadcrumb: centred on its words, with the mark hanging to their left. It is nudged right by 12 px so mark and words read as centred together.
  • What it drops: the language and QR controls.

Spacing rhythm

There is no strict 4/8 grid. The values in use are 2 3 4 5 6 8 10 12 14 16 18 20 22 24 28 32 36 40. The common pairs:

  • card padding 8, with the inner block radius = card radius − 8;
  • grid gap 10, and the gap of an open accordion row 10;
  • tile gaps 8;
  • sheet padding 24;
  • section head padding 0 4 12;
  • notice below 22;
  • step spacing 20, with 10 inside a step.

Stacking

Layer z-index
Page auto
Edge fades 30
Sheet root (scrim + sheet) 50
⋯ menu 60
Toasts 70
Inside the sheet: ×, pinned keys 3; their tooltip 4

Scroll

Only the person moves the page: on a phone nothing the page does pulls it up or down under them, and a reload finds it where they left it.

  • No scroll anchoring (html { overflow-anchor: none }). On a phone "Your access" shows above the devices but comes after them in the page, so the browser would hold "Your devices" still while an access row opens or folds, and pull a page scrolled less than the fold to the very top. A row grows and folds in place, and a repaint glides what moves.
  • A fold near the foot takes the page down with it (holdFoot() in page/frame.ts). Without anchoring, a fold that leaves the page shorter than where it is scrolled would drop it to its new end on the frame the fold is measured. The page body holds the height the scroll needs until the rows' new shape is known, then lets go over 476 ms on EASE_OUT, which never overshoots: the scroll follows the fold down frame by frame and stops at the new foot, not short of it while the row's spring dips.
  • A repaint holds the page's height (render() in main.ts). The content keeps its height on screen while it is refilled and lets go once everything in it has its styles. Safari lays the page out once with the new cards still empty (each is a size container) and would pull the scroll up to fit that shorter page; a language change empties it all. A page that really got shorter (a removed card) still shrinks after.
  • A reload keeps its place. A phone drops a tab while the visitor is in another app (the VPN app, the App Store) and loads it again on return; a pull to refresh does too. The browser restores the scroll as the page loads, before the router has answered, onto one empty screen, so it would stay at the top. The tab keeps the page's place itself (sessionStorage, as the tab is hidden or left), and the first paint of a reload or of a step back onto the page goes there. A fresh visit to the link opens at the top. Each link keeps its own place (several people's links opened in one tab share the origin), and only the page drawn in its place writes one: a tab hidden before the router answered, or showing a card in place of the page, keeps the place it had.
  • The sheet's history entry never moves the page (scrollRestoration = 'manual' on that entry only), and it is current only while its sheet is open. Left behind (a reload with a sheet open, a step forward onto it: Safari's swipe in from the right edge), it is stepped back off at once, on load or on that step, so Back from there leaves the page instead of putting it back where it stood when the sheet opened. The page's own entry stays auto, so Back and closing a sheet still restore it.
  • html { scrollbar-gutter: stable } and body.locked { overflow: hidden } keep the page from shifting sideways when a sheet locks the scroll.

Elevation & Depth

  • Resting surfaces have no shadow. Depth comes from the brightness ladder alone, so cards, rows, tiles and fields are all flat.
  • Floating layers get one shadow each:
    • --pop-shadow: dark 0 18px 48px -14px rgba(0,0,0,.75), light 0 18px 44px -14px rgba(0,0,0,.2). Used on the ⋯ menu (plus inset 0 0 0 1px var(--line)), the toast and the tooltip (plus 0 0 0 1px var(--line-glass)).
    • --sheet-shadow: dark 0 24px 64px -16px rgba(0,0,0,.6), light … -18px rgba(0,0,0,.22). Used on the sheet.
  • Scrim: 80% (dark) or 62% (light) plus an 8 px backdrop blur. The page behind a sheet is out of focus, not just darker.
  • Inset rings replace borders. Every ring is box-shadow: inset 0 0 0 Npx:
    • focus: 1.5 px, text at 16%;
    • picked kind: 1.5 px accent;
    • this device: 1 px, accent at 32%;
    • notice tone: 1 px, tone at 22%;
    • the arrival flash: 1.5 px --ok, fading.
  • Inset context. Inside the sheet, accordion rows use --field (.acc.inset), one step above the sheet's --raised. Segmented controls, badges, the file card and a row nested in one step up again (knob 65% + field; a badge's and a nested row's hover go to knob).
  • Glass icons are the only "material" effect: a frosted pane over a 1.5 px Gaussian-blurred copy of the tinted back shape, with a rim stroke. Keep it to icons.

Shapes

Radius scale

Radius Where
36 Sheet, "gone" card
28 Device card (and the add / first cards)
24 Notice, big QR
22 Dense QR
20 Accordion row (open, and the shared ends of closed rows), usage block, ⋯ menu, the way
18 Badge, QR in a row, file card
16 Field, segmented track, reach tile, option row, "until" and "hours" blocks; the pinned keys' outer corners
14 Kind tile, link row, menu item and highlight, .conf block
12 Go button, segmented pill
11 Ends of the way
10 Name chip, badge icon tile, link row knobs
9 File card icon
6 Inner corners of the joined pinned keys
2.5–4 Chart bars (2.5 month, 3 spark, 3 calendar cells), meter and hours bar, a field's selection wash (4)
1 A field's caret and selection handles
999 / 50% Buttons, pills, chips, toasts, tooltips, the switch / knobs, step numbers, reach marks, the switch's knob, the handles' knobs

Shape rules

  • Nesting: inner radius = outer radius − padding. Card 28 − 8 = usage 20. Field 16 − 4 = go button 12. Segmented track 16 − 4 = pill 12.
  • Closed accordion rows touch and share rounded ends. Only the first row's top and the last row's bottom are round. An open row lifts out with 10 px gaps and gets all four corners, and so do its neighbours' facing corners.
  • Joined key pairs (Download | Copy beside ×): 16 6 6 16 and 6 16 16 6, with a 2 px gap.
  • Line icons: 24 viewBox, stroke-width 1.8, round caps and joins, currentColor. Shown at 14, 16, 18 or 20 px.
  • Glass icons: 24 viewBox drawn at 22 (rows), 24, 26 (kinds), 28 (reach, option row), 30 (demo rows), 32 (cards), 36 (notices, add), 44 (first), 56 (gone) and 64 (questions).
  • QR codes: round dots (r 0.42, 0.48 when dense), eyes drawn whole as rounded squares (2.6 / 1.8 / 1.5), and the Dawnline mark in a rounded tile at the centre (dense codes have none). Light dots on #0a0a0a in dark, dark dots on white in light.
  • The mark: a sun dome over a horizon bar, one colour, fill: var(--text): white on dark, black on light, never the accent. Clipped above the bar so the sun can rise from behind it.

Components

Measurements are CSS pixels, read live at 1138 px and 375 px. Source files are under web/src/portal/.

Breadcrumb · page/frame.ts

  • Layout: a 32 px row with gap 10. The mark box is 32 × 32 (logo 24). The path is 15/22 text-2 with gap 6 and a 14 px chevron; the current crumb is text 500 with aria-current="page".
  • Language pill (.cr-lang): 32 high, pill, knob fill, 14 px 500 language code plus a 14 px chevron that points down and turns up while its menu is open.
  • QR knob (.cr-qr): opens "Open on another device".
  • Truncation: the crumbs truncate independently. At 375 px with the demo chip they become "Dawnlin… › U…". See Live audit.

Knob · styles/controls.css

  • 32 px circle, knob fill, 16 px icon.
  • Hover: +6% text. aria-expanded or open: +10%. Press: scale(.8).
  • Variants:
    • .back: chevron rotated 180°;
    • in link rows: 36 px, radius 10, transparent until hover.

Buttons · .btn

Variant Fill / text Weight Use
accent accent / white 600 The one primary action: Add this device, Reconnect, Open securely, Download (router)
tint accent 13% / accent 600 A card's Connect (quiet primary)
soft knob / text 500 Cancel, "Add it from the device", Show key, Copy, Start over
red bad / white 600 Remove
  • Size: 48 high (.sm 40, 15 px), pill, padding 0 20 (.sm 0 16), gap 8, .block = full width.
  • Press: scale(.95). No ellipsis, no blue text links for actions.
  • Busy: the button keeps its size. Its content blurs away and the orb comes up through the blur in the button's own colour. See Motion → Busy orb.

Field and go button · .field, .go

  • Field: 48 high, radius 16, field fill, padding 0 4 0 16. The input is 16/24 500 and the placeholder text-3. Focus: inset 1.5 px ring at text 16%, on SMOOTH.
  • Go button: 48 × 40, radius 12, at the field's end. Idle: knob / text-3, cursor: not-allowed. Ready: accent / white, the colours changing on SMOOTH. Press .9.
  • Arrow for create, check for save. The field and its go button are the whole form: no label row, no separate Save. Add a device's name field is not a login: no password manager offers itself there (data-1p-ignore).
  • Caret (ui/caret.ts, on both name fields: Add a device and the name edited on its card): the input's own is hidden (caret-color: transparent) and the field draws one as macOS does: accent, 2 × 20, radius 1. It glides to where the next letter goes (see Motion → Caret and selection), and a click puts it where clicked at once. It blinks 0.6 s on / 0.6 s off with soft fades, stays solid while typing and blinks again 0.5 s after the last key.
  • Selection (pointer: fine only): the native selection is see-through and the text keeps its colour. Under the text sits an accent 26% wash, 22 high, radius 4, with an iOS handle at each end: a 2 × 22 line with a 9 px knob, on top at the start and under it at the end. A selection grows out of the caret and, on collapse, fades in place before its ends rejoin the caret. It never runs past the input's edges, so a long, scrolled name's wash stops before the go button. On a touch screen the system's own selection and handles show, and the caret steps aside while one does.
  • What a name may hold (shared/name-guard.ts, both name fields, the admin's too): up to 20 letters of any language (with their marks), digits, spaces and - _ . (ordinary words reach about as far as the card's status line), as the router takes it; punctuation, symbols and emoji don't. A character outside that, or a 21st, never gets in: it is turned away as it is typed, pasted or dropped, and the field shakes at once, with no request to the router, while the red line under it (ui/bad-line.ts, the one the router's refusals use) says why in a few words: "Only letters, digits, - _ ." or "Up to 20 characters." (short enough for a card's status line, where a name edited in place says it). It goes with the next change that gets in. Emptying the field doesn't shake; Return or the go button on an empty name does, as does a name the router or the page refuses (one already taken). Names the page makes up (the kind, the phone's model) are in the page's language, stripped of what doesn't fit and cut to the limit ("Galaxy S24+" → "Galaxy S24").
  • Shake (shared/shake.ts): iOS's wrong-passcode shake, a damped swing sideways about four times in 0.52 s (14 px at most, settling by half), linear over its frames. The field's outline goes red with it (a 1.5 px inset ring in bad, as the focus ring is drawn), holds 0.7 s and fades back to the ring the field has (focused or not) over 0.8 s on ease-out; another refusal starts it red again. Another one starts from where the field is, never jumping back; only its own animation is touched, so the focus ring's transition goes on. With less motion asked for it doesn't move (the red line or toast still says why).

Notice · page/notices.ts

  • Layout: radius 24, padding 14 18 14 14, gap 14, a 36 px glass icon, a 15/22 500 title and a 14/20 text-2 line that adds to the title and never repeats it.
  • Tones: warn (orange) for paused, outside hours, server off, no server and ends soon. bad (red) for out of data and access ended.
  • Placement: one per page, above the columns, 22 px above them. Paused is not a notice: the whole page becomes the single card.
  • On a repaint a notice that comes blurs in, one that goes fades where it stood and one that changes morphs in place, while its slot glides to the new height. The page under it moves instead of jumping.

Section head

  • 20/28 500 title with a text-3 14 px 500 aside at the baseline: "3 of 4" in the page's numerals, warn when the admin let the person go over the limit.
  • Under the grid sits a note-s (13/18 text-3) for "You have reached your limit of N devices. Remove one to add another."

Device card · page/devices.ts

Anatomy:

  • Card: raised, radius 28, padding 8, gap 8.
  • Top row (padding 8 6 6 10, gap 12): a 32 px glass icon (blue on "this device", else grey), the name (16/22 500, one line), the status (13/18, one line, full wording in title), and the ⋯ knob.
  • Bottom, one of three:
    • Usage (field, radius 20, padding 12 14 12 16, min-height 66): "Last 7 days" 13/18 text-2 over the total 17/24 500 tabular. Spark of 7 bars at the right: 6 px wide, gap 4, ≤ 34 px high, min 3, radius 3, --bar, today in accent. Hovering a bar puts that day's name and bytes in place of the label and total instantly, with no morph.
    • Reconnect (instead of the week) when the settings changed or no data gets through ("Connected, but no data"): a tint block button with the refresh icon. New keys, then the set-up again. Not on a device never set up, a disabled one or a locked page.
    • Connect when never set up: a tint block button with the QR icon. It disappears when the admin locked the person.
  • A status is one line, and Reconnect or Connect takes the week's place. The button is lower than the week (48 against 66), so a card alone in its row is lower too; when its bottom changes, the card glides to its new height (see Motion → Repaint choreography).

Order: "this device" first, then online, then seen, then never set up, then disabled (byDeviceState). The grid keeps cards in place across repaints and glides them (FLIP).

Status line (the full matrix):

Condition Text Colour
Page opened through this device's tunnel This device accent (and the card gets the accent ring, the icon turns blue)
Disabled by the admin Disabled text-2, card at 50% opacity
Settings changed and it has connected before Settings changed warn (+ Reconnect)
Online while out of data Connected, no data left warn
Online outside the hours Connected, outside your hours warn
Its link fails in a named way (the router's watcher held it 3 min) Can't finish connecting · Connected, but no data · On two devices at once · Connection keeps dropping; why in title ("It reaches the router, but the connection never completes. The network may be blocking it.") and, for a screen reader, in hidden text right after the status warn (+ Reconnect for "Connected, but no data")
Online Connected ok
Never connected Not set up yet warn (+ Connect)
Otherwise Last connected 3 h ago (exact time in title) text-2

Menu items (⋯):

  • Copy IP address and Copy local address, only where the home network can reach the device;
  • a separator;
  • Rename;
  • Reconnect (warn tone);
  • Remove (bad tone).

A disabled device has no Rename, Reconnect or Remove. A locked page has no ⋯ at all.

Rename on the card (flows/rename.ts): the name is where it is changed. A name the person may change (not a disabled device, not a locked page) is a button: under the pointer a faint wash (raised + text 6%, radius 8) hugs its words, a click, Return or Space edits it, as Rename in the ⋯ menu does. Editing, the name gives way to its own input in the same font and place, with no frame or fill: only the field's caret and selection (the name selected). The status line morphs to "Return to save, Esc to cancel" in text-2 where there is a keyboard (a touch screen's Done key saves; there it stays as it was).

  • Return saves: the words shimmer while the router answers (see Motion → Shimmer), settle to solid, and the card is drawn again with the new name, the status morphing back from the hint, words and colour.
  • Esc or a click away puts the name it had back, whatever was typed; the status turns back.
  • What it won't take never gets in (see Field → What a name may hold): the words shake (no red ring here, the field has none) and the status line says why in bad, short enough for its one line ("Only letters, digits, - _ ."). An empty name ("Give the device a name.") and one another device of theirs has ("That name is taken.") are said here before asking the router; a refusal of the router's own says the same way, in full on hover. Typing again brings the hint back.
  • The page isn't drawn again under a name being edited.
  • Focus. The input takes focus in the same turn as the click, the key or the menu's item (iOS raises its keyboard only for a focus made inside the tap), with the whole name selected at once and again a frame later if iOS dropped it. Return (the screen's Done key too) and Esc give focus back to the name, the new one after a save, without its focus ring (that shows only when Tab brings focus there); a click or tap away leaves it where it went. Focus leaving for somewhere else in the page (Tab, iPad's hide-keyboard key) lets the edit go like a click away; leaving the window (another app or tab) keeps it.

Add card: a button.dev.add, min-height 144, centred, grey glass plus 36 and "Add device" in text-2 500. Hover raised + knob 45%, press .98. Gone when no slot is free or the page is locked.

First card (no devices yet):

  • spans the grid, padding 28 24 24;
  • blue glass plus 44, "Add your first device" 18/24 500;
  • one balanced 14/20 line (max 34ch);
  • an accent block button, max 320: "Add this phone" on mobile, "Add this device" otherwise.

Accordion · ui/accordion.ts

  • Row: raised, padding 0 8. Head 52 high, gap 10, with a 22 px glass icon, a 15/22 500 title (ellipsis), an optional chip, an optional value at the end (14 px text-2) and a 16 px chevron (pointing down, rotated 90°, and up when open).
  • Body: padding 0 8 16 40 (inset rows 0 8 16 8), column, gap 12.
  • One row open at a time. A still row (nothing to open) has no chevron, no hover and no click.
  • A row inside a row (the router's "Configuration" inside "Set it up again") keeps its own state: the open look (chevron, body, valHide) keys on the row's own head and body only.
  • valHide: a row whose body shows the same numbers drops its head value while open (blur, fade, slide 8 px right).
  • Inset variant (inside the sheet): rows on field, hover field + knob 50%. Inside them the app picker and badges step up to knob 65% over field, and a badge's hover goes to knob. The router's file step inside one steps up the same way: the file card and an inset row inside the row on knob 65% over field (that row's hover knob, the .conf it opens on knob), the card's icon and that row's soft buttons on knob + text 6% (hover 12%).

"Your access" rows · page/access.ts

Row Head Body
What it reaches (shield, home or globe glass) "Home network + Internet" / "Internet" / "Home network" Two reach tiles (radius 16, field, padding 12 12 12 14, glass 28, title 14/20 500, sub 12/16; a 20 px round mark at the top right: ok-soft check or knob minus, the tile dimmed when off). Then a sentence with the hostname pattern in mono, and name chips (32 high, radius 10, mono 13, the domain part in text-3, a copy icon 14; a click copies).
Data this month (chart glass; "Data used" for a total limit) A 16 px ring (track --bar, arc accent, warn ≥ 90%, bad ≥ 100%) and "38.6 GB / 100 GB" or "· no limit"; hidden while open The month: one bar per day (flex, gap 3, 64 high, radius 2.5, min 3; days to come at 45% bar; today accent), an axis 11 px text-3 with "Today" in accent under its bar (the month's ends hide when it comes close), the total line ("38.6 GB used" / "61.4 GB left", bad when out), a 6 px meter (same tone thresholds), and a .desc about the reset. Hovering a bar puts "X on 13 Oct" in place of the total instantly.
Access until (calendar glass) "30 Nov" plus "42 days" in ok, warn when soon, or "ended" in bad The until block (field, radius 16, padding 14 16): the days left as a 36/40 600 number (warn when soon), "days left", "Ends Mon 30 Nov" in text-3, and a calendar of the weeks to the end. 7 columns of 10 px cells with gap 5 and radius 3: past at text 5%, left at text 16%, today in accent, the last day ringed 1.5 px accent; warn colours when soon. Under it the hours bar when set: 8 px track, the allowed window in ok 70%, a 2 × 16 "now" marker (text, warn when outside, with a 2 px field ring), and axis 00/06/12/18/24 at 10 px. Without an end date and hours, the row is still.

The data row is open by default. A repaint keeps the rows on the page and changes what they hold in place, the same row open (see Motion → Repaint choreography). Only rows of another shape (an end date set or taken away) are built afresh.

Sheet · ui/sheet.ts

Shape: raised, radius 36, --sheet-shadow, overflow: hidden.

Width Form
< 760 Drawer floating 16 px from the left, right and bottom edges (plus safe areas), max-width 400, max-height 100% − 32 − safe areas
≥ 760 Dialog centred by flex layout (not a transform, so text stays on the pixel grid), width 100% − gutters, max-width 400

Width plan. On a computer the sheet widens for a dense QR code (an AmneziaVPN key) until the code gets about 3.2 px per module (+80 px padding), capped by the viewport. Live: 400 → 448 for a key, 400 → 410–422 for a .conf. It then scrolls the code fully into view.

Inside:

  • ×: a knob pinned at top 22 / right 22.
  • Pinned keys: a view's own buttons, pinned at top 22 / right 58.
  • View: padding 0 24 24.
  • View head (.vhead): 76 high. Title 20/28 500, centred with a Back knob inside a flow. The head is the drag handle, with touch-action: none and a grab cursor.
  • Sub line: 14/20 text-2, pulled up 16 px under the head. In the set-up sheet it shows only while waiting (see Set-up sheet → Around the way).

Behaviour:

  • Views stack. go() pushes and back() pops. The sheet glides to each view's height.
  • Closes by: ×, the scrim, Escape (instant), the phone's back button (the sheet is a history entry), or a pull down on its head. Focus returns to the opener.
  • A double click that opened it: clicks in the sheet are ignored for 320 ms, so its second half neither closes it nor answers its question.
  • A flow that comes while it closes (an answer after Cancel) opens once it is gone. Escape while it closes ends it at once, and nothing opens after it.
  • Labels: role="dialog" named by the view title, or alertdialog for questions.

Pinned keys (.hpill, a phone or tablet set up from elsewhere): Download and Copy for the picked app's config, each 38 × 32, joined.

  • Tooltip: one 26 px pill in toast colours under the keys. It appears after 420 ms of hover, then follows the pointer (or Tab) from key to key at once, gliding from where it stands, and says "Copied" after a copy. Back on a key while it still fades out, it turns back from there.
  • On arrival: when the device connects, × and the keys step away (settle(), .arrived). If it leaves that state (no data after all, or gone again) they come back (settle(false)).

Question view (.ask: Reconnect, Remove):

  • left-aligned, as iOS asks now, with 24 px top padding;
  • a 64 px glass icon in the action's tone, a 20/28 500 question and a 15/21 text-2 paragraph;
  • two equal buttons: Cancel (soft) and the action (accent for Reconnect, red for Remove);
  • no × beside them.

Secure view (plain HTTP): centred lock glass, "Open securely" (accent, a link to the HTTPS twin in the same tab), and an honest note about the router's own certificate.

⋯ Menu · ui/menu.ts

Panel: position: fixed, min-width 224, padding 6, radius 20, field fill, --pop-shadow plus an inner 1 px --line.

Items: 40 high, radius 14, padding 0 12, gap 12, 14 px 500, a 16 px icon in text-2. Tones: warn (Reconnect) and bad (Remove) colour both text and icon. Separators are a 1 px line with 6 12 margin, kept only between items.

Highlight: one knob pill behind the items that glides after the pointer and takes the item's tone (bad-soft, warn 13%).

Options: an option list (language) shows a check on the current item and keeps an invisible check on the others so the names line up.

Placement: under its button, right-aligned, 8 px away, or above it where the screen ends. It grows out of the button's corner.

Closes on: a press outside, scroll, Escape (instant), its button again, or another menu opening.

Toast · ui/feedback.ts

  • Bottom centre, 24px + safe-area from the bottom, one at a time; a new one replaces the shown one.
  • 42 high pill, padding 0 18 0 13, 14 px 500, an 18 px icon (check in ok, alert in bad).
  • 2.4 s on screen. Used for every result and every failure ("Device removed", "Address copied", an error message).

App picker · ui/seg.ts

  • Track: 48 high, radius 16, field, padding 0 4.
  • Items: icons only (20 px) at 56 px each. The picked item takes the remaining width (flex-grow) and shows its name.
  • Pill: 40 px, radius 12. It stretches like skiper21's tabs: the leading edge reaches the new item first and the trailing edge follows.
  • Item colours: idle text-3, hover text-2, picked text.
  • Apps by disguise: AmneziaVPN and AmneziaWG, plus WireGuard only when the server's disguise is off. Routers never get AmneziaVPN. The last app picked per device is remembered in localStorage.

Kinds picker · flows/add.ts

  • Tiles: four in a grid (--n columns, gap 8): PC, Mobile (phones and tablets are one choice), Router, Other. Each is 56 high, radius 14, field.
  • Icons and labels: a 26 px blue glass icon, greyscale at 55% opacity until picked. The label sits under the tile at 12/16 500.
  • Picked: the tile gets an inset 1.5 px accent ring in place, without travelling between tiles. Hover → knob, press .94.
  • Defaults: the kind and the name are guessed from the browser (iPhone, iPad, a Samsung model through Client Hints, Mac, Windows PC…), deduplicated with " 2", " 3".
  • Back from "Add it from the device" brings the view back as they left it: the kind, LAN Bypass and a name they typed.
  • Under them: the LAN Bypass option row, 16 px under the kinds and 12 px above the name field (see Option row). No note sits between them any more (the packet-size note is gone).

Option row and switch · .swrow, .sw (flows/add.ts)

One choice with a switch: Add a device's LAN Bypass ("Your local network stays reachable while connected."). Off by default. With home and internet access, switching it on unfolds a third line, "Except 192.168.1.x: those addresses lead to the home network." (the server's home networks, server.home; a /24 reads as "x"): height, opacity and blur on SMOOTH from where the line is, so flicking the switch never snaps, and the row, what follows and the sheet ride along. The admin's drawer says the same ("On, except 192.168.1.x (home)"), and Health warns when a home network is one of the common out-of-the-box subnets. After the device is added it stays as chosen: the admin's drawer shows it ("set when it was added"), and neither the portal nor the admin UI changes it.

  • Row: the whole row is the switch (button role="switch", aria-checked). field on the raised sheet, radius 16, padding 12 12 12 14, gap 12.
  • Icon: the lan glass at 28 px, blue. Grey while off (grayscale(1) at 55% opacity), on SMOOTH.
  • Words: the title 15/22 500 −0.015em over a 13/18 text-2 line, gap 1.
  • Hover: field + knob 50% over 200 ms. No press shrink.
  • Switch: a 44 × 26 pill on knob, accent when on. Its knob is 20 px, 3 px in, text-2 (on: accent-ink), and moves 18 px. Held down, the knob stretches to 27 px toward where it goes (from the left when off, toward the left when on) and finishes the move when let go, as iOS switches do. Track colour, knob travel, width and colour all run on SMOOTH.

Badge · flows/setup-parts.ts

  • 60 high, radius 18, field, padding 0 14 0 12, gap 12.
  • A 36 px icon tile, radius 10, inverted (text fill, raised mark).
  • Two lines: top 12/16 text-2, main 15/20 500.
  • A 16 px trailing mark: chevron for an action, "open" for a store page in a new tab.
  • .primary (the one thing to tap in step 2): the icon tile is accent-soft / accent.
  • .badges2: two side by side (Android's Google Play beside the APK), no trailing mark.
  • Inside an inset row (the steps on the device itself folded into "Set it up again"): knob 65% over field, hover knob, one step above the row.

Set-up sheet · flows/setup-view.ts

The layout follows where the page is open:

Layout When Content
same The page is on the device being set up (another device, a TV or a box, when the page came from its own set-up link) "Not on the X right now?" inset accordion (opening it folds the steps away), then 1 Get (picker + store badge) and 2 Add the connection (primary badge: a vpn:// link, the share sheet, a key to copy or a file to download, plus a "how to" path)
away A phone or tablet set up from elsewhere Inset accordion: "Open your link on the phone" (QR of the set-up link + link row) / "Already has the app" (picker + the connection as a QR + scan line; where the key or the configuration is too long for a code, the set-up link's code and one line saying so instead, in the picked app's words), open by default; pinned Download / Copy keys
pc-away A computer set up from elsewhere, or another device (TV, box, NAS) added from a phone "Open your link on the computer" / "Copy or save the connection" (picker + two small soft buttons)
router A router 1 Get AmneziaWG on the router (OpenWrt packages badge), 2 Import the configuration (file card with Download / Share, plus a "Configuration" inset row with Show key / Copy and the .conf, keys masked)

Steps: a 24 px round number (knob, 13 px 600), a 16/24 500 title and a body with gap 10. Steps sit 20 px apart.

"How to" path: Open AmneziaWG › + › Import Tunnel(s) from File… in 13 px text-2, the app's own words in text 500, quoted verbatim from each app in each language.

Scan line: "In WireGuard: + › Create from QR code". Where iOS and Android name a step differently, that word alternates every 3 s, with the or Android mark beside it.

The way (waiting for the first connection), on top of every layout. Its state is read off the device in each poll's answer (way.ts, from the router's setup); it has no buttons.

  • Block: field, radius 20, padding 12 14, 18 px above what is under it in every state.
  • Ends: two 34 px rounded squares (radius 11): the device icon in knob, and the server in accent tint.
  • Track: a dotted line between the ends (1.4 px dots every 9 px, text-3 at 80%).
  • Lines under it: the line (14/20 500) and, in the states that need one, a second line (13/18 text-2).
State When The way Lines
Waiting Nothing heard yet, or gone quiet, offline or removed again A light runs along the track and rests a beat "Waiting for the connection"
Can't finish (.trying) Its knocks reach the router and no handshake follows The light turns warn, runs almost to the router and falls back (way-knock). A 2 × 18 warn break, tilted 18°, flashes at the router (way-break). The router's end turns warn 14%. "Unable to complete the handshake" (warn) / "Your network may be blocking the connection."
Connected (.done) A handshake newer than the sheet, and data flowing The track fills green from the device and the server end turns green last with a pop " connected" (green)
No data (.nodata) A handshake newer than the sheet, but nothing in except handshakes and keep-alives (an outdated configuration) The track is green and both ends too (the router's 600 ms after). Two 8 px warn packets, with a soft warn glow, take turns falling through midway (way-drop). "Handshake complete, but no data" (warn) / "This device is using an outdated configuration."
Given up (.stopped) 10 minutes without connecting The light goes out "No connection yet" / "Close this and open it again to keep checking."

Arrival is data flowing, not the first handshake, so no data shows instead of the sheet closing. Gone back to waiting, the way says nothing more: no second line.

Around the way (follow() in flows/wait.ts):

  • The sub line ("Two steps, about a minute") says what setting up takes, so it shows only while waiting. In every other state it folds away with its margins and the way sits right under the head, as in a sheet with no sub line. It comes back with waiting.

  • Connected: × and the pinned keys step away (settle()), the sheet scrolls back to the top, everything under the way folds shut with the way's 18 px gap, and the sheet closes onto the page after the reading time.

  • Any other state undoes that: × and the keys come back (settle(false)), and what folded unfolds straight into the new shape.

  • On the device itself (same) and for a router, the steps follow the way (regroup() in flows/setup-view.ts):

    • can't finish: one closed inset row, "Set it up again" (refresh glass, blue). On the device itself it holds both steps. A router that knocks has AmneziaWG on it already, so its row holds only the file step (no number, no title of its own);
    • no data: one open inset row, "Add the connection again" ("Import the configuration again" for a router), holding only the connection step (no number, no title of its own);
    • "Not on the X right now?" (the device itself only) hides in both: the device is in hand;
    • waiting: the steps as built;
    • connected: what shows stays as it is while everything under the way folds shut.

    Inside the row what sat on field steps up one (Accordion → Inset variant). The layouts set up from elsewhere have rows, not steps, and keep them as built. When focus is inside what moves (a badge just used), it stays in the sheet: on that control where it still shows, else on the head of "Set it up again" or the first control of what now holds the steps.

  • QR: 148 px (radius 18) beside its words (gap 14). Big: 208 (radius 24). Dense: full width, square, radius 22, words under it.
  • Link row: 44 high, radius 14, the URL in mono 13 without its scheme (ellipsis, user-select: all), then copy and, where the browser has it, share.
  • A code that changes cross-fades in place: the new one comes in first, so the place is never empty; a code of the other size scales the box to its own.
  • A code too long to scan (over about 1.6 KB, e.g. an AmneziaVPN key where the browser cannot compress it, or a LAN Bypass configuration with its long list of networks) gives its place to a stand-in: another code and words that say why (they change with the picked app). The row's own words come back with a code that fits.

File card and configuration

  • File card: field, radius 18, padding 12. A 38 × 46 "file" icon (radius 9, mono 10 600 ".conf"), the filename in mono 13, "For computers and routers" at 12 px, and an accent sm block button. Inside an inset row it steps up one (Accordion → Inset variant).
  • Configuration: pre 12/18 mono, max-height 16 rem, scrolls.
    • colours: section headers in accent, keys in text, values in text-2;
    • PrivateKey and PresharedKey are masked (•••• in text-3, letter-spaced 1 px) until "Show key". The mask and the key share one place and cross-fade; the one at rest is out of sight, so a selection of the .conf never takes a hidden key.

Glass icon catalogue · ui/glass.ts

phone, mobile, tablet, computer, router, other, plus, globe, home, shield, chart, calendar, clock, pause, server, link, key, lock, check, trash, refresh, app (AmneziaVPN mark), file, lan (three devices joined: the LAN Bypass row). An unknown name falls back to other.

Demo-only pieces · demo/ (not in the router build)

  • "Demo" chip after the crumbs (26 high, accent-soft, 13 px 600).
  • GitHub pill before the language pill (hidden below 480 px; a button in the drawer instead).
  • Scenario drawer: grouped rows on field, 2 px apart inside a radius-20 group, 60 px min, glass 30; the current row in accent with a check.

Do's and Don'ts

Do

  • Build from the existing classes and tokens (--bg … --knob, --text-2/3, .btn variants, .knob, .acc, .field, .badge, .seg, glass icons). A new class uses the same tokens.
  • Step surfaces up in brightness: a block inside raised is field, a control on field is knob.
  • Keep the accent for the one primary action and for "you are here". Use tone colours only for their states.
  • Say a state once, where it matters, in its colour. One notice per page.
  • Put numbers in .num, hostnames and links in mono, and one-line names with title.
  • Make every changing text go through morphText, and every appearing block through a blur-in (see Motion).
  • Translate in the same change and check the Russian at 375 px.
  • Respect the CSP: no style= attributes. Set styles through el.style and colours through classes.

Don't

  • Add borders or dividers to separate surfaces (the "OR" divider and the menu separator are the only lines).
  • Add shadows to resting cards, or more than one shadow to a floating layer.
  • Use blue text links for actions. Use buttons and pills.
  • Put an ellipsis on a button or menu item.
  • Use the accent for decoration, or a new hue for anything.
  • Animate with ad-hoc durations and curves. Use the springs and the two eases (see Motion → Drift).
  • Animate in response to the keyboard (Escape), or rely on motion to convey a state.
  • Use --text-3 for text a person needs to read (see Contrast).

Motion Design

Philosophy

Motion in the portal does three jobs:

  • Continuity. Things move from where they are to where they go: cards glide, sheets glide to their new height, letters slide.
  • Causality. A response grows out of what caused it: a menu from its button, a dialog from its centre, a toast from below.
  • Calm feedback. The orb shows waiting, the check shows a copy, the green way shows a connection.

It never decorates, never loops without a reason (the only loops are the busy orb, the way's light, its knock and falling packets, a focused field's caret and the OS alternation, each tied to a real state), and never blinks: nothing is torn down and redrawn in sight. The caret's blink is the system's own beat for a field that has focus, not a redraw.

Six rules hold everywhere:

  1. Springs, not durations. Layout motion runs on physical springs (stiffness, damping, mass 1), sampled into CSS linear(), so CSS transitions and script animations share one curve.
  2. Exits are quick, entrances are soft. Exits use an ease-in curve and run 120–220 ms. Entrances use ease-out or a spring and run 280–572 ms. In a cross-fade the incoming part waits 60–110 ms so the two overlap in the blur.
  3. Blur is the transition medium. Things appear and disappear through filter: blur(2–6px) with opacity and a small scale (.86–.96) or a few px of travel. Large travel is reserved for the drawer (translateY(100% + 40px)) and the FLIP of cards.
  4. Interruptible from the present. Every new animation starts from the computed current state (getComputedStyle, a morph's live width, the pill's current edges, a live rect) and cancels the old one only after the new one is in place. Turned back half-way (a double click, a quick second pick), nothing starts over from fixed keyframes, and a fade runs only what is left of its way.
  5. The keyboard never animates. Escape closes menus and sheets instantly.
  6. Reduced motion keeps fades, drops travel. See Reduced motion.

The engine · motion.ts

spring(k, c, m = 1)   // closed-form damped harmonic oscillator; under-, critically and over-damped branches
                      // duration = time until it stays within 0.15% of the end (sampled every 4 ms, ≤ 3 s)
                      // easing   = CSS linear() with 65 points; at(ms) = progress for script-driven motion
publishSprings(root)  // --spring-{bouncy,smooth,soft,quick} and --spring-*-dur on <html> for CSS transitions
play(el, frames, o)   // el.animate() with the reduced-motion policy
rubber(dist, dim)     // (1 − 1 / (dist·0.55/dim + 1))·dim: resistance that grows with the pull
unrubber(d, dim)      // rubber() undone: the pull that puts an edge d past it (a sheet taken while it settles back)
dismisses(dy, v, h)   // a pulled sheet goes on a flick down (v > 0.4 px/ms) or past h/3; never on a flick back up (v < −0.1)

Animations from script go through play() (WAAPI). Hover and press states are CSS transitions. Loops and one-shots are CSS keyframes (orb-converge, orb-breathe, way-run, way-knock, way-break, way-drop, way-dip, way-pop, caret-blink, cal-in). The field's caret and selection run a per-frame spring of their own, not spring() (ui/caret.ts, see Caret and selection).

Springs

Computed from spring() and confirmed live: the published CSS variables read 572, 524, 476 and 296 ms.

Token k / c ζ Settles Overshoot 50% at 90% at Peak at Used for
BOUNCY 300 / 20 0.58 572 ms 10.8% 78 ms 133 ms 222 ms Toast in, a newly created device card popping in and the way's server icon pop
POP 520 / 24 0.53 544 ms 14.3% 58 ms 96 ms 162 ms ⋯ menu open, check icon after copy, the OS mark turning in
SOFT 380 / 28 0.72 476 ms 3.9% 74 ms 138 ms 232 ms Accordion rows and chevron, dialog open (computer) and its scrim
SMOOTH 300 / 35 1.01 524 ms 0 98 ms 228 ms — Widths and heights (morph width, sheet height glide, sheet width, a card's and the notice's height on a repaint, the QR box's size), FLIP of cards and letters, picker pill trailing edge, flex-grow and the picked name's width, folds, tooltip glide, snap-back after a pull and its dim; the switch, the field's focus ring and the go button's colours (via CSS var)
LEAD 520 / 46 1.01 396 ms 0 74 ms 173 ms — Leading edge of the stretching picker pill
QUICK 900 / 60 1.00 296 ms 0 56 ms 130 ms — ⋯ menu highlight following the pointer

"Settles" is the whole curve, but the motion reads as done at the 90% mark. That is why a 572 ms BOUNCY toast feels like ~200 ms.

Curves and durations

Name Value Role
EASE_OUT (--ease-out) cubic-bezier(.23, 1, .32, 1) Entrances, hover and press transitions, folds of a finished step
EASE_IN cubic-bezier(.55, 0, 1, .45) Exits: menu, toast, dialog close, busy content out, ghosts
DRAWER cubic-bezier(.32, .72, 0, 1) The phone drawer, up 500 ms and down 420 ms (Vaul's curve)
ad hoc cubic-bezier(.2, 0, 0, 1) Sheet view swap and pinned keys (see Drift)
ad hoc cubic-bezier(.25, 1, .5, 1) Sheet height on a view swap, 360 ms (see Drift)
ad hoc cubic-bezier(0, 0, .58, 1) Accordion body fade-in, 300 ms
ease-out / ease keywords — Drawer scrim (420 in / 320 out), tooltip hide, arrival ring, hover background colours

The duration ladder in use is 100 · 120 · 140 · 150 · 160 · 180 · 200 · 220 · 240 · 260 · 280 · 300 · 320 · 340 · 360 · 380 · 400 · 420 · 500 · 520 · 700 · 900 · 1200 · 1800 · 2200 ms, plus springs. Below 200 ms means feedback or exit, 200–400 ms means entrance or cross-fade, ≥ 500 ms means travel or a one-time moment.

Hover and press (CSS transitions)

Element Press Hover Timing
.knob scale(.8) bg +6% text 150 ms ease-out (transform), 150 ms (bg)
.btn scale(.95) accent 82% / tint 20% (active 24%) / soft +6% (in a row nested in an inset row: +12%) 200 ms ease-out (transform, bg, colour)
.go.ready scale(.9) — 200 ms ease-out (transform); colours SMOOTH 524
.kind tile scale(.94) knob 200 ms (bg, transform), ring 220, icon colour 260
.badge, .dev.add scale(.98) knob / raised+knob 45% 200 ms
.namechip scale(.96) knob 150 ms
.upd-pill, .cr-lang, .hp-b, demo chip / GitHub scale(.94) +6% / tone 22% 150 ms
Accordion row — raised+knob 40% (inset: field+knob 50%; nested in an inset row: knob) 150 ms
.swrow (option row) none field+knob 50% 200 ms
Switch knob (.sw) held: stretches 20 → 27 px toward where it goes — SMOOTH 524 (travel, width, colour)
Picker item — text-3 → text-2 200 ms colour
Spark / month bar — --bar → text-2 (today: accent+text 25%) 150 / 120 ms
Field — focus ring inset 1.5 px SMOOTH 524
Language chevron — rotates 90° → −90° while open 200 ms ease-out

Catalogue: every animation, measured live

Notation:

  • in and out are opacity transitions;
  • b4 means filter: blur(4px);
  • s.9 means scale(.9);
  • y10 means translateY(10px);
  • timings are duration / delay.

1. Page intro (first paint, once per visit)

What From → to Timing
Each block (crumbs, notice, section heads, each card, the limit note, each access row, the gone card), in the order they stand on screen (top to bottom, then left to right), from the first one on screen opacity 0 → its own opacity, y10 → 0, b4 → 0 520 / 60 + 40·i, EASE_OUT, fill backwards
The sun of the logo translateY(7px) → 0, clipped above the horizon bar: the sun rises 900 / 150, EASE_OUT

A disabled card rises to its own 50%, not to 1. On a phone the wave runs from the crumbs through "Your access" and its rows down to "Your devices" and the cards. The first block on screen always rises at 60 ms: a reload that goes back deep into the page starts the wave there, and the blocks above it rise with it.

2. Repaint choreography (the page after a change)

What Motion Timing
Cards that stay but moved (FLIP) translate(Δx, Δy) → 0 (live: ±315 px sideways, (−315, 154) diagonally), measured before the notice and, on a phone, "Your access" above them change SMOOTH 524
A card whose height changes (Connect ↔ its week, a row that no longer stretches it) height old → new, what it holds clipped on the way; a bottom of another kind crosses: the old one fades where it stood (out, b4, 180 EASE_IN) as the new one blurs in (280 / 60, EASE_OUT) SMOOTH 524
A device just created (pop) in, s.9 → 1, b6 → 0 BOUNCY 572
A card that newly shows (Add card after a removal, the first card) in (to own opacity), s.9, b6 SMOOTH 524 / 60
A card no longer there (Add card once the last slot is taken) fades where it stood, out, b4 180, EASE_IN
A device that just connected (flash) inset 1.5px var(--ok) → the card's own ring (this device's accent ring, else none); a repaint while it fades carries it on 1800, ease-out
Changed texts on cards and access rows (data-t keys) letter morph (see 3); a status that takes another colour: the old letters keep the old one, the new turn from it colour 280, EASE_OUT
The count "3 of 4 → 4 of 4" letter morph —
Limit note appears in, y6 → 0, b4 → 0 420, EASE_OUT
Limit note leaves (a slot freed) out, b4 from where it stands while its space folds (height, margin-top → 0), then hidden; with less motion it fades, then goes with its space 200, EASE_IN; the fold SMOOTH 524
Limit note that stays glides with the cards when one came in above it SMOOTH 524
A removed card leaves (before the repaint) out, s.9, b6 220, EASE_IN, then the repaint glides the rest
The notice comes: blurs in (280 / 60, EASE_OUT); goes: fades where it stood (out, b4, 180 EASE_IN); changes: morphs in place (see 3). Its slot glides to the new height and clips it on the way. SMOOTH 524
"Your access" rows stay on the page: keyed values morph (one already turning into the same words goes on), a head swaps only what changed, and an open body refills in place (morphInto: a value that crosses fades with its old words, the new one blurs in) while its row glides to its new height (a row still opening or folding heads for it instead). The calendar's days don't come in again; a body whose days are still coming in changes once they are in. SMOOTH 524

3. Text morph · ui/morph.ts

Every text that changes in place while visible morphs. Hover readouts over chart bars are the deliberate exception and swap instantly.

Letter mode (default):

  • Kept letters slide. The letters both texts share stay and slide to their new places (SMOOTH 524). They are the common prefix and suffix plus the longest common subsequence in between.
  • Old letters lift away: out, y −0.45em, b4, 220 ms EASE_IN, stagger min(12, 160/n) ms.
  • New letters rise in: in, y +0.45em → 0, b4 → 0, 380 ms EASE_OUT, delay 120 + i·min(22, 260/n) ms.
  • Width glides from the old text's width to the new one's on SMOOTH, so what follows never steps. The old letters are pinned to the edge that stays put: the start, the end of a right-aligned value, or the middle of a centred line.
  • Kerning correction: each letter is nudged onto the plain text's kerned position, so the last frame lands exactly on the final text.
  • Done: at the end the element holds plain text again, and an ellipsis box keeps its ellipsis.

Whole mode (whole: true, for words in a flowing sentence, app names, menu paths): old words out, b4 180 ms EASE_IN, new words in, b4 → 0 280 / 60 EASE_OUT.

Colour (morphChanged after a repaint): a text that takes another colour with its words (a status turning green) keeps the old colour on the words that leave, and the new words turn from it (280 ms EASE_OUT).

morphInto(box, kids) refills a whole box without a blink:

  • unchanged pieces stay still;
  • a piece with new words morphs where it stands (whole mode, up to 40 characters);
  • a keyed text (data-t) with new words is left to morphChanged, which letter-morphs it;
  • a piece that changed kind, height or drawing crosses: the old one is pinned where it stood and fades b4 over 180 ms, from how it showed, while the new one blurs in (280 / 60); what came in whole is not morphed again (morphChanged skips it);
  • pieces that only moved glide on SMOOTH.

Interrupting: a morph under way is not cut short. The next one starts from what shows: the words that were coming in leave from as far as they came (a letter both texts keep slides on from where it is), the words still leaving go on leaving, and the width carries on from its on-screen width. Asked again for what it is already turning into, the morph just goes on. A morphInto refilled again half-way does the same: what was fading goes on fading where it is, and what was still coming in goes on from as far as it came. No morph runs for reduced motion or for an element that is not on screen.

Live examples:

Change What ran
"iPhone 16" → "iPhone 16 Pro" 4 letters rise at 120, 142, 164 and 186 ms
"Connected" → "Not set up yet" 5 kept letters slide, the rest lift and rise
"Waiting for the connection" → "iPad Air connected" 14 out at 11.4 ms steps, 11 in, width 168 → 156 px
Tooltip "Download …" → "Copy … config" 19 kept letters slide ≈ 12–15 px

4. Accordion

What Motion Timing
Every row whose shape changes height, margin-top/bottom, four radii from the measured "before" to the "after" SOFT 476
Body of the opening row from where it stands (opacity 0, b2 when shut) → 1, b0 300 × what is left of the way, cubic-bezier(0,0,.58,1)
Body of the closing row from where it stands → opacity 0, b2, kept displayed (.closing) until the row finishes, also when another row is clicked meanwhile 160 × what is left, EASE_IN
Chevron rotate(90°) → rotate(−90°) SOFT 476 (CSS var)
Head value (valHide) out, b4, translateX(8px) 200 (opacity, blur), 260 (transform), EASE_OUT
Calendar cells when "Access until" opens cal-in: opacity 0, scale .4 → 1; .opened stays until the row has shut, so a row opened again before then carries on its cascade 360 / 7·i ms (49 cells ≈ 700 ms total), EASE_OUT

On open the neighbours' facing corners round at the same time, so the open row lifts out of the stack rather than splitting it. Inside the sheet the accordion plans the sheet's width first, so a dense code that comes into view gets its width on the same frame. On the page a fold near the foot takes the page down with it (see Layout → Scroll).

A click mid-way (a double click) turns every row and body back from where it stands. When content changes under a height glide that is still heading for an old end (a row inside a row, a pick while its row opens, a fold inside a row), that glide is re-aimed from where it stands to the new end on its own curve (regrow() in ui/accordion.ts). The sheet needs none of this: its height follows its view (see 5. Sheet → Content glide).

5. Sheet

Open and close:

Context Element Motion Timing
Computer (≥ 760) open sheet in, s.9 → 1, b4 → 0 from its centre SOFT 476
scrim in SOFT 476
Computer close sheet from its present fade, blur and scale: out, s.96, b3 into its centre 120, EASE_IN
scrim out 120, EASE_IN
Phone open sheet translateY(calc(100% + 40px)) → 0 500, DRAWER
scrim in 420, ease-out
Phone close sheet from its current transform → translateY(100% + 40px) 420, DRAWER
scrim from its current opacity → 0 320, ease-out
Escape, or a link that stopped working everything gone at once 0

View swap (go, back, a new flow in an open sheet):

Element Motion Timing
Old view (pinned absolutely where it stands, inert; one already leaving keeps its fade) from how it shows (one still coming in, from as far as it came) → out, s.96, b2 200 × its opacity, cubic-bezier(.2,0,0,1)
New view in, s.96 → 1, b4 → 0 280 / 110, same curve
Viewport height old → new, following the view (live: 297 → 830, 430 → 638) 360, cubic-bezier(.25,1,.5,1)
Sheet width 400 → 448 for a dense key SMOOTH 524
Pinned keys old out s.9, b3 180; new in s.9 → 1, b3 → 0 260 / 110
Clicks on the new view ignored for 320 ms, so a tap meant for the old button doesn't press the new one —

Content glide (glide(), a pick that changes a view):

  • the viewport height glides on SMOOTH, as a gap (or overhang) under the view that closes, so whatever changes inside meanwhile (a row opening, a fold, a poll) carries the sheet's edge along;
  • every element that moved inside glides from its old place (outermost only) on SMOOTH, added to a glide still under way, so a quick second pick takes it on from where it is;
  • blocks named as changed blur in (280, EASE_OUT).

Pull to close (phone, by the head):

  • downward drag follows the finger 1:1, and the scrim fades by 1 − dy/420;
  • taken while it still rises or settles back, it is caught where it stands, the dim with it;
  • upward drag resists by rubber();
  • release closes on a flick (> 0.4 px/ms) or past a third of the height. Live, a 250 px pull closed from scrim .40, and a fast 50 px flick closed from scrim .88.
  • otherwise the sheet and its dim go back on SMOOTH (a touch that never moved only lets it settle).

Arrived (.arrived) and question (.asks): × and the pinned keys go out, b3, scale .9 over 240 ms EASE_OUT and stop taking clicks.

6. ⋯ Menu

What Motion Timing
Open in, s.9 → 1, b4 → 0, origin at the button's corner (top right, or bottom right when above) POP 544
Close from where it stands (one still popping in included) → out, s.96, b3 120, EASE_IN
Highlight appears opacity at the hovered item 150, EASE_OUT
Highlight moves translateY to the next item; colour to its tone QUICK 296; bg 150
Highlight leaves opacity 0 when the pointer leaves the menu; back on an item while it still shows, it turns back and glides from where it stands 150

QUICK replaced SMOOTH for the highlight because SMOOTH felt late: it reaches 90% at 130 ms against SMOOTH's 228 ms.

7. Toast

What Motion Timing
In in, translateY(18px) scale(.9) → 0, b6 → 0 BOUNCY 572
Dwell — 2400 ms
Out out, translateY(6px) scale(.96), b4 180, EASE_IN
Replaced by a new toast from where it stands (one still rising included) → out, s.96, b4, while the new one comes in over it 140, EASE_IN

8. Busy orb · ui/busy.ts, controls.css

The orb is aicss.dev's Orbs B4 Converge at its 28 px stage, twice its speed, drawn in the button's own colour.

What Motion Timing
Click: content out out, s.86, b5 180, EASE_IN
Orb in in, s.6 → 1, b5 → 0 340 / 70, EASE_OUT
Minimum hold a quick answer waits until the orb is fully in (BUSY_IN = 410 ms), so it never flickers —
Answer: orb out / content back mirror of the above, starting from where each stands 180 / 340 + 70
Pressed again while the orb leaves the orb turns back from where it stands, at once 340, EASE_OUT
Orb loop: front dot (7 px) walks a triangle (top → bottom right → bottom left). It rests 10% at each corner, leaves ease-in (.55,0,1,.45), arrives ease-out (.33,1,.68,1), and is scale .72, blur .8 between corners. 1.8 s, linear keyframe timeline
Orb loop: back dot breathes in the centre: opacity .16 ↔ .32, blur 2.4 ↔ 1.6, scale 1.2 ↔ .98 1.8 s, ease-in-out

The orb starts on the click itself (a 250 ms "only if slow" delay was tried and rejected). The button stays disabled until the answer, which also guards against double submits. contain: strict keeps the loop off layout.

9. Copy feedback

The control that copied says so for 1.6 s:

  • its icon swaps to a check (POP 544, from s.6, b3), and back the same way;
  • its "Copy…" label morphs to "Copied" and back;
  • a toast says what was copied;
  • in the pinned keys, the tooltip glides and rewords to "Copied" (SMOOTH).

10. App picker stretch

On a pick:

  • Edges: the pill's two edges are driven per frame by spring.at(t). The leading edge (toward the new item) runs on LEAD (396 ms) and the trailing edge on SMOOTH (524 ms), so the pill stretches toward the target and then contracts.
  • Width shares: items change flex-grow 0 ↔ 1 on SMOOTH. Shares of the track, not pixels, so they stay right while the sheet's width changes.
  • Labels: the old label collapses (max-width → 0, margin-left −8, out, 220 ease-out) while the new one opens to its width with its item's share (SMOOTH) and blurs in (280 / 70, EASE_OUT), always inside the pill. Picked again half-way, each name goes on from where it stands, one still folding included, over what is left of its way (labelFade).
  • What follows: everything the pick changes morphIntos in place (step title, store badge, step 2, the code) and the sheet glides.

11. Kinds picker

The ring does not travel: the old tile's ring fades and the new tile's ring draws in place (box-shadow 220 ms). The icon desaturates or saturates (260 ms) and the label colour changes (200 ms). The name field updates without motion while untouched.

12. Codes and words

What Motion Timing
A new QR in the same box new in under them all first (200, EASE_OUT); old laid over it goes out (220 / 110, EASE_IN); each from where it stands. Nothing changes its place in the stack: a code turned back to fades up again where it lies (200 × what is left), what lies over it goes, and what lies under it goes once it shows whole the box is never empty
A code of the other size (dense ↔ not, e.g. the stand-in link) the box scales from its size on screen to its own (from its top left, corners kept), the codes with it; the words glide to their new place SMOOTH 524
The same code for another app (WireGuard ↔ AmneziaWG take one file) only the words change —
Words beside a code new in, b3 → 0 220 EASE_OUT; old out, b3 from where they stand, 200 / 90 EASE_IN —
Scan line, another app app name and each path part morph whole; the OS mark grows or shrinks (width 0 ↔ 1.05em, b3) SMOOTH; mark out 220 × the width it has left, from where it stands
Scan line, OS alternation (every 3000 ms while on screen) the differing word letter-morphs; the old mark out, scale .5 rotate −40°, b3 (200, EASE_IN); the new one turns in from scale .5 rotate 40° POP 544 / 80

13. Waiting for the first connection · flows/wait.ts

While waiting: the way's light (way-run) is a gradient band masked to the dots. It travels from −70% to +70% in the first 72% of a 2 s loop (cubic-bezier(.45,0,.55,1)) and rests for the last 28% (≈ 560 ms). Behind it, polls run every 5 s six times, then every 15 s six times, then every 30 s. They skip while the tab is hidden and go on until the sheet closes, through the arrival too, so a state that changes again is still seen. They give up at 10 minutes unless the device is connected (the sheet is closing by itself then).

Can't finish: the light turns warn and knocks (way-knock, 1.8 s, the same curve): −70% → +34% at 48%, back to +26% at 62% as if turned away, then home to −70%, fading out by 86% and resting to the end. The break at the router flashes on the same beat (way-break, 1.8 s): opacity .25, scaleY .7, up to 1, 1.15 at 50%, back by 70%. The router's end turns warn over 400 ms. Both loops (the run and the knock) and the break run from the way's first frame; each state fades its own in and the others out over 200 ms (ease-out) where they stand, so none starts over in sight.

No data: the green fills the dots as on arrival (700 / 80, EASE_OUT) and the ends turn green (400; the router's 600 later, with no pop). Two packets take turns (way-drop, 2.2 s, the same curve, the second 1.1 s behind): each fades in by 8%, runs to 48% of the track at 46%, then drops 16 px past the middle (to 54%), shrinking to .5 and fading out by 66%. Leaving no data, each packet fades out where it is as it falls on (200, EASE_IN), then goes; back to no data while they fade, a fresh pair sets off.

Arrival timeline, measured live (t = 0 when the poll sees data flowing after a fresh handshake; the sub line's fold is read from the code):

t (ms) What
0 The line morphs to " connected" (width glides on SMOOTH, letters lift and rise). Its colour turns green (300 ms).
0 × and the pinned keys step away (out, b3, s.9, 240 ms). The sheet scrolls to the top.
0 → 380 The sub line folds away, if it still shows (see below).
0 → 200 The light fades out (200 ms).
80 → 780 The green fills the dots from the device's end (clip-path inset(0 100% 0 0) → inset(0), 700 / 80 ms, EASE_OUT). The device's end turns green (400 ms).
480 → 1172 The server's end turns green (400 / 600). Its icon dips to .6 (way-dip, 120 / 480, the way's curve) and springs back (way-pop, BOUNCY 572 / 600): it starts and ends at its own size.
410 → 930 Everything under the way folds shut: height → 0, out, b4 (520 ms, EASE_OUT), and the way's bottom margin goes 18 → 0.
410 → 2810 2.4 s of reading time. Unchanged with reduced motion: it is not motion.
2810 The sheet closes (120 ms on a computer, 420 on a phone).
≈ 2950 The page repaints: the card glides to its new place (SMOOTH), its status morphs to "Connected", and its green ring fades over 1.8 s.

Changes of state (follow()), each starting from where things stand on screen, so one turned round half-way never jumps:

What Motion Timing
The line letter morph to the new state's words (see 3); its colour 300 ms —
Second line in in, b4 → 0, while the block's height glides open and both lines FLIP to their new centre together 300 / 60 EASE_OUT; height and FLIP 340 EASE_OUT (the FLIP measured on the glide's first frame)
Second line replaced whole-word morph in place (old out, b4 180 EASE_IN, new in, b4 → 0 280 / 60 EASE_OUT) as the block glides to the new height 340 EASE_OUT
Second line out out, b4 from its current opacity, then the block closes the same way 180 EASE_OUT, the close from 170 ms, 340 EASE_OUT
Sub line folds (every state but waiting) and comes back height, margin-top/bottom → 0, out, b4 380, EASE_OUT
Steps regroup (same and router: into "Set it up again", "Add the connection again" or "Import the configuration again", and back) .setup height from where it stands to the new one; opacity .4, b2 → none 420, EASE_OUT; 320, EASE_OUT
Leaving connected × and the keys come back (240); what folded unfolds straight into the new shape, the way's 18 px gap with it 520, EASE_OUT
"No connection yet" after 10 min the line morphs; "Close this and open it again to keep checking." comes in as the second line, or morphs from the one shown; the sub line folds away if it still shows as above

14. Caret and selection · ui/caret.ts

What Motion Timing
Caret, typing and the arrows glides to its place on a per-frame spring of its own: per 16.67 ms frame v += (target − x)·0.12, v ·= 0.62, x += v (90% in ≈ 134 ms, ≈ 2% over, no stretch). At most 2.5 frames per step; after a gap of over 15 frames it is simply there. one rAF loop
Caret, a click where clicked at once, as macOS does 0
Caret blink solid while it moves or they type; 0.5 s after the last key, 0.6 s on / 0.6 s off with soft fades (caret-blink); its on/off fade 1200 ease-in-out loop; 100 linear
Selection grows out of the caret: both edges start where the caret is and ride the caret's spring; the wash and handles fade in. A wash still fading from the last selection turns back instead and glides from its old ends to the new ones. 140 linear
Selection collapses the wash fades where it stands (no slide), then its ends rejoin the caret 140 linear, the ends at 160 ms

15. Other moments

What Motion Timing
Add sheet, error under the field in: in, y−4 → 0, b4 → 0 as the sheet glides open (see 5, Content glide); out (they type): out, y−4, b4 where it stands, then the sheet glides shut; a second error morphs its words; each turns back from where it stands 220, EASE_OUT; out 180, EASE_IN, the glide from 170 ms
Show key / Hide key the mask and the key cross-fade in place, each from where it stands: in → none, 1 (320, EASE_OUT); out → 0, b4 (200, EASE_IN), then out of sight. The icon (key ↔ ×) turns the same way, out through s.6, b3; the label morphs 320 / 200
Steps fold (same-device layout, the "Not on the X" row) height, opacity, blur(0 ↔ 4px) from where it stands (a double click turns it back); a row still opening around it heads for the new height SMOOTH 524
Top edge fade opacity 0 ↔ 1 at scrollY > 2 200 ms
Demo scenario switch page out, b4 160 EASE_OUT → repaint → in, y6, b4 → 0 420 EASE_OUT demo only

Shimmer · ui/shimmer.ts

Words on their way to the router (a name being saved on its card) shimmer as an assistant's "thinking" line does. A copy of the input's words is laid exactly over them (same font, clipped to the input and scrolled as it is) and the input's own go transparent. The copy is the words' colour (text) over a muted base (text 38% into raised), painted as a gradient clipped to the text: a band 2.2 em either side with a bell falloff (0, .5, .9, 1, .9, .5, 0) crosses it from left to right in 1.8 s, linear, then rests 0.58 s and goes again. It starts solid (the swap shows nothing), dims in 240 ms; stopping, the band holds where it is and the words fade back to their colour around it (480 ms, standard curve), and only then does the copy go. With less motion asked for there is no band: it only dims and comes back.

Choreographies, end to end (live, demo latency ~0.5–0.75 s)

Rename (on the card):

  • 0: Return; the words' copy laid over them dims to the muted base (240, standard curve), the caret steps aside;
  • +120: the first sweep sets off (1.8 s across, linear), then again after a 0.58 s rest, for as long as the router takes;
  • answer: the band holds where it is and the words fade back to their colour (480, standard curve);
  • then: the input gives way to the name (identical, nothing moves), the card is drawn again and its status morphs from the hint, words and colour.

Reconnect:

  • 0: busy;
  • +720: answer. Under the sheet the cards FLIP (iPhone and MacBook swap places, ±315 px) and the status morphs to "Not set up yet";
  • +795: view swap to set-up. Old out 200, new in 280 / 110, height 297 → 830 (360), width 400 → 448 (SMOOTH), pinned keys in 260 / 110, × back (240), the light starts.

Add:

  • 0: go button busy;
  • +460: the new card pops (BOUNCY) under the sheet, the count morphs "3 of 4 → 4 of 4", the limit note rises (420);
  • +509: view swap to set-up.

Remove:

  • 0: busy;
  • +750: answer, sheet out 120;
  • +877: the card leaves (220, EASE_IN, s.9, b6);
  • +1103: repaint. The neighbour glides (−315, 154), the Add card blurs in (SMOOTH / 60), the limit note fades (200), "Device removed" toast.

Reduced motion (prefers-reduced-motion: reduce)

play() keeps only the opacity of an animation that fades, at ≤ 160 ms ease-out. An animation that only moves or resizes jumps to its end (0 ms).

Piece Behaviour
Text morph, morphInto Plain text swap, no letters
Picker pill Jumps (uses SMOOTH and t = end)
Busy No 410 ms hold; orb shown as a still frame (front dot sharp, halo behind)
Accordion chevron, calendar cascade, way light (its knock too), way fill, server pop, falling packets Off (CSS @media blocks); the break at the router stands still
Caret and selection edges Jump to their places; the caret stands still (no blink)
Second line, steps regroup Fade only; the heights jump
Sub line fold, what folds on arrival, the limit note leaving Fade out, then gone with their space (back at once, fading in): the way still moves up under the head
OS mark alternation Marks swap instantly (the word still changes)
Sheets, menus, toasts Fade only
Arrival reading time (2.4 s) Unchanged

CSS hover and press transitions (scale(.8–.98), colours, the switch) are not reduced. They are small, direct responses to input.

Performance notes

  • Animated properties are transform, opacity and filter: blur almost everywhere. Layout properties animate only where the layout must truly change: height, width, max-width, margins and radii (sheet height, accordion rows, morph width, folds), flex-grow (picker) and clip-path (way fill).
  • Morphs skip elements that are not on screen. The OS alternation skips while folded. Polls pause in hidden tabs.
  • The caret runs one requestAnimationFrame loop for itself and both selection edges, writes only transform (and the wash's width), and stops once all three rest. Its measuring copy of the text sits out of sight with the input's font, and several events in one frame make one measure.
  • Blur radii stay at ≤ 6 px; the edge fade's 12 px backdrop blur is the only large one.
  • One animation per property per element at a time: new runs cancel old ones after starting from their computed state. The exception is a FLIP inside the sheet, which adds to one still under way (composite: 'add').

Motion do's and don'ts

  • Do use a spring token for anything that moves or resizes. Use EASE_IN for exits and EASE_OUT for blur-ins.
  • Do make the entering part wait 60–110 ms in a cross-fade, and keep exits under 220 ms.
  • Do start from the current computed state and cancel after.
  • Do keep loops tied to a real wait: a request, a connection, an alternation the person reads.
  • Don't animate Escape, a language change or a reload.
  • Don't morph a hover readout: it follows the pointer and must be instant.
  • Don't use transition: all, bounces on exits, or travel over ~20 px except the drawer and the FLIP.
  • Don't re-run an entrance animation on a repaint the person didn't cause: the calendar's days come in when its row is opened, not when a repaint keeps it open.

Content & Voice

  • Short, plain and whole. "Your devices can't connect until it's resumed." A sentence that adds to a title never repeats it. Full rules for strings and Russian: rules/i18n.md.
  • Buttons are verbs, with no ellipsis: Connect, Update, Add device, Reconnect, Remove, Cancel, Open securely, Show key, Copy.
  • Statuses are short and fit one line. The full wording goes in the tooltip: "Settings changed, update needed".
  • Other apps are quoted word for word, in each language: "+ › Insert › Continue" for AmneziaVPN, "Import Tunnel(s) from File…" for WireGuard.
  • Honest warnings sit where the choice is made: plain HTTP, the router's own certificate, connected but no data left, a device that can't finish connecting or connects with no data (the way says what it likely is, the card says it in one line with why in title).
  • Numbers, sizes and dates follow the page's language (num, bytes, toLocaleDateString(locale())). Times are the router's clock, hours shown in the visitor's time when the offset is known.
  • The language pill switches in place. The page opens in the kept choice, else the browser's language, else English.

Accessibility

  • Focus: :focus-visible draws a 2 px outline in accent at 65% with a 2 px offset. Mouse focus shows nothing.
  • Roles:
    • the sheet is dialog, or alertdialog for questions, with aria-modal and aria-label = the view's title;
    • the menu is menu with menuitem or menuitemradio (aria-checked);
    • the picker is a tablist of tabs (aria-selected); the kinds are a radiogroup of radios (aria-checked);
    • the LAN Bypass row is one button with role="switch" and aria-checked, named by its title and line;
    • accordion heads are buttons with aria-expanded;
    • the way is role="status" with aria-live="polite";
    • the menu path has its own aria-label naming both systems' words;
    • busy buttons get aria-busy.
  • Keyboard: Escape closes the menu, then the sheet, without animation. The phone's back button closes the sheet. Focus returns to the opener. A name edited on its card selects its text as it opens; Esc there puts the name back without closing anything else, and focus returns to the name. When the set-up steps regroup under the way, focus inside them stays in the sheet (see Set-up sheet → Around the way).
  • Words only on hover: a device card's status stays one line, so why a link fails sits in title for a pointer and in hidden text right after the status for a screen reader (.offscreen). A touch screen shows neither: the trade-off for cards of one height.
  • Hidden decoration: icons and glass icons are aria-hidden. Morph overlays and ghosts are aria-hidden and click-through. A field's drawn caret, selection and handles are click-through, and its measuring copy is aria-hidden; the input underneath stays the browser's own (typing, IME, its real selection). An icon-only button has an aria-label.
  • Contrast: see the table in Colors. --text-3 and white-on-accent are below AA.
  • Targets: buttons and fields are 48 px, menu items 40 px. Knobs and pills are 32 px, the pinned keys 38 × 32 and calendar cells 10 px (not interactive). The 32 px controls are below the 44 px touch guideline.

Live audit: findings (2026-10-20)

These are observations from the code read and the live run, not changes. Each is cheap to confirm in the demo.

Motion

  1. The sheet uses two height animations. A view swap glides height over 360 ms cubic-bezier(.25,1,.5,1) with cubic-bezier(.2,0,0,1) cross-fades and pinned keys. In-view changes use SMOOTH (524 ms). Moving the swap onto the spring tokens would make the sheet move the same way however its content changes.
  2. The drawer scrim uses CSS keywords (ease-out 420 / 320) where the dialog's scrim uses SOFT and EASE_IN. Harmless, but it sits outside the token set.
  3. Comments drift from the code.
    • motion.ts says BOUNCY is "the accordion", and accordion.css and accordion.ts call it "bouncy". The accordion runs on SOFT (476 ms, 3.9%), on purpose since 2026-10-19.
    • docs/plan-portal-redesign.md says "one bottom drawer at every width" and "four kinds with a sliding ring". Live, the sheet is a centred dialog from 760 px, and the ring does not travel.
  4. The language switch is a hard cut. The whole page is rebuilt with no fade. It is consistent with "nothing animates that the person can't follow", but it is the only visible change without a transition.

Visual and accessibility

  1. White on accent (every primary button) is 2.4:1 in dark and 2.9:1 in light. It is below AA even for large text. It is the measured skiper21 look, so it is a decision for the user. Options: a deeper accent fill with the same hue (e.g. #1d84e6, the glass tone b) or dark ink on the light fill.
  2. --text-3 carries meaningful text at 2.2–2.4:1: the limit note ("You have reached your limit…"), "3 of 4", "Ends Mon 30 Nov", axis dates and the "OR" divider. The limit note and the end date carry information and could move to --text-2.
  3. Light theme tone text is thin. Status lines at 13 px in ok, warn or accent are 3.1–3.3:1 on white. Accent text links in hints are 2.9:1.
  4. --t-orange has no light override. The light block redefines the grey, blue, green and red glass tones, but not orange. Orange glass icons keep their dark-theme stops in light.
  5. Breadcrumb at 375 px: with the demo chip, both crumbs truncate to "Dawnlin… › U…". The router build has no chip, but a long server name will do the same. Consider letting the person's crumb win (flex-shrink on the place first).
  6. Quota tone mismatch: the "Out of data" notice is red (bad) while the cards say "Connected, no data left" in orange (warn). Intended (the tunnel is up), but the page shows two tones for one state.
  7. "How to" paths wrap with the separator first: a wrapped line starts with "›" ("› Pick the file and connect").
  8. The .conf block has no edge inside its inset row: both are --field. In light especially, the code floats without a container. (Inside "Set it up again" both step up and the block shows: knob on knob 65%.)
  9. The trash glass icon reads as "pause" at small sizes: two vertical strokes in a rounded body. The lid separates it at 64 px only.

Source map

Area Files
Tokens, fonts, light theme web/src/portal/styles/tokens.css
Reset, type, focus, selection, icons styles/base.css
Knob, buttons, orb, field (its caret and selection), picker, kinds, option row and switch, badges, hints, link row, QR styles/controls.css
Field caret and selection ui/caret.ts
Add a device, the LAN Bypass row flows/add.ts
Page frame, edge fades, crumbs, columns, notices, single card styles/page.css, page/frame.ts, page/notices.ts
Device cards styles/devices.css, page/devices.ts
Access rows styles/access.css, page/access.ts, days.ts
Accordion styles/accordion.css, ui/accordion.ts
Sheet, views, questions styles/sheet.css, ui/sheet.ts, flows/device-actions.ts, flows/secure.ts
Set-up styles/setup.css, flows/setup-view.ts, flows/setup-parts.ts, flows/wait.ts, way.ts (the way's state), setup.ts
Menu, toast styles/menu-toast.css, ui/menu.ts, ui/feedback.ts
Motion engine motion.ts; morph ui/morph.ts + styles/morph.css; busy ui/busy.ts; picker ui/seg.ts
Glass icons, line icons, QR ui/glass.ts, web/src/shared/icons.ts, web/src/shared/qr.ts, ui/codes.ts
Demo web/src/portal/demo/* (deployed to dawnline-demo.vercel.app)
Rules rules/ui-design.md, rules/frontend.md, rules/i18n.md

Measuring motion live

Paste this into the console of the demo (or the portal) before interacting, then read __dump(). Springs show by name because each has a unique duration.

const N = {572:'BOUNCY',524:'SMOOTH',476:'SOFT',296:'QUICK',544:'POP',396:'LEAD'}, L = (window.__log = []);
const d = (e) => e.tagName.toLowerCase() + '.' + String(e.className?.baseVal ?? e.className).trim().replace(/\s+/g, '.');
const ez = (e, t) => (e?.startsWith('linear(') ? N[t] ?? 'spring' : e ?? 'linear');
const A = Element.prototype.animate;
Element.prototype.animate = function (f, o) {
  L.push([d(this), o?.duration, o?.delay ?? 0, ez(o?.easing, o?.duration), JSON.stringify(f).slice(0, 160)].join(' | '));
  return A.call(this, f, o);
};
addEventListener('transitionrun', (e) => L.push(['css', d(e.target), e.propertyName].join(' | ')), true);
addEventListener('animationstart', (e) => L.push(['kf', d(e.target), e.animationName].join(' | ')), true);
window.__dump = () => L.splice(0).join('\n');