React
FelicityUI React components are TypeScript source. Prefer server components. Own the files.
React items install as .tsx files. Button is a native <button> with semantic token classes and does not require a client boundary. Dialog and Drawer are native <dialog> elements and do — showModal() has to run in the browser.
Vite and Next.js --src-dir projects land under src/. After add, the CLI installs clsx and Tailwind v4, points @ at the source root, and imports tokens.css from the Tailwind entry. Restart the dev server. If a component looks unstyled, run felicityui doctor.
Import generated tokens.css once, from that same stylesheet — not from JavaScript. Extend className. Do not re-wrap these in a design-system package — the point is that the source lives in your tree.