Introduction
leve-ui is a library of headless, WAI-ARIA compliant UI components for Qwik. Bring your own styles.
Components handle the parts that are hard to get right — roles and ARIA attributes, keyboard interaction, focus management, and controlled or uncontrolled state — and leave every pixel of the design to you.
Why leve-ui#
- Accessible. Every component follows the WAI-ARIA Authoring Practices Guide (APG), including keyboard interaction and focus management, verified with E2E tests. Native HTML elements are used wherever they fit.
- Unstyled. Components ship no CSS. Each DOM element is a separate part that you style with classes or with the
data-*attributes the library outputs. - Install only what you use. Every component is its own package.
@leve-ui/corebundles all of them for convenience. - Built for Qwik and Web standards. Components are written with
component$, render on the server, resume without hydration, and render overlays in place using the browser's native top layer (<dialog>and the Popover API). - Works with native forms. Form controls integrate with Field for automatic label, description, and error wiring, and participate in native
<form>submission.
How components are built#
A component is a set of parts, one part per DOM element. You compose the parts yourself:
<Switch.Root>
<Switch.Label>Airplane mode</Switch.Label>
<Switch.Control>
<Switch.Thumb />
</Switch.Control>
</Switch.Root>
Every part accepts the attributes of the element it renders, such as class, style, id, aria-* and event handlers. The library adds the attributes the pattern requires (for example role="switch" and aria-checked) and data attributes for styling (for example data-state="checked").
Status#
leve-ui is in the 0.x series. Breaking changes can happen in minor releases (0.1 → 0.2) until 1.0; they are listed in each package's changelog and on GitHub Releases. leve-ui supports Qwik 1.x.
Inspirations#
The component API design — composable parts, data-state styling hooks, and polymorphic as props — draws inspiration from Ark UI, Base UI, and Radix UI, built from the ground up for Qwik's resumability and native web platform features.
Next steps#
- Getting started: install leve-ui and render your first component.
- Styling: style parts with classes, data attributes and CSS variables.
- Components: browse all components.