Role names only. Components never use a raw colour, so a theme is a change of values. Every text pair meets WCAG 2.2 AA (4.5:1) in Light, Dark and High contrast.
Chart series
1234567Empty
Scroll bars
Lena Abery
Owen Adair
Iris Ancell
Priya Arden
Tom Ashby
Nadia Avery
Felix Bannon
Ruth Barlow
Sam Calder
Jordan Carrow
Alex Clayburn
Hana Dunmore
Mara Ellison
Corin Fallow
Ada Greaves
Ivo Lennard
Bea Lyle
Noor Pemberton
Use
--color-accent for the one main action, the current page bar and links.
--color-text-muted for meta lines and hints, never for the only copy of something important.
--status-* pairs only inside chips, notices, stats and edges, always with words.
Accent
Teal (UX-02, option B); changing it is one token in each theme.
Scroll bars
Thin and square in every scrolling area, in --color-scrollbar (the border colour; the text colour in High contrast) on a clear track. They stay visible; only shelves hide theirs, behind arrows.
Chart series
--series-1 to --series-7 in a fixed order that follows the thing, never its rank. Checked for colour blindness, and 3:1 against the surface, in all four themes.
--series-empty with a hatch for free space.
Accent colours
Six accent colours over Mica's neutral greys. Load tokens.css, then one palette file, then components.css. Only the accent changes: links, the main button, the chosen item, the count and the logo, in Light, Dark and both High contrast themes. Surfaces, text, focus, status colours and chart series stay the same. Blue, the default, is tokens.css itself; Teal is the colour before Mica.
<link rel="stylesheet" href="tokens.css">, then palettes/forest.css, then components.css.
Pick one accent per product. An app may let people choose one (Starboard, own style): load palettes/app-palettes.css after tokens.css and set data-palette on <html>.
Change one
Edit tools/palettes.py, run it, then tools/build.py and tools/check_accents.py (0 failures).
Type, space and icons
One typeface, Atkinson Hyperlegible Next, at five sizes that follow the Text size setting. Space on a 4px scale. Icons from Lucide at 16, 18 and 20px, 2px stroke.
Page heading (2rem, rare)
Page heading, h1 (1.5rem)
Section heading, h2 (1.25rem)
Group heading, h3 (1rem, 600)
Body text (1rem). The quick brown fox reads three chapters before supper.
Small and muted (0.875rem): meta lines, hints and counts.
Extra small (0.75rem): chips and tags only.
4, 8, 12, 16, 24, 32, 48
Rules
Sentence case everywhere. No capitals for emphasis, no all-caps labels.
Numbers that change use .numeric (tabular figures).
An icon beside a word is decoration (aria-hidden); an icon alone needs a name.
Header and menus
Three names: the side menu (the rail on the left), the level 1 menu (header row 1, with search and Display) and the level 2 menu (header row 2, only when the page has one). All three have icons.
Nothing else goes in the header: page actions live in the page head or the section toolbar.
Tabs that do not fit show icons only (.is-compact) with the names as tooltips; the 2nd level scrolls sideways.
A count on a tab says what it counts in hidden text.
Search button
Search is always one button away (TheMightyTRexUK, 4 November 2026): .rail__search, first in the rail under the logo, moves focus to the header's search box.
On phones, where the box is hidden, .site-header__search-btn in the header opens the same box as a row under the header. Escape or a press outside closes it and returns focus.
Both buttons have data-search-open and aria-controls naming the search form; components.js does the rest. No single-key shortcut, so nothing fires while someone enters text (WCAG 2.1.4).
Accessibility
Each tab row is a nav with its own name; the current tab has aria-current="page" and a 3px bar, not colour alone.
Search is a plain box with a hidden submit button, so voice control can say "Search". The phone search button says "Search" and reports aria-expanded.
On phones the header is the menu button, the name and Display. The ☰ menu slides from the left with search, the main menu and the 1st level. The 2nd level stays under the header and scrolls sideways.
App name
Press the menu button to open the drawer.
Behaviour
Focus moves to Close; Tab stays inside; Escape, Close or a press outside closes it and focus returns to the menu button.
The section you are in starts open. Choosing a page closes the menu.
Only the main menu and the 1st level have icons in the drawer.
The same button and slide-out in every app: the last item in the header, on every page, Sign in and Set up included. It opens Display and accessibility.
The button
.icon-btn, the sun icon and the word Display. On phones the word is hidden from sight but still read out.
aria-haspopup="dialog" and aria-expanded.
The slide-out
Titled Display and accessibility; Close is named "Close display and accessibility".
In this order: Theme (Match device, Light, Dark), Text size (100% to 175%), Reduce motion (Match device, On, Off), High contrast, Underline links, Wider text spacing. An app adds its own after these (Starboard: Design).
Choices apply at once. Done and Reset in the foot.
Saving
To the person's account where the app has accounts; otherwise in the browser.
components.js applies the choices from data-display inputs. data-display-save="key" on the form keeps them in the browser; data-display-reset="key" on Reset.
Buttons
44px high, square, bold 0.875rem. One primary button per view. Words say what happens: "Save connection", not "OK".
http://example.test:8080
Variants
.btn--primary: the one main action.
.btn--quiet: Cancel and secondary links.
.btn--danger: removing; asks first in a dialog.
.btn--compact: 32px, inside dense tables only.
Accessibility
Icon-only buttons have a name that includes the thing: "More actions for The Salt Road".
A button that cannot act yet says why beside it, or stays available and explains when pressed.
Menu button
Related actions in one button instead of a row of them (the Lists menu). Opens with focus on the first item; arrow keys move; Escape closes.
Sort by
Use
For actions, use menuitem; for one choice from a list (sort), menuitemradio. For a form value, use a select instead.
Keep the button's name the same while it works ("Lists"); say progress in a status line.
Checkboxes for things saved with a Save button; switches for things that apply at once; segmented controls for two to five short options; option cards when each option needs a line of explanation.
Sortable list
Rows in an order the person chooses, such as qualities best first. Move up and Move down on every row work with a keyboard, a screen reader and on a phone; the handle drags with a mouse or a finger. A marker row, such as Stop upgrading here, moves the same way. Each move says where the row is now and sends a sortable-change event with the new order.
2160p Blu-ray
2160p web
Stop upgrading here
1080p Blu-ray2 to 20 GB
1080p web1 to 10 GB
720p web0.5 to 4 GB
Filter chips and applied filters
Filter chips are buttons in a toolbar that are pressed or not (aria-pressed). Applied filters show what is in use, each with a remove button, and a Clear all.
Showing:AudiobooksLibrary: Fiction
Rules
Every filter and sort starts from the current address, so two changes in a row both stick.
Filters are in the address, so Back and shared links keep them.
Status, counts and tags
A status chip shows a word, a shape and a colour together, so it works without colour. One vocabulary across both apps (guides/CONTENT-DESIGN.md).
In libraryDownloadingNeeds reviewFailedPausedWanted
Library review 12 to reviewAudiobookUnabridgedALJv1.9.0 Upgrade available
Success, info and neutral: a dot. Warning: a diamond. Danger: a square. Muted: a ring.
High contrast adds a border to every chip.
Chip style
Outline with an icon (style B, chosen on the UX-04 board).
Where status goes
A heading:.title-status, chips straight after the name, centred on its line. Never on a line of their own under it. Details such as a version go on the right.
A list of things with a state:.status-icon straight after the name, the word in hidden text and a tooltip.
A row with actions: the chip in .row__side. A card: in .card__meta. A stat tile: under the value. A cover: its corner.
At most two chips in one place; more belongs in a facts list.
Facts lists put Author first, then Series; names link to their pages.
Rows and tables
Rows for lists of things with actions (queue, connections, services). A row that opens a slide-out has its title as the button and the whole row as the target. Tables only for real tabular data (logs, history); on phones they stack.
q
Torrents · category storyarr · v5.0.3
Connected
S
Usenet · category books
Cannot connect
The Glass Harbour
Downloading · 412 MB of 610 MB · 3 min left
Level
Message
22:41
Error
SABnzbd did not answer within 10 seconds.
22:40
Info
Checked 4 reading lists.
Tables that line up
Two tables one after another, with the same columns whatever their content: .table--fixed and the same <colgroup> in each.
Library tasks
ID
Task
State
LIB-1
A to Z jump list
Done
Settings tasks
ID
Task
State
SET-12
A server name of up to 10 characters at the start of the level 1 menu, with a character count in Settings, General
Needs a decision
Notices, empty and loading
Upgrade available
Version 1.10.0 is ready. Read the release notes before upgrading.
Connection saved
qBittorrent answered in 120 ms.
Disk 3 needs attention
12 sectors were reallocated this week. Back up its data.
Connection saved. Test unsuccessful.
Check the address and password, then test again.
No downloads yet
When you request a book, it appears in Activity while it downloads.
The loading bar runs along the bottom of the header:
Rules
Errors say what happened and what to do, in the page, not only in a toast.
Empty states say what is missing, why, and the one next step.
Skeletons have the shape of the content; never a spinner on its own for a whole page.
Roles
Success and info: role="status". Errors that block: role="alert".
Toasts and saved notes
A toast is a short message about something that happened: a card in the corner with a coloured edge, a title, an optional line of detail, one optional action and Close. Success, information, warning or error. On settings pages a success is a saved note beside the button instead. An error that belongs to something on the page (a field, a row) also shows there.
Select Save changes: the note appears beside it and goes at the next change.
Toast
Bottom right, full width on phones. Up to three stack, newest at the bottom.
Success (tick), information (i), warning (triangle) or error (circle, on a red tint): icon, edge and words, never colour alone.
Title in the past tense, no full stop: "Follow saved". Detail is one short line.
Timing
Success and information: 5 seconds, 10 with an action. Warning: 10 seconds. Error: until it is closed. Each waits while the pointer or keyboard focus is on it.
Errors are read out at once (role="alert"), the rest politely (role="status"), without moving focus. A new toast never pushes out an error.
Saved note
Settings pages only: "Saved at 16:31", beside the button that saved. Stays until the next change.
Code
SharedComponents.toast(title, { detail, tone, action: { label, run } }); tone is success, info, warning or danger
A notice in help and long text. One colour means one thing, and the first words say it, so the meaning never rests on colour. No steps and no emoji inside a callout.
Before you begin:
Sign in as an administrator, and have your Jellyfin API key to hand.
Limitation:
Listening progress copies across only for books that are in both libraries.
Warning:
Deleting a backup removes it from the disk. It cannot be restored.
Tip:
Activate alerts so Starboard tells you when a disk fills up.
Example:
Alex keeps films on disk 1 and music on disk 2, so a full disk stops only one of them.
Meaning
Info: before you begin. Warning: a limitation. Danger: cannot be undone. Success: a tip. Muted: an example or aside.
A grey band across the top of a card with the logo, the name as the heading and a status chip at the right (Starboard's plug-in cards, DASH-428), and a lighter grey footer, .card-foot, with when it last updated. Without a logo, the initials on a tile.
Direct play
Status: Converting
The Expanse, season 2, episode 4
Adding a Roku audio track
WS
Watch statistics, This week
42 hours watched this week
Network
Checked 1 minute ago
Outside address
reachable
VPN
Connected
Covers and media cards
Covers at 2:3; audiobook squares are letterboxed, not cropped. Small, Medium and Large come from the account's cover size setting.
The Glass Harbour
Mara Ellison · Book 2
Salt Roads
J. Okafor
No cover
Unknown author
Square audioAudiobook
Read by Sam Oduya
Behaviour
Pressing a book opens its summary slide-out; the full page is a link inside it.
The focus ring sits on the cover, so it is visible on any artwork.
A to Z jump list
Over a long wall of covers: # for titles that start with a number, then A to Z, from the sort title ("The Expanse" is under E, "Émile" under E). Letters with nothing are shown but cannot be chosen, and say so to screen readers. It sticks under the header; the letter in view is marked with a bar. One Tab stop: Arrow keys, Home and End move, Enter jumps and focus moves to the letter's heading. On phones the row scrolls sideways. Classes: .az-jump, .az-jump__letter, [aria-disabled="true"], .wall-letter. Behaviour: SharedComponents.azLetter(title), azJump(nav, letters), azGo(nav, letter) and the az-jump event for a wall that shows 40 at a time.
#
24
242001 to 2010
1917
19172019
A
The Long Tide
The Long Tide2024
The Night Ferry
The Night FerryHarbour Radio
B
Blue Planet II
Blue Planet II2017
Bluey
Bluey2018 to now
Load more as you scroll
UX-52. A long list loads its next page as its end comes into view, and keeps a real Show more button for keyboard and screen reader users. While it loads, a line says "Loading the next 40"; then a screen reader hears "40 more shown" and focus stays where it was. After three pages in a row it stops, so the footer stays in reach, and the button carries on. The button is the only way when Reduce motion is active, when the person's setting asks for it, or without script. Pressing it moves focus to the first new item. Classes: .load-more, .load-more__count, .load-more__status. Behaviour: SharedComponents.loadMore(box, { load, items, noun, pageSize, auto, maxAuto }), with reset() after a new search, filter or A to Z jump.
When to use it
Long walls and lists people browse, such as a library or a history, where the order is the point.
When not to
Results people compare or come back to by position, a table to sort, or a page with things after the list that people need: use pages or Show more alone.
Keeping the footer in reach
It loads only when the end of the list comes into view, never on a timer, and stops after three pages in a row. The A to Z list and Back to top keep working.
Cover actions
UX-42. Pressing the cover or the title opens the book's Summary. A column of 44px actions runs down the cover's right edge: Details, Ebook, Audiobook, Add to a list and More. "On the cover" (the default) shows the column on hover and keyboard focus, and always on touch screens; "Beside the cover" puts it next to the art, always shown. Each person chooses in Settings, Display.
Books in order, search results and Following. The whole row opens the Summary; the same five actions sit at the end. On phones they go under the title.
1
The Salt RoadMara Ellison · 2017In library
2
Half a LanternMara Ellison · 2017In library
3
The Tide ClockMara Ellison · 2017Wanted
Small cover tiles (UX-44 B)
Series gaps and calendar day cards. One 44px More button on the corner; its menu says each action in words. The cover opens the Summary.
Square show art in the book shape (FEAT-R, fill 4)
Radio artwork is square. It sits at the top of the 2:3 shape, never cropped, with the same outline as books; the label under it takes the image's main colour (read in the browser) and carries the station and the name as real text. Without a colour the label is neutral; without an image the square shows the name.
Tab goes to the cover ("The Salt Road, details"), then to each action in order.
Every icon has a full name ("Get the audiobook of The Salt Road", "Audiobook of The Salt Road in library") and a hover label that also shows on keyboard focus.
A format in the library is a tick on its icon plus "in library" in its name; the old badges along the bottom of the cover go.
Progress and errors from getting a format show in a status line under the title.
Titles always take two lines of space, so covers line up.
Classes
.cover-card[data-actions="on"|"beside"] on a .media-card, .cover-card__open, .cover-card__art, .cover-card__status
UX-43. The top of a series (or radio show) page. A logo with a transparent background is drawn in one solid colour with a CSS mask (.logo-mask), so it follows every theme; each logo uses the text colour or the accent colour. With no logo, the name is set large as a wordmark. The name is always the page's h1. The fan of covers is decoration and is hidden on phones; the books are listed after it. The logo here is made up.
The Glass Harbour series
By Mara Ellison6 books and 1 story collectionNext: book 7, Low Water, 12 March 2027
A harbour town where the lighthouse keeper keeps more than the light. Quiet mysteries, one each winter.
Logos are saved once on the server and shared by everyone; admins add, change or remove them in the Series logo slide-out.
Three ways: From a cover (draw a box, threshold, Invert, clean up), Find online (Wikimedia Commons, with the licence and a wrong-match warning) and Upload your own.
In the slide-out, arrow keys move between the tabs, and on the cover arrow keys move the box (Shift and arrow keys resize it).
UX-30, option A. One row of covers that scrolls sideways, with no scroll bar. At each end the covers fade into the page, with an arrow over the fade; the arrow and fade show only when there are more books that way. On phones there are no arrows; the fade alone says there is more.
Set --shelf-cover-w to the cover width and --shelf-fade-bg to the colour behind the shelf.
Section toolbar
Design D: everything that changes what the list shows, on one line under the heading. The same on every list in both apps.
2,418 books
Settings rows and save bar
Label and explanation on the left, the control on the right. Things with several fields (a connection, an account) open a slide-out to edit, so the list stays in view.
Download clients
Where requested books are sent to download.
Check connectionsHow often to test each client in the background.
Remove finished downloadsAfter they are imported and have seeded to the ratio set in the client.
qBittorrentCategory storyarr · Connected
2 unsaved changes
Settings patterns
Every Settings page uses only these nine: section, setting rows, choice cards, location, form with Save, status line, empty state, lists that open and the danger zone (DESIGN-SYSTEM.md, section 9).
Download hours
Active
When the download apps may run, so the server stays quick in the evening.
Only at nightDownloads run from midnight to 07:00.
Saved 16:31
Speed limit0 means no limit.
MB/s
YouTube and Spotify downloadsMedia, Downloads, Direct · 812 GB free/data/downloads/direct
More options
No sites to search yet
Add a site, and Reelix searches it for you.
Remove
Last on the page, with a dialog that says what happens.
Rules
A saved setting shows the saved note beside its control, never a toast.
A unit sits beside its number, as part of the control.
A folder is never a bare text box: Browse, Set automatically, and and Enter a path under More options.
Things with several settings open a slide-out editor; Add sits at the foot of the list.
Folder picker
Idea A (TheMightyTRexUK, 16 November 2026): places first, then one list of folders with a path bar and Back, each folder with its size and what is in it, and Use this folder. The same on a phone (the slide-out is full width), with a keyboard and a screen reader, and in a terminal (a numbered list with the path at the top).
Choose a place
Where is the folder?
Choose a folder
In //192.0.2.20/media / Video · 3 folders
Films1.9 TB · 412 films
Kids640 GB · 38 films, 12 series
TVCounting…
Rules
Places first: This computer, each disk, then each network share and cloud service where the page brings things in from them.
Back goes up a folder, and from the top of a place back to the places.
Sizes and what is in each folder are counted after the list shows, so it never waits; Counting… until then.
Up and Down move, Enter or Right opens, Left or Backspace goes up, letters jump to a folder.
Use this folder chooses the folder you are in. One picker for every page that picks a folder.
Timeline
What happened to one thing, newest first. Used in a request's slide-out and a backup run's details. Shapes match the status chips.
Imported to FictionToday, 22:48 · 610 MB, audiobook
First release stalled; tried the next oneToday, 21:10 · no seeders for 2 hours
RequestedYesterday, 18:02 · by Alex
Rules
Each entry says what happened and when; the reason goes in the meta line.
An ordered list, so screen readers say how many steps there were.
Calendar month
A real table, weeks from Monday. A day with releases shows small covers, the first title and a button that opens the day's slide-out. Weekday names shorten on narrow screens; on phones the month becomes an agenda of only the days with releases.
Releases in November 2026 (first two weeks)
MondayMon
TuesdayTue
WednesdayWed
ThursdayThu
FridayFri
SaturdaySat
SundaySun
26
27
28
29
30
31
1
The Tidewright
2
3
Night Ferry and 3 more
4
5
A Small Weather
6
7
8
Rules
Each day's button says how many releases and names the date in hidden text.
Covers are decorative beside the title; the app's icon stands in when there is no cover.
Days outside the month or the range are greyed out and have no button.
Slide-out
From the right, over a dimmed page. For the details of one thing, and for editing it, without losing your place in the list. Its header wears the page background (--color-slide-header) and its body is the raised surface: white in Light, the dark surface in Dark. The phone menu, which slides in from the start edge, has the same design.
Behaviour
Focus moves to Close; Tab stays inside; Escape, Close or a press outside closes it; focus returns to what opened it.
The page behind does not scroll. Its address can include the open item, so Back closes it.
Editing: Save and Cancel in a footer that stays put; Remove on the far right, which asks first.
Sizes
420px; .side-panel--wide 640px for logs or long forms; full width on phones.
Colour
Header: the page background, so it reads as part of the page. Body and footer: the raised surface. Dialogs keep the plain header, so a slide-out and a dialog are told apart at a glance.
High contrast keeps a solid line under the header.
A modal, only for a decision or a short task that must finish before going on: confirming a removal, adding a list, a password check. Its header is plain (the panel header colour), unlike a slide-out's.
Wizard
Every job done in steps: first-run set-up, upgrades, restores and migrations. The rules are in docs/WIZARD.md. Beside the step are two review aids, What happens next and the decision tree: they are for testing only, shown while an app's testing setting is on, never in the finished product.
New install · step 7 of 18 · Build your media server11 to go
Torrent, done
Usenet, current part
Download options
Choose a Usenet app
The Usenet app fetches what the app finds, from your Usenet provider.
Download apps: qBittorrent and SABnzbdChange them in Settings, Download apps.
Requests: skippedSet them up later in Settings, Requests.
Shape
Progress bar, then the step bar for a step in parts, then the step. The step bar is as wide as the progress bar, with a line between parts; parts are numbered 1, 2, 3 and each is a step in the count (here steps 6 to 8 of 18). On phones only the numbers show, with ticks for done parts.
Review aids (What happens next, decision tree) only while testing: beside the step from 1100px, under it on narrower screens. Without them the step has the whole width.
The first question asks which job (new install, restore, migration); each has its own wizard (.wizard-paths).
Steps
One question per step; steps that do not apply are left out, and the tree says why.
Option cards, one marked "(recommended)" with the reason. Never "easiest".
Continue first, then Back, then Skip this step.
Help
"What is…" links at the end of the part they explain, with the square help icon, opening a slide-out about half the screen wide (.side-panel--wide), so the step stays in view beside the help. The step's own help, with Help with this step, sits at the bottom of the step.
Addresses are links with a copy button; commands have a labelled copy button. Copying works on plain http.
Choosing an outside service, a required field, a job's bar with its count, and the check before anything is written (docs/WIZARD.md, sections 5 and 9).
ConnectionWireGuard connects faster and needs fewer settings.
Downloading and starting the apps…3 min 12 s · 5 of 12 installed
What will be set up
What
Your answer
Change
Media folder
/srv/media
VPN
Example VPN, WireGuard
*= Required (shown at the bottom of the help slide-out, not in the form)
Outside services
At most six, spelt as on their own sites, each with its site as a new-tab link and the external-link icon; then Another one. Nothing chosen the first time.
Required
A * after the label; the control is required. The key goes in the help slide-out.
Job count
After the timer: installed, then running, counted from Docker.
A wizard step that signs in to a cloud service on its own page (docs/WIZARD.md, section 9). Two ways to finish, the same weight: on a phone with a QR code and a short code, waiting by itself; or in this browser with a link, then the address the sign-in ends on pasted back. Then the test's checks, and Test connection's result beside a place.
The same wizard drawn in a terminal (docs/TERMINAL.md; the code is in terminal/). Each drawing is 80 columns, the usual window.
A question
┌──────────────────────────────────────────────────────────────────────────────┐
│ App | Your home network step 1 of 4 │
└──────────────────────────────────────────────────────────────────────────────┘
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0%
Can phones and other computers on your home network open App?
● 1 Yes, with your password (recommended)
Phones, tablets and other computers at home can open it.
2 No, only this computer
You can change this later in Settings, Security.
› Your choice [1]:
────────────────────────────────────────────────────────────────────────────────
b Back ? Help f Feedback q Stop Enter: recommended
A job's bar
┌──────────────────────────────────────────────────────────────────────────────┐
│ App | Install what is missing step 3 of 6 │
└──────────────────────────────────────────────────────────────────────────────┘
███████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 33%
Installing (2 of 3)…
✔ Downloading the installer
██████████████▓▓▒▒▒▒▓▓▒▒░░░░░░░░░░░░░░ ⠧ Installing (2 of 3) · 1 min 12 s
────────────────────────────────────────────────────────────────────────────────
Ctrl+C Stop
Help, a box over the step
┌──────────────────────────────────────────────────────────────────────────────┐
│ App | Your home network step 1 of 4 │
└──────────────────────────────────────────────────────────────────────────────┘
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0%
┌─ Help: Can phones and other computers open App? ─────────────────────┐
│ Yes lets phones, tablets and other computers at home open App │
│ with your password. No keeps it to this computer. You can │
│ change it later in Settings, Security. │
└────────────────────────────────────────────────────────── Enter: back ─┘
────────────────────────────────────────────────────────────────────────────────
Enter Back
Plain mode, for screen readers
== App | Your home network (step 1 of 4)
Press b to go back, ? for help, f to send feedback or q to stop.
Can phones and other computers on your home network open App?
1. Yes, with your password (recommended): Phones, tablets and other computers at home can open it.
2. No, only this computer: You can change this later in Settings, Security.
Your choice [1]:
Feedback as a QR code (80 by 30)
Made with terminal/qr.py from a made-up new-issue address. A phone's camera opens the report, ready to send.
Heading box, a bar that ends where the box does, the step, and the menu on the bottom two lines. Only the lines between them scroll.
Questions
Numbered, the recommended first with a dot; the default in brackets; Enter takes it.
Jobs
One bar, drawn in place, with the timer and the count; only Ctrl+C while it runs.
QR codes
The largest that fits the window, dark on light, holding as much of the report as fits; never in plain mode.
Slide-out, dialog or page
The rule both apps follow when something opens.
Use
When
Examples
Slide-out
Details of one item in a list, or editing it, where keeping the list in view helps. Can hold a few actions. Also settings people change while the page stays in view.
Book summary; a request in the queue; a download client, indexer or reading account; a user; a log entry; an app, disk or download on Starboard; a backup run; Release notes; Display and accessibility.
Dialog
A decision or a short task that must be finished or cancelled before going on. One or two fields at most.
Remove or reset (confirm); Add list; a password check before a download or restore.
Page
Something people come back to, link to or spend time in; long content with its own sections.
Book, author and series pages; narrator page; Disk health; Settings sections; Upgrade wizard.
In place
A small change to a value already on the page.
Switches and selects in settings rows; filter chips; cover size.
Which item to use
Pick by what the thing is, not by its appearance. The rules are in DESIGN-SYSTEM.md, section 10 (Starboard DASH-309).
Real tabular data compared across columns: logs, history.
A list of things with actions (rows).
Event list
Things that happened, newest first, each with its time and a status icon (the word is hidden text and a tooltip). Used for disk events on Starboard. For the history of one thing with steps, use the Timeline.
Before anything is copied or changed in another app, a table says what happens to each thing, with one chip per row. Then one primary button does it. Used for Copy app settings on Starboard.
Download clients
Name
What happens
qBittorrent (qBittorrent)
Will be added
SABnzbd (SABnzbd)
Already there
Naming
Will be replaced
Words
Will be added, Already there (left as it is), Will be replaced. Nothing already there is changed unless the row says Will be replaced.
Earlier and later
Moving a calendar a month at a time. The buttons name the month they go to; Back to now appears only away from the current window. Before the first month, in the calendar view only.
Recent checks
The last checks of one app, newest first, in its slide-out. A small table: time, a status chip with any message under it, and how long it took. Check again in the slide-out checks only that app.
Recent checks of Sonarr, newest first
Time
Result
Answered in
17:05
Running
6 ms
17:00
Not responding
Cannot reach Sonarr
When it is down, the notice says for how long: "Not responding for 12 minutes."
Help article
Help topics, guides and release notes shown in an app use .prose. The layouts and rules are in docs/HELP-WRITING.md. A topic does one task; a guide is mostly links to topics.
For anyone replacing their server. At the end, Starboard runs on the new computer with all your apps and settings. Allow about an hour.
The steps at a glance
Back up your settings
Install Starboard on the new computer
Restore the saved copy
Check your apps
Step 1: Back up your settings
Save a copy on the old computer first, while it still runs. Follow Back up your settings. You know it worked when the download finishes.
Topic
Area line, title in the reader's words, kind, then the answer first.
Before you begin, Steps, Things to note, If it does not work, Find out more. Empty sections are left out. Reference topics add When would you use it.
Guide
Named after the outcome. Who it is for, what you will have and how long it takes.
The steps at a glance, then one short section per step, each a link to its topic.
Classes
.prose, .prose__lead, .prose__kind; callouts are .notice
Help centre
The help centre standard (owner, 14 November 2026): the pieces every help centre is built from, by tools/help_centre/build.py. Any app may use them too, such as the side tree for a long side menu or a flow chart in its own help. docs/HELP-WRITING.md section 11 says when each is used.
Top links
The seven main items, the same in every help centre. The area you are in is marked. On tablets and phones they move into the side menu.
Side tree
A side menu that folds: areas, then groups, then every page. Built from details and summary, so it needs no script. The page you are on is marked and its area and group are open. Select an area or a group to fold it open or shut.
Written as a flow block in the article's Markdown and drawn by the builder: the SVG follows every theme, and the same paths are written out in words under it. Each numbered answer is a card with its number and heading on a grey band.
The headline feature of a release, in the release notes slide-out or the upgrade guide. A new feature gets How to start; an improvement does not. Describe the new state, never a comparison with before.
New feature
Know when a disk is failing
Starboard checks every disk each night and tells you before one stops working.
The title is the benefit, under nine words. One sentence on what it means for the reader.
Three gains. The button is always "Open the guide: <topic>".
Picture
One picture of it working, with made-up data, described in its alt text.
Retiring something and dated changes
A removal is not news: say what is going, the date and what to do instead, in the app until the date passes. A change with an agreed date gets a From tag under its title; leave the tag off once the change is live.
Limitation: Classic layout ends on 1 December 2026