Search docs

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/core bundles 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.