Windmill React UI - Accessible React component library for Tailwind CSS
A free, open-source React component library built on Tailwind CSS with built-in dark mode, full accessibility support, and live code examples for rapid UI development.
Enable dark theme with a single prop on the root Windmill provider component.
Every component is built and tested with a real screen reader for compliance.
Fully open-source under the MIT license for personal and commercial projects.
Documentation includes interactive, editable examples for every component.
Extend or override the default theme through the Tailwind CSS config file.
Full branch, function, line, and statement coverage enforced on every commit.
Build accessible interfaces faster with ready-made React components
Windmill React UI is a free, open-source component library designed for React developers who need to ship accessible, polished interfaces quickly. Built on Tailwind CSS, it prioritizes accessibility from the ground up — every component has been developed and validated using a real screen reader. A single prop on the root provider enables dark mode across your entire application, eliminating the need for manual theme wiring. The library is written in TypeScript and distributed via npm, making it straightforward to integrate into existing React projects.
What's included
- Pre-built UI components with consistent styling and behavior
- Built-in dark theme that activates with a single prop
- Default theme configuration extendable through Tailwind's config file
- Focus lock management for modals and overlays
- Transition helpers for animated component states
- TypeScript type declarations and source maps
- Interactive documentation with live, editable code examples
Ideal for
- Internal tools and admin dashboards needing accessible components
- React developers who want dark mode without custom implementation
- Teams building applications that must meet accessibility standards
- Rapid prototyping where consistent, styled components save time
- Side projects and MVPs that benefit from a lightweight component set
Accessibility
Every component in the library was built with screen reader compatibility as a core requirement rather than an afterthought. Focus management is handled automatically for interactive elements like modals through the included focus lock dependency. This makes the library a strong choice for teams that need to meet accessibility guidelines without investing significant time in custom ARIA implementations.
Theming & dark mode
Dark mode works through a single useTheme prop on the root Windmill provider component. The default theme can be customized or completely overridden by wrapping your Tailwind configuration with the library's config helper. This approach keeps all style tokens centralized and avoids scattered inline overrides across your codebase.
Good to know
- Licensed under MIT, free for personal and commercial use
- Requires React 16.8+ and Tailwind CSS 2.x as peer dependencies
- The library enforces 100% test coverage across branches, functions, and lines
