Introduction
Why Leaf UI
Quiet by default
White and light-gray surfaces, fine borders, and light shadows build the hierarchy. Hover and press change only color, without lifting or bouncing. Ready to use, with your content always in focus.
Brand color and appearance
Apply a brand color, light or dark appearance, and compact density with ConfigProvider; related states derive automatically and the structure stays consistent. Nested themes, popups, and messages share the settings of their region.
Familiar React patterns
TypeScript declarations, native HTML attributes, and DOM refs are included. Use controlled or uncontrolled values, native form submission, and FormData.
Everyday components, in sync
Buttons, inputs, date pickers, tables, navigation, and feedback share consistent sizing and interaction rules. Use Lucide icons or pass your own icon nodes.
Ready for different languages
Built-in locales, custom translations, language fallbacks, and RTL direction are supported. Configure component messages while keeping application titles and labels in your own translation system.
Thoughtful interactions
Keyboard navigation, visible focus, disabled and loading states, and reduced-motion preferences are supported. Add an aria-label to icon-only buttons to give them an accessible name.
Environment support
Supports React 18 / 19, ESM / CommonJS, and server-side rendering. We recommend the current or previous stable release of a modern browser.
Chrome≥ 109
Edge≥ 109
Firefox≥ 121
Safari≥ 16.4
These are minimum support targets. See browser compatibility for tested environments and fallbacks, or server-side rendering for Next.js, TanStack Start, and other frameworks.
Start with one component
Install the library in an existing React project:
Import a component and start using it. Browser builds load the required styles automatically; you do not need Sass. Try the button below:
Next steps
- Installation and quick start: Set up the library in your project.
- Component overview: Find the components your interface needs.
- Theming: Customize brand colors, corners, and dark mode.
- Internationalization: Configure component languages for your application.