Introduction
Koala UI is a React component library you install as source. The CLI copies each component into your repo, themed through tokens, and the code is yours to edit.
What Koala UI is
Components, sections, page examples and templates for React 19 and Tailwind CSS v4. Radix primitives handle focus, keyboard and ARIA; tailwind-variants recipes handle the styling.
There is no runtime package to upgrade. add writes each component to components/ui/<name>/ with the helpers it needs, and you read and change it like any other file.
Every component reads semantic tokens, never a raw colour, radius or shadow. Four themes, an accent, a radius knob and a density axis restyle the whole system at once.
Start here
How a component arrives
Every install moves through the same five steps, whether you run the CLI or your agent does.
- Listed. The registry names every item with its tier, its files and what it depends on.
listprints it. - Resolved.
addwalks the item's components and lib helpers, so a Dialog brings what it imports. - Written. Files land in
components/uiandlib. A file that already exists is skipped unless you pass--overwrite. - Recorded.
koala.jsonkeeps the version of each item and a fingerprint of each file as written. - Installed. Missing npm packages go in with the package manager your lockfile points to.
Run the CLI
Set a project up once, then add what you need. Every command is in the CLI reference.
Free and Pro
The foundation components install with no account. Every other component, section, page example and template is Pro and needs a license key, activated once with login.