Design resources and tools

Everything in the TRex Design System that you can use in your own work, and how to change it and test it.

The TRex Design System is the one source of the components, tokens, icons and guides for Storyarr and Starboard. It is public: you may use any of it in your own projects, under the licences on this page.

What you can use

  • Component gallery

    Every component working, in four themes and five text sizes, with the classes to copy.

  • Tokens

    Every colour, size, space and motion value as role names, in tokens.css, for Light, Dark, High contrast and High contrast dark.

  • Accent colours

    Six more accent colours over Mica's greys: Teal, Indigo, Forest, Plum, Ember and Graphite. Load one after tokens.css.

  • Icons

    Lucide icons as one SVG file, icons.svg. Use an icon with <use href="#i-book-open">.

  • Font

    Atkinson Hyperlegible Next, made to be clear for people with low vision, in fonts/.

  • Storyarr design boards

    Every area of Storyarr as a full page, built only from the library.

  • Starboard design boards

    Every area of Starboard as a full page, built only from the library.

Guides

The guides are in the docs folder of the repository.

GuideRead it when
Content design guideYou write any words: a button, an error, a setting, release notes
Help writing guideYou write or check help, or ask an AI assistant to
ChangelogsYou add a change to a changelog or release a version
Accessibility guideYou build or test anything; it sets the floor every page must meet
Meeting WCAG 2.2You need to know how a WCAG point is met, and what your page must still do
Writing text descriptions (alt text)You add an image, an icon button, a chart or a screenshot
Screenshots in helpYou add or replace a screenshot in help, or ask an AI tool to: when one earns its place, made-up data, the mark-up and a short version for AI tools
Security checks guideYou release an app: the checks to run, how to sort what they find, and how to record the results
Design system guideYou lay out a page: principles, tokens, the header and page templates
Component referenceYou need a class name, or must choose between a slide-out, a dialog and a page

On these pages

Licences

You may copy, change and share everything here, including in paid work, as long as you keep the credit and the licence.