BytestreamUsage

Style book

Usage

Laws of UX, each tied to where Bytestream follows it and what to watch.

Usage

The style book measured against Laws of UX (Jon Yablonski), fetched 2026-09-22, brought up to the build on 2026-09-24. For each law: what Bytestream already does, then the rule to keep or the place it falls short. Cognitive Bias is the umbrella the others sit under and is not a rule of its own here.

LawIn BytestreamKeep / fix
Aesthetic-Usability EffectA dark room with film grain, one warm light, real stills in every tile. The player is the product and everything else is a rail under it. A camera-off tile is the person's own light, never a grey box.Grain and warmth earn trust only while the picture plays. An empty studio tile with a type-only name is where the effect runs out; keep stills first, logos second, type last.
Choice Overload9,461 playable channels never appear as one list. Shelves cut by category, country and language; Spotlight answers a query; the Guide shows only what is on now.The Categories index and Atlas are the two places a viewer meets the whole catalog at once. Both need a first row that decides for them (starred countries, seeded channels).
ChunkingFive slots on a phone: Watch · Guide · LIVE · Saved · Search. On the desktop rail, Go live, Search and five destinations, with the Studio apart at the foot. The overlay is three lines: name, meta, controls. The live band is two groups split by a divider.A shelf row is the chunk; a shelf longer than a screen should end with a Show-all card, not run on.
Cognitive LoadNo hex codes, no jargon in the interface. Times as 21:00–21:30. One control surface for the player, not two. One row language for every list.The OBS server and key readouts are the heaviest thing in the Studio; they stay in a box with a Copy action so nothing has to be read, only pressed.
Doherty ThresholdTune-in is measured, not guessed: one YouTube player reused, HLS remembers the working stream, the next host is preconnected. Sheets settle in 220 ms. The tuning pulse says something is happening within the first frame.Anything over 400 ms shows a state, never a blank. Paused holds the last frame. A reload is not a stream failure.
Fitts's LawThe list handle draws 36×4 but its target is 48×36. Phone transport glyphs are 20 with a 36 disc and 8 gaps, inside a 320 handset. Chips are 36 tall. The live controls are 44 on a desktop and 56 squares on a phone.Desktop transport is ten 18 px glyphs at 14 px gaps; the save heart gets 28 px of clearance from the speaker so a mute press cannot catch it. Any new control on that row must keep that gap.
FlowTheater clears the chrome. The overlay hides itself; a pointer move brings it back. Arrow keys walk the rail; Enter selects; Space toggles play. Channel changes never re-mount the picture.A route change exits theater and the stream never re-tunes on a layout change. Keep it that way: every Watch state is a layout state, never a route.
Goal-Gradient EffectYour climb states the watched minutes so far and how many people watched, and names no rung and no count to reach: the 30-minute gate isn't switched on. The own channel (50 approved hours, or by invitation) is one quiet line in the Control room.A meter toward a goal that isn't live yet is a promise the product can't keep. When the gate switches on, show the next rung only, and only as far as it is true.
Hick's LawFive thumbs on a phone, one search. The picker is a searchable list, not a grid of every country. A tap on a rail card tunes; there is no second confirm.The desktop transport row is the one place with ten choices side by side. It survives because every glyph is a standard: no invented icon lives there.
Jakob's Law⌘K opens search. A 16:9 frame with a bottom overlay and a crimson LIVE pill is what every player looks like. The Studio is a home with tabs, like the sites creators already use. Stream server + key is the OBS convention.The comedy/tragedy masks for theater are ours alone. They read only because they sit where the widescreen icon usually sits and turn amber when on.
Law of Common RegionPanels: the overlay's void gradient, the studio-toned cards, the stage band under the picture, the popover with its own border. Rows bleed to the panel's edges so a highlight is a row, not a stripe.Spotlight's field has no box of its own because the panel's border already draws the region. Never put a box inside a box.
Law of ProximityThe LIVE pill sits on the programme line, above the progress bar it describes. Join and Ask sit together in the picture's top-right corner, across from the ··· that reports. The clear button lives inside its chip.Your climb's number and the line that says what counts share one box; the own-channel line lives apart in the Control room, so it never reads as the climb's goal.
Law of PrägnanzThe handle is a bare pill: it goes both ways, so it carries no arrow. A progress line with nothing to report draws the empty track, not a made-up position. The wordmark is the word alone.The chevron on the handle lasted one afternoon. Resist adding a glyph to say what the shape already says.
Law of SimilarityOne row language for Spotlight and the picker. One rail card. Sidebar row, tab bar item and overlay save toggle share the heart in the same two states. Every field is one pattern with variants.A new list must reuse ChannelRow or the row highlight; a new switch must be the SettingsSheet switch.
Law of Uniform ConnectednessThe progress line and its head are one amber stroke. The tuning hairline follows the frame's own radius. The now-line on the parked timeline runs from the axis through the strip.The desktop playing Guide row fills amber end to end, tile to time: one connected object, not a highlighted name.
Mental ModelIt is a television, not a dashboard: channels, tonight, LIVE, off air. The N00bstream is a channel you tune into, so a creator's video 'airs' rather than 'publishes'. A creator has a Room; a channel is earned.The word 'Off air' is a claim about the broadcast, so the Guide says 'No listings' when it is the guide that is empty. Keep the two vocabularies apart.
Miller's LawFive slots on a phone, one search. The transport's left cluster is five. Seven Hype pads, one row on a desktop.The desktop transport's right cluster is seven; it holds because it is two groups (sound, picture) with a gap between.
Occam's RazorTheater and the phone lost their own transport layouts; there is one. The desktop sheet and the phone sheet share one clock. The lamp is web-only rather than present-and-inert.Your Room and the Control room both carry upload and go-live. One of them should own the action and the other should link to it.
Paradox of the Active UserNo onboarding. 'Tap for sound' appears where the tap is needed and dismisses on first tap. The OBS box says exactly where to paste. Any common video format is accepted.Every keyboard shortcut also has a visible control; keys are a bonus, never the only door.
Pareto Principle329 channels carry a programme guide against 9,461 playable, and they lead every shelf. The starred countries lead Atlas. Recommendations open with Top picks.When a query narrows the Guide, rows with a programme still come first and the quiet rows gather in a tail.
Parkinson's LawA run of the pipeline is bounded: encoding 'takes a few minutes', a reviewer 'then' puts it on air, and the state line says which step it is on.Give every waiting state a time shape, even a rough one; an unbounded 'Processing' invites the creator to keep refreshing.
Peak-End RuleThe peak is the first frame of a channel: the tuning pulse, then the picture, then LIVE lights. The end is never a black rectangle: paused holds a frame, off air says so and moves on after a second. The Studio's peak is the first approval: the On air banner with Watch it air, the amber dot on the card, the same line as a notification.One peak, one line: the banner, the panel row and the email say the same words, from one place in the code.
Postel's LawSearch matches on name, country, category and language. Uploads accept any common format and normalise through Mux. The relay answers for sources that will not play in a browser with the true reason.The condensed face is Latin-only, so a name it cannot spell falls to Inter in the tile. Accept every script; send one clean line back.
Selective AttentionAmber means now and appears once per screen. Crimson means a stream exists. Everything else is paper, dim or hairline, so the eye finds the one warm thing.A second amber on a screen is a bug. The lamp is filled paper when on precisely so it is never mistaken for the masks.
Serial Position EffectGo live leads the desktop rail in the Compose position and Search follows it; the Studio closes it at the foot. On a phone the LIVE door takes the middle slot. Seeded channels lead a shelf; the Show-all card ends it. The playing channel's row leads the Guide.Live now always leads the notification panel; a live row that ended drops into its day.
Tesler's LawGoing live from OBS needs a server and a key; that cannot be reduced, so it is presented as two copyable readouts and one sentence. Rights attestation on upload is one screen, once.Do not hide irreducible steps behind 'advanced'. Put them in a box, label them plainly, give each one action.
Von Restorff EffectCrimson is only where a stream exists: the LIVE pill, Go live on air, Stop in a live room. The selected rail card is the only amber border. A pinned person is the only amber-bordered card in the room.Because these are the only differences, they carry meaning. A decorative border or a third accent would dilute all three at once.
Working MemoryLast remembers the channel before this one and names it under the pointer. The channel picker keeps its scroll. A tuned channel survives a reload. Filter chips show what is set without opening the picker.A creator's state lines (In review, Encoding, Uploading 412 MB of 660 MB) are the memory; never collapse them to a single 'Processing'.
Zeigarnik EffectUploading and encoding tiles keep the still behind a veil with the state on top and a meter along the edge. An upload that stopped says Upload stopped with Try again, so nothing hangs at Uploading. The dashed slot on the parked timeline is an open task.The activity log in the control room closes the loop: every started thing gets a finished line, so nothing stays open in the creator's head.

Three to act on: the desktop transport row is at the edge of Fitts and Hick; upload and go-live live in two places (Occam); waiting states need a time shape (Parkinson).