Introduction
Why moduix exists and what it is built for.
moduix
Moduix is a React component library built for real product work. I started it for my own work projects because our styling layer is plain native CSS, and I wanted a convenient set of primitives that still felt ergonomic, composable, and predictable in day-to-day development.
The library is built on top of Base UI, so the difficult behavior, accessibility, focus management, and low-level primitive work stays close to a strong foundation. moduix adds ready-made structure, default styling, CSS variables, examples, and documentation around those primitives.
The project is also an experiment in combining two workflows that are usually separate. You can use moduix as a regular npm package and receive updates through package management, or copy component source when a project needs direct ownership and local customization.
Dependency philosophy
One primitive foundation
I built moduix with the idea that the component layer should stay quiet: one external primitive foundation, plain CSS, and React composition instead of a stack of UI runtime dependencies.
components
Behavior
Base UI
Styling
native CSS
API
React parts
Base UI owns the hard accessibility and interaction primitives; moduix keeps the product surface, defaults, tokens, and examples close to your application code.
I am not trying to compete with shadcn/ui or claim that this is the one right way to build interfaces. shadcn/ui is a huge inspiration for the composition-first API and the idea that components should be easy to read, own, and customize. moduix is simply the shape that works well for my projects. If it fits yours too, I will be glad.
What You Get
- React components built on accessible Base UI primitives.
- Default styles that work immediately, without owning your application reset.
- CSS variables for fast theming and focused per-component customization.
- A composition-first API with named parts instead of one large configuration surface.
- A dependency-light design centered on Base UI as the primitive foundation.
- A path for both package-managed usage and copy-owned component code.
- Documentation examples that show practical usage and customization patterns.
- A CSS playground in component previews, so you can test style changes live.
Acknowledgements
This project could not exist without the work of these teams and communities:
- Base UI for the accessible React primitives that power the components.
- shadcn/ui for the API inspiration and the culture of practical, readable component composition.
- Tailwind CSS for the reset.css implementation.
- Fumadocs for the documentation foundation.
- TanStack for the application tooling used by the docs.
- Voidzero for awesome JS tools