Components

One library for Storyarr and Starboard: tokens, components, behaviour and icons. The guides cover content design, accessibility and security checks.

Colour

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.

Teal palettes/teal.css

The colour before Mica: calm and clear.

3

Light: body text and a link.

Ready
3

Dark: body text and a link.

Ready

Indigo palettes/indigo.css

Calm and focused: tools, dashboards, reading.

3

Light: body text and a link.

Ready
3

Dark: body text and a link.

Ready

Forest palettes/forest.css

Natural and steady: libraries, gardens, health.

3

Light: body text and a link.

Ready
3

Dark: body text and a link.

Ready

Plum palettes/plum.css

Warm and personal: media, music, journals.

3

Light: body text and a link.

Ready
3

Dark: body text and a link.

Ready

Ember palettes/ember.css

Bright and lively: home, food, events.

3

Light: body text and a link.

Ready
3

Dark: body text and a link.

Ready

Graphite palettes/graphite.css

Neutral and technical: servers, admin, documents.

3

Light: body text and a link.

Ready
3

Dark: body text and a link.

Ready

Use one

  • <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.

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.

Phone header and menu

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.

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.

Classes

  • .phone-menu, .phone-menu__search, .phone-menu__section, .phone-menu__foot, .panel-header

Display button

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.

Fields

A visible label before every control, a hint under the label when needed, and an error that says how to fix it.

The address this app uses to reach qBittorrent.
Use letters, numbers, - or _ only, with no spaces.
GB

Rules

  • No placeholder as a label. Placeholders only show an example.
  • Errors appear on leaving the field or on save, never while the person is still entering text; focus moves to the first error on save.
  • Units sit beside the box, not in the label.

Classes

  • .field, .hint, .field-error, .input, .select, .textarea, .input-group, .form-grid

Checkboxes, switches and choices

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.

Formats to request
Cover size on My library
When a book is released

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.

  1. 2160p Blu-ray
  2. 2160p web
  3. Stop upgrading here
  4. 1080p Blu-ray2 to 20 GB
  5. 1080p web1 to 10 GB
  6. 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: Audiobooks Library: 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 library Downloading Needs review Failed Paused Wanted
Library review 12 to review AudiobookUnabridged v1.9.0 Upgrade available

Where status goes

Jellyfin

Up to date
Version 10.11.2
Live TV
42 channels
  • SonarrConnected

    127.0.0.1:8989

  • SABnzbdNot connected

    127.0.0.1:8085

Shapes

  • 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, stats and meters

Author
Mara Ellison
Series
The Glass Harbour, book 2
Narrated by
Sam Oduya
Published
21 Sept 2026
Length
11 hr 42 min
6Disks healthy
1Needs attention
2,418Books in library
Media pool7.2 of 9.1 TB used (79%)

Rules

  • The value is always in words beside the bar.
  • 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.

  • Torrents · category storyarr · v5.0.3
    Connected
  • Usenet · category books
    Cannot connect
  • The Glass Harbour
    Downloading · 412 MB of 610 MB · 3 min left
LevelMessage
22:41ErrorSABnzbd did not answer within 10 seconds.
22:40InfoChecked 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
IDTaskState
LIB-1A to Z jump listDone
Settings tasks
IDTaskState
SET-12A server name of up to 10 characters at the start of the level 1 menu, with a character count in Settings, GeneralNeeds 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.

No downloads yet

When you request a book, it appears in Activity while it downloads.

Discover books
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
  • SharedComponents.toast.error(title, options), toast.warning(...)
  • SharedComponents.savedNote(element)
  • .toasts, .toast[data-tone], .toast__text, __title, __detail, __action, __close, .saved-note

Callouts

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.

Classes

  • .notice, .notice[data-tone="warning|danger|success|muted"], .notice__title, .notice__body

Disclosure, help and steps

You have version 1.10.0, the newest. 2 releases.

Version 1.10.0

Installed21 September 20261 added1 fixed

Added

  • Reading lists. Keep books to read next in lists of your own.

Fixed

  • Bigger covers. Covers no longer blur at large text sizes.

Your settings and the way back

Nothing to choose. To go back, restore the copy saved before the upgrade.

Version 1.9.0

1 August 20262 changed1 security

Earlier changes.

Download categoryqBittorrent files each download under this label and saves it in the label's folder.
  1. Back up
  2. Review changes
  3. Upgrade
  4. Check

Panels and cards

A panel groups content. A card is one thing that opens its slide-out or page; the whole card is the target, and its other buttons sit on top of it.

  • Films, series and music.

    RunningUpdated 2 days ago
  • Used3.1 of 3.6 TB
    Needs attention
  • Books and audiobooks.

    example.test:8000

Card band

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

  • 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.

    On the cover (default)

    • The Salt Road
      The Salt RoadMara Ellison
    • Half a Lantern
      Half a LanternOwen Brightwater
    • The Cartographer's Daughter and the Long Winter Crossing
      The Cartographer's Daughter and the Long Winter CrossingLise Moreau
    • Beneath the Weir
      Beneath the WeirTomas Ferrand
    • Sleeping Lanterns
      Sleeping LanternsMara Ellison

    Beside the cover

    • The Salt Road
      The Salt RoadMara Ellison
    • Half a Lantern
      Half a LanternOwen Brightwater
    • The Cartographer's Daughter and the Long Winter Crossing
      The Cartographer's Daughter and the Long Winter CrossingLise Moreau
    • Beneath the Weir
      Beneath the WeirTomas Ferrand
    • Sleeping Lanterns
      Sleeping LanternsMara Ellison

    In rows (UX-44 A)

    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.

    • The Tide ClockBook 2
    • Beneath the Weir, a Very Long Title That WrapsBook 3
    • North of QuietBook 4

    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.

    • The Night FerryHarbour Radio · 22 series
    • Lantern HillHarbour Radio Extra · 22 series
    • Quiet CarriageHarbour Radio · 22 series

    Logo tile

    Behaviour

    • 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
    • .cover-actions, .cover-actions__btn, .cover-actions__tick, .cover-actions__tip
    • More: a .menu[data-fixed], so it is not cut off inside a shelf
    • Rows: .book-row (--lead), .book-row__open, .book-row__art, .book-row__text, .book-row__title, .cover-actions--row
    • Small tiles: .cover-card[data-actions="more"], .cover-card__more
    • Radio: .show-art (__img, __text, __label, __station, __name; --show-art-bg, --show-art-fg), .logo-tile (__text)

    Series header and logo

    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.

    4 of 6 books in your library

    Salt Roads

    By J. Okafor3 books

    Behaviour

    • 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).

    Classes

    • .logo-mask (--logo, --logo-ratio, data-colour="accent"), .wordmark
    • .series-head, __text, __name, __meta, __desc, __progress, __actions, .cover-fan
    • Slide-out: .logo-saved, .logo-tabs, .logo-pane, .logo-step, .logo-candidates, .logo-candidate, .cover-pick, .logo-crop, .range, .checker, .logo-drop, .logo-preview, .inline-form

    Shelf

    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.

    For you

    View all
    • The Salt Road
      The Salt RoadMara Ellison
    • Half a Lantern
      Half a LanternOwen Brightwater
    • The Cartographer's Daughter and the Long Winter Crossing
      The Cartographer's Daughter and the Long Winter CrossingLise Moreau
    • Beneath the Weir
      Beneath the WeirTomas Ferrand
    • Sleeping Lanterns
      Sleeping LanternsMara Ellison
    • Glass Harbour
      Glass HarbourMara Ellison
    • North of Quiet
      North of QuietAidan Reyes
    • A Map of Lost Things
      A Map of Lost ThingsLise Moreau
    • The Paper Orchard
      The Paper OrchardHana Sato
    • Winter Lines
      Winter LinesRuth Calder
    • The Quiet Engine
      The Quiet EngineAidan Reyes
    • Moth Hour
      Moth HourTomas Ferrand

    Behaviour

    • Each arrow press moves one screen less one cover. With Reduce motion active, the shelf jumps instead of sliding.
    • Tabbing to a book scrolls it fully into view, clear of the fade.
    • Arrows are named "Earlier books in <shelf>" and "More books in <shelf>". "View all" stays in the heading.
    • Shelves that load more as you go keep loading when the arrow reaches the end.

    Classes

    • .shelf-scroller, .shelf-track, .shelf-edge--start, .shelf-edge--end, .shelf-arrow
    • 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.

    View
    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.

    1. Imported to FictionToday, 22:48 · 610 MB, audiobook
    2. DownloadedToday, 22:41 · qBittorrent, category storyarr
    3. First release stalled; tried the next oneToday, 21:10 · no seeders for 2 hours
    4. 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)
    MondayMonTuesdayTueWednesdayWedThursdayThuFridayFriSaturdaySatSundaySun
    2627282930311
    The Tidewright
    23
    Night Ferry and 3 more
    45
    A Small Weather
    678

    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.

    Classes

    • .side-panel-layer, .side-panel-backdrop, .side-panel, .panel-header, .side-panel__body, .side-panel__foot, .side-panel__lead

    Dialog

    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.

    Remove qBittorrent?

    Books already downloaded stay where they are. Downloads in progress stop being tracked.

    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
    1. Torrent, done
    2. Usenet, current part
    3. Download options

    Choose a Usenet app

    The Usenet app fetches what the app finds, from your Usenet provider.

    Usenet app

    After it is installed, SABnzbd is at http://192.0.2.10:8080 (opens in a new tab)

    docker compose up -d sabnzbd
    • 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.

    Classes

    • .wizard-layout, .wizard-main, .wizard-aside, .wizard-progress, .steps--sub, .wizard-paths, .wizard-next, .wizard-tree, .help-links, .help-link, .address, .copy-btn--label, .side-panel, .wizard-summary

    Wizard pieces

    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).

    VPN provider

    Choose the one you have an account with. Each link opens the provider's site in a new tab.

    ConnectionWireGuard connects faster and needs fewer settings.
    Connection
    Downloading and starting the apps…3 min 12 s · 5 of 12 installed
    What will be set up
    WhatYour answerChange
    Media folder/srv/media
    VPNExample 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.

    Classes

    • .option-cards--row, .field__required, .required-key, .segmented, .meter, .table--middle

    Signing in to an outside service

    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.

    How do you want to sign in?
    • Reach the folderDone
    • Write a small test fileDone
    • Read it backDid not work
    • Remove itNot tried

    ConnectedTested 16 Nov, 10:40

    Two ways

    • Option cards, the same weight. The phone only where the service has a device flow; otherwise the link alone.

    QR code

    • Dark on white in every theme. Never alone: the page and the code are written out, each with Copy.

    Waiting

    • A polite live region with the words and the time left; a time limit, then Try again.

    Classes

    • .signin-card, .signin-steps, .signin-example, .qr-card, .device-code, .signin-wait, .test-checks, .tested

    Terminal

    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.

    Scan it with your phone's camera to open the report there. It holds a short report.
    
    
                     █▀▀▀▀▀█ ▀▀▄▀▄▀▀ ▄▀ ▄█▀██▄ ▀▄▄ ▀  ▀ ▄▀ █▀▀▀▀▀█
                     █ ███ █  ▀▄▀▀██  █▄   ▀██▀█ ▄▄ ▀█▀ █▄ █ ███ █
                     █ ▀▀▀ █   █▀▄  ▄ ▄█ █▀▀▀█▄█▀ ▀▀█▀ ▀▀▀ █ ▀▀▀ █
                     ▀▀▀▀▀▀▀ █▄█ █ █ █ ▀ █ ▀ █ █▄█ ▀▄▀▄█ █ ▀▀▀▀▀▀▀
                     ▀▀ ██▄▀  ▄█ ██▄ █▀▀▀███▀▀█▄█▀██▀▄▄▄ ▄▄█ ▄▄ ▄▀
                     █ █▄██▀ ▄ █▄██▀ ▄▀▄▄ █▄ █▄ ▄ ▄▄▄███ ▀ ▄   █▀▀
                       █▀ ▀▀▄█▀▄ █ ▀▀  ▀ ██ ▀▀▀▄▄█▀▄▄█ ▀ ▄ ▄█▀▀█ ▀
                     ▀▀▀█  ▀ ██ █▄ ▀▄█▄██▄▄███  █ ▀▄▄ ▄ ▄ ▀ ▄▀▄██▄
                     ▄▀▀█▀▄▀█▄▄██ ▀ █ ▄▀▀ ▀█▄▀█▀▄▄ ▄▀▀▄█▀▄▄▀▄▄ ▄▄▄
                     ▄ █▀█▀▀  ▀█▀▄▄██▄▄ ▀▄█  █   █▄▄▀▀  ▄ ▄▄▀▄▄█▄█
                      ▀█▄█▀▀▀█▀  █▄ █▄█▀ █▀▀▀█ ██▀ ▄  █▄▄█▀▀▀█▀▄▄
                     ▄▄  █ ▀ ██  ▀▄▀▄ ▀▀▀█ ▀ ██ ▀ █▄█▄█▄██ ▀ █▄▄▀▀
                     ▀▀▀ ▀▀▀█▀█▀█▀▀█ ▀ ▀ █▀██▀▀█ █▄▄ █▄  █▀██▀   ▀
                     █ █ ▄▀▀█▀▀▄▄ ▄  ███▀▀ ▄▄▄██ ▄█ ▀ ▀▄▄▀▄ █▀▄█ ▄
                     █▀▄▄▄█▀█ ▀█▀▄▀███ ▀▄█▄ ▀▄    █▄█▀ █▀▄█▀███  ▄
                     ▀▀ ██▄▀▀▀▄▄█▄▄ ▄▄█ ▀▀█▀█▄  ▀█▄▄▄▀█▄█▄▄▀▄ ▀▄ ▀
                     ▄▀ ▄█▄▀ ▀█▀▀█ ██▀ ██▄ ▀▄▄█▄▄▀██▄ █▄▄▄▀▄█▄ ▄ ▀
                      ▄▄▄█ ▀▄██▀▄██▄█▀█▀▄ █ ▀█▄ ▄▀█▄█▄▀▀ ▀██▀▄ ███
                     ▀  ▀▀ ▀▀█▀▄▀▄ ▀█ ▀▀▄█▀▀▀████▀▀█▄▀▄ ▀█▀▀▀██ █
                     █▀▀▀▀▀█  █▀▀ █▄▀▀▀ ▄█ ▀ ███ ▀█▄▀ ▄███ ▀ █▀▄
                     █ ███ █ █▀ ▀▀▄▀ ▄▄▄▄▀▀█▀█▀▀█  █ █▄▄▄▀▀▀▀▀▀  ▀
                     █ ▀▀▀ █ ▄ ▀█ █▀ ▀█ ▄       ▀█▄▄█▀▄ ▀██▄▄█▄██▄
                     ▀▀▀▀▀▀▀ ▀      ▀ ▀▀     ▀▀▀▀▀ ▀   ▀ ▀▀▀  ▀
    
    
    ────────────────────────────────────────────────────────────────────────────────
      Enter Done   l Show the link

    Frame

    • 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.

    UseWhenExamples
    Slide-outDetails 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.
    DialogA 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.
    PageSomething 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 placeA 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).

    ItemUse it forNot for
    List rowsA list of things that each have a state or an action.A table; covers to browse.
    CardsOne thing people pick from a few, which opens its page or slide-out.A box to group content (a panel); more than about 24.
    Status chipsA state in words, beside its name.A number, a date or a count; more than two in one place.
    Filter chipsFilters that can be on together, each with its count.One choice of several (a segmented control).
    ToolbarSearch, filters, sort and view on one line under a list's heading, the count at the end.Actions on the items (a selection bar).
    NoticesSomething on this page to know or fix: one sentence and at most one button.Things that happened elsewhere (a toast); a saved setting (a saved note).
    ToastsSomething that happened that the page does not show.A saved setting; an error about a field or row.
    DialogsA decision or a short task, up to two fields.Details or editing with several fields (a slide-out); help.
    TablesReal 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.

    • Problem: 2026-11-02 09:15 /dev/sdc: SMART self-test failed

    • Warning: 2026-11-01 03:00 /dev/sdb: reallocated sectors 0 to 8

    • Information: 2026-10-31 03:00 /dev/sda: extended self-test completed

    Classes

    • .rows, .row--no-lead, .status-icon[data-tone], .numeric

    What will change

    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
    NameWhat happens
    qBittorrent (qBittorrent)Will be added
    SABnzbd (SABnzbd)Already there
    NamingWill 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
    TimeResultAnswered in
    17:05Running6 ms
    17:00Not 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.

    Help centre · Backup and restore

    Back up your settings

    How-to

    Save a copy of Starboard's settings, so you can put them back after a new install. It takes about a minute.

    Before you begin

    Steps

    1. Go to Settings, then Backup.
    2. Select Back up now. A message says when the copy is saved.
    3. Select Download the backup (ZIP) to keep a copy on another computer.
    Tip:

    Activate 'Back up every night' and Starboard keeps the last 7 copies for you.

    Things to note

    • A backup holds settings only.
      • Films, music and books stay on their disks and are not copied.
      • To copy those too, read Back up the server.

    Find out more

    ArticleWhat it covers
    Restore a saved copyPutting a backup back
    Move Starboard to a new computerThe whole move, step by step

    Help centre · Guides

    Move Starboard to a new computer

    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

    1. Back up your settings
    2. Install Starboard on the new computer
    3. Restore the saved copy
    4. 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.

    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.

    Journey

    Your server, step by step

    Follow the path, or go straight to any stage.

    1. 1 · Set up

    2. 2 · Use every day

    3. 3 · Fix things

    Flow chart and answer cards

    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.

    Find your answer
    Flow chart: An app's card says Not responding. The same chart is written out in words after it.Cannot reach the appRefused the API keyStill not respondingAn app's card says NotrespondingWhat do the detailssay?Start the app again1Copy the API key again2Read the app's ownmessages3
    The chart in words

    Start: An app's card says Not responding

    1 Start the app again

    Open the app itself in your browser. If it does not open, start it again, then select Check again.

    2 Copy the API key again

    Copy the key from the app and paste it into API key, then select Test connection.

    Feature card, solver card and version badge

    Welcome to Starboard help

    Latest version0.18.0 (release notes)
    New in 0.18

    Update Starboard from its own page

    Select Update now, or let Starboard update itself in your quiet hours.

    Read Update Starboard

    Flow chart: Update now, then Starboard restarts.

    Something not working?

    The problem solver asks up to four questions and takes you to the right fix.

    Start the problem solver

    Problem solver

    Up to four questions. With no script, the whole tree is lists of links; with it, one question at a time, with Back and Start again.

    What is wrong?

    Plug-in card and band

    Disk forecast

    Version 1.0.0 · plug-in API >=1.1 <2.0

    PublishedHow to add it

    What is new

    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.

    What is new

    • A nightly check of every disk
    • An alert when a disk needs attention
    • Each disk's history in one place

    How to start

    1. Activate alerts in Settings.
    2. Go to System, then Disk health.
    Improvement

    Downloads now show time left

    Each download says when it should finish, so you know whether to wait.

    What has changed

    • Time left on every download
    • Speed in words, not arrows
    • Finished downloads move to the end

    Find it in Downloads.

    Nothing to set up.

    Words

    • 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

    Shelf layout replaces it, and your settings move across. Read Switch to Shelf layout.

    Quiet hours for downloads

    From 1 December 2026

    Time ago

    Relative words on screen, the exact time for screen readers and in the markup.

    Updated

    Markup

    • <time datetime="2026-11-03T16:31:00"> with the words, and the exact time in .visually-hidden.