ui

Overview

ui is the reusable component package consumed by multiple apps.

Architecture

• React 19 component primitives
• Storybook for documentation/development
• Tailwind CSS v4

Usage guidelines

• Do not add custom Tailwind classes directly to shadcn/ui components.
• Use the component variant props instead of className overrides on consumers.
• Check packages/ui/src/components/ for available variants before extending a component.

Local development

bun run dev:ui

Primary scripts in packages/ui/package.json:

• storybook: runs on port 5002
• build: Storybook static build
• check: Biome checks

Environment variables

• No required runtime env vars for package development.
• Consumer apps provide runtime configuration.

Deploy and runbook

• Storybook artifacts are built through the package build script.
• Keep shared tokens/styles backwards compatible for consuming apps.

Ownership

• Team: Ern engineering
• Primary: Ern engineering on-call