open-index/open-npm huggingface dataset:
npm package: @scattered-light/base-ui-theme
Description: Base UI primitives with Mojave design tokens (React).
Latest version: 0.1.7

# ux-style-library-wip

Public npm package name (adjust scope in `package.json` before first publish): **`@ux-style-library/base-ui-theme`**.

## Design-system components (`src/lib`)

Shared primitives (Base UI + theme CSS) live under **`src/lib`**. In this repo, import from the **`@/`** alias, for example `import { Button } from '@/lib'`. **Storybook** loads [src/styles/index.css](src/styles/index.css) globally; library source does not side-effect-import CSS so the same components are safe to publish.

In **Storybook**, wrapped components are grouped under **`Components → Lib`**. See [docs/component-coverage.md](docs/component-coverage.md).

### Other apps (e.g. Lovable)

- Consume: [docs/consuming.md](docs/consuming.md)
- Publish from this private repo: [docs/PUBLISHING.md](docs/PUBLISHING.md)

### Scripts

- **`npm run build:lib`** — ESM + types in `dist/`, CSS tree in `dist/styles/` (run before `npm pack` / CI publish).
- **`npm run build`** — Vite app build output in `dist-app/`.