DOCS
Framework Support
The library is plain React plus plain CSS. Anything that renders React 18+ and can import a stylesheet will run it.
Supported Frameworks
| Framework | Status | Notes |
|---|---|---|
| Vite + React | Full Support | The reference setup — the design system, its Storybook and this site are all built on Vite. |
| Next.js | Full Support | App Router and Pages Router both work. Components are client-side, so mark consuming files "use client". |
| Remix / React Router | Full Support | Import the stylesheet through the root links export rather than a bare CSS import. |
| Create React App | Works, Unmaintained | Nothing in the library breaks under CRA, but CRA itself is deprecated — new projects should start on Vite. |
Requirements
18 or 19
Hooks and forwardRef required
Plain CSS
Tokens as custom properties — no Tailwind, no CSS-in-JS
Any ESM
Ships ES modules only; no CommonJS build
GitHub Packages
Scoped .npmrc entry required
Server Rendering
Every component is a client component — they hold local state, attach listeners, or read layout. Under the Next.js App Router, put "use client" at the top of the file that imports them. Components that measure or portal (DatePicker, Dropdown, Options, Tooltip, Snackbar) should not be rendered on the server at all; import them dynamically with ssr: false if a page needs them above the fold.