Skip to main content

Component library and Storybook

The web component library is @nox/ui. Storybook is the living reference for component variants, controls, and visually important states. Product screens and user workflows belong in Docusaurus; do not duplicate full screen contracts in Storybook.

Run it locally​

pnpm --filter @nox/ui storybook

Build the static component reference with:

pnpm --filter @nox/ui build-storybook

What must have a story​

  • Every reusable primitive used by two or more screens.
  • Default, loading, disabled, error, focus, and destructive variants when applicable.
  • A realistic state using seeded, non-sensitive Nox Billings data.
  • A11y-relevant labels and controls.

Current first stories cover the Button and EmptyState primitives. Add a story in the same pull request when a reusable component changes. Link the Storybook story from the relevant component/pattern specification.