ui-toolkit

React UI component library built with Bun, Storybook, and MUI.

Stack

• React 19
• MUI 9
• Storybook 10
• TypeScript 6
• Jest for unit tests
• Playwright for browser and visual checks

Getting Started

Install dependencies:

bun install

Run the common workflows through make:

make build
make lint
make lint-next
make lint-tsc
make storybook-start
make storybook-build
make test-unit
make test-e2e
make test-visual
make lighthouse-desktop
make lighthouse-mobile

Bats Shell Coverage

Use the Bats suite for fast regression coverage of Makefile shell behavior without running the full browser or mutation stacks:

make test-bats

For CI-friendly output:

make test-bats BATS_FORMATTER=tap

When you add or change a public Make target, update tests/bats/make-target-coverage.tsv in the same change. Either add or adjust direct Bats coverage for uncovered shell behavior, or point the manifest at the pull-request workflow that already exercises the target.

Project Layout

• src/components: exported UI components, themes, and stories
• src/index.ts: library entrypoint
• .storybook: Storybook configuration
• tests: automated test coverage
• scripts: repository helper scripts used by build/test workflows

Notes

• This repository is a React UI library, not a Next.js app.
• Source code lives under src; there is no pages app surface.

Security

Report vulnerabilities through the private reporting guidance in SECURITY.md.

Contributing

Contribution workflow details live in CONTRIBUTING.md.