Getting Started
Peer Dependencies
Required peer dependencies for UnflowUI components to function correctly.
Required peers
| Package | Version | Why |
|---|---|---|
react | ^19.0.0 | Component rendering |
react-dom | ^19.0.0 | DOM rendering |
tailwindcss | ^4.0.0 | Utility CSS classes |
@floating-ui/react-dom | ^2.0.0 | Popper/Dropdown positioning |
i18next | ^23.0.0 | Built-in translations (optional) |
react-i18next | ^14.0.0 | React i18n bindings (optional) |
Floating UI
Popper, Dropdown, and ActionsDropdown use @floating-ui/react-dom for anchor-relative positioning. Install it separately:
npm install @floating-ui/react-domIf you only use components that don't require floating positioning (Button, Badge, Switch, Tag, Spinner, etc.), you can skip this dependency.
Tailwind CSS v4
UnflowUI requires Tailwind CSS v4 (not v3). The Tailwind v4 PostCSS plugin is separate from the tailwindcss package:
npm install tailwindcss @tailwindcss/postcss// postcss.config.mjs
export default {
plugins: { '@tailwindcss/postcss': {} },
};