Create a new Once UI app with our starter repository. It will install dependencies and set up the recommended structure:
Or add Once UI to an existing project:
Upgrading an app from 1.8? Follow the migration guide: a codemod does most of it, and it lists what is left in the order that keeps your app building.
Installed with Once UI Core, nothing to do:
Your app provides these. Components ship their styles as precompiled CSS modules, which Next.js, Vite and other bundlers handle with no setup; sass is optional (from 2.1):
Install these only for the features that need them. Each module named here comes from its own subpath, not the package root:
Icons ship inlined, so no icon library is required. To use more icons, register any React icon components — react-icons, lucide or your own SVGs — through IconProvider.
