Skip to main content

Rudiment UI

A React component library and four example apps built to find its gaps.

Rudiment UI is an accessible React component library built on React Aria and design tokens. I built example apps with it, wrote down every workaround, and let that list decide what to build next.

What I got to play with

  • React 19 with React Aria for keyboard, focus, and ARIA behavior
  • Style Dictionary building three tiers of design tokens
  • Eight themes that are nothing but token values
  • Writing a 13-chapter guide on component library architecture

The good bits

A hand-drawn style sketch of Rudiment UI’s project board example: a sidebar, a sprint bar, a WIP-limit warning, and four columns of issue cards.
The project board example, redrawn as a sketch from the real story.
A Storybook docs page for the CRM dashboard example, with the rendered page above its full source code.
Each example page sits above its full source code.
The same CRM dashboard in the Roomy theme, with more space and rounder corners.
The CRM dashboard in the Roomy theme. Only the tokens changed.
The same CRM dashboard in the Compressed theme, with tight spacing.
And Compressed, which only touches spacing and radius.

Go ahead, poke at it

The real Storybook story: issue cards across four sprint columns, with WIP-limit warnings and keyboard moves.

live interactive
Rudiment UI project board story: a Kanban board with To Do, In Progress, In Review, and Done columns of issue cards showing priority and story points Open live demo
Project board

What I learned

Typography caused the most workarounds. Nearly every heading carried a hand-written margin reset until the components learned better.

The gap list only finds my gaps. I wrote the library and the examples, so it catches what I reach for.

A brand color set on the root loses inside a themed section, so overrides have to be repeated per theme.