interactive data interfaces #
A live data interface has two jobs: represent the data faithfully and preserve the viewer's ability to act while it changes. Visual polish includes the second job. A correct total in a layout that loses focus or hides its controls is not a complete result.
space around the primary loop #
Identify the smallest useful loop: inspect the graph, move time, compare the result. Keep those controls usable together at normal zoom. Height and width are coupled budgets; reducing height by crowding out the plot merely moves the problem.
On narrow screens, move secondary representations below the primary controls instead of shrinking every element equally. A packing algorithm proves that items fit; screenshots and actual interaction establish whether the result is readable. Different quantities need different visual encodings. Rank above an image and a total below it should not look like two interchangeable numbers.
entry points and editing #
Progressive disclosure should hide infrequent work, not the reason someone visits. An account lookup can remain visible while the long selection roster is collapsed. Name the state and action concretely: “on the chart” and “choose posters” explain more than a metaphor and “manage.”
Give a default state one entry and one intelligible return path. A reset action that silently does nothing in the default state communicates poorly. Distinguish navigation from selection and removal with separate semantic controls; do not make an entire identity card destructive while adding an apparently separate remove icon.
viewing intent and data arrival #
Ingestion, live-edge following, playback and an active drag are different states. Scrubbing can suspend advancement without changing the user's playing/paused intent. A release should restore that intent; it should not always start or stop. Transient hover ends when the pointer leaves its target, even if it remains inside a larger chart. Keyboard focus and touch navigation need explicit behavior too.
Use stable keys when reconciling live rows and portraits. Recreating controls on each update can lose focus, interrupt interaction and cause image flicker even when the underlying data is correct. Test identity retention as well as rendered values.
commands in changing views #
A control preserves the action visible when a press starts. If a remote update changes Pause to Play while a pointer is held, releasing that press still means Pause. Capture the explicit desired state at pointer-down rather than reading a mutable toggle at release. React Native Web can defer press activation, so onPressIn alone may capture after the remote update. Preserve keyboard and accessible activation, and clear a captured action when the press is canceled.
Bind the command to the entity and revision the user acted on too. Two people pausing the same state should produce one transition and a harmless duplicate; an old held press must not become a fresh command after a newer play or track change. Test by holding one control while another client changes its state.
time you can scrub #
One rounding rule names the moment on screen. If labels floor a fractional time while the URL rounds it, a shared link opens on the neighbouring day; use the same rule for labels, the URL and accessible text.
Classify gestures by everything the pointer did. A vertical drag, a held press and
a cancelled pointer (pointercancel, which iOS sends for system gestures) are not
taps, even if horizontal travel stayed under the drag threshold. Momentum from a
flick belongs to the scrub that made it: clear it whenever playback starts or
stops, or it resurfaces as a jump after pausing. Holding any time control, the
canvas or the slider, suspends playback; Back and Forward stop it so the restored
moment is not overwritten. A pinch tracked from two pointers needs a new baseline
whenever one lifts while two remain, or the camera jumps to the new pair.
Tie effects to data time, not wall-clock time. A ring that spreads over six days of the timeline looks the same whether the viewer reaches that day by replay, by scrubbing or by a link; a wall-clock animation plays only for whoever happened to cross the moment. Motion that does need wall time, such as a breath on arriving at the live edge, runs a few cycles and stops, so nothing animates at rest.
Scale to what exists at the moment. Sizes relative to an all-time maximum leave early states as specks in an empty frame. Fit the camera to the items alive at the current time and size them against the busiest one then, easing both over a few days in each direction while never excluding a living item. Give long-lived items a size floor tied to their accumulated work, so a quiet one keeps a legible mark instead of shrinking to a point.
motion caused by events #
A live celebration is a claim that a new event happened. Trigger it from accepted, fresh changes rather than initial state, replay or duplicate delivery. Where the interface draws a connection between two objects, travel should follow that entire connection before the destination reacts. Draw the connector layer behind the complete destination layer, not behind only its own destination.
Keep motion ephemeral. Coalesce repeated arrivals per entity rather than queueing an animation for every event; data can update immediately while a celebration is already playing. Provide a reduced-motion signal without requiring travel or bounce. A bounded animation count is useful, but is not a measurement of frame time.
serving work proportional to the view #
Send incremental changes instead of repeatedly broadcasting the whole dataset. Measure initial-load traffic separately from steady-state traffic before adding fanout infrastructure. Fetch small pages and enrich only requested identities; bound caches and cancel obsolete work. Filtering a loaded page must not masquerade as searching the whole collection.
Freshness labels must identify their clock: event observation, historical view, or wall time. Historical reconstruction cannot claim stronger continuity than its retained event history supports. See watermark semantics and change timestamps.
verifying states #
Check the default, empty, singular, full, replaying and recovering states. Test transitions as well as screenshots: a profile click must not select, a removal must affect one item, and a drag must preserve playback intent. Automated checks, browser inspection and device testing answer different questions. State which ones were performed; passing unit tests is not a screen-reader or capacity audit.
small DAG layout #
a lineage graph of tens to a few hundred typed nodes reads best as a layered flow, not a force layout (a different picture every load) and not an embedding map (no edges). rank by longest path from the sources, order rows by the barycenter of neighbours in a few alternating sweeps, keep a group's nodes contiguous within a rank, and the layout is deterministic and cheap enough to run on the client on every load.
on a phone the flow runs top to bottom so the narrow axis holds the widest rank. two things follow: a rank with fewer nodes than the widest one spreads them over the widest rank's slots instead of the row grid, or its wider pills collide; and a pill's width comes from the measured label at the current zoom, capped by its slot, not from world units, because fonts clamp in pixels while world units scale. what the viewer may not see still gets drawn as a ghost node when something visible derives from it: the edge into the boundary is the information.
the rest is standard canvas interaction: unified pointer events with a pinch pair, zoom anchored under the pointer, a demand-driven frame, a devicePixelRatio backing store, a touch-widened hit radius, and labels that are culled at the viewport edge rather than shifted off their node.
sources #
- race38,
docs/ui-rigor.md,web/main.ts,web/dom.ts,web/style.css,src/portraits.ts,src/pulses.ts,src/live.tsand associated tests, September 4–5, 2026. - race38,
ARCHITECTURE.mdandSTREAM-TYPEAHEAD-RESEARCH.md, September 5, 2026; measured repeated snapshot delivery and the bounded-serving comparison. - pub-search
site/atlas.jsand botweb/src/lib/components/AtlasOverlay.svelte, and a canvas lineage graph of a dbt/dagster asset DAG checked at 393 px and 1280 px, 2026-09-18 - evergreen timeline,
site/streams.js,site/streams-render.jsandsite/streams-data.js, with an independent review of its gesture and time handling and the regression tests that followed, 2026-11-01. - Chimes
src/activity.tsandsrc/firehose.ts, 2026-09-19; Stream baseline and relay-eval rate profile. - plyr.fm,
next/app/src/use-press-intent.ts,jam-connection.ts, and the two-browser held-press regression innext/app/scripts/check-jam-realtime.cjs, React Native Web with Expo 58, 2026-11-06.