Headless Kit v0.2.2


An open source component set optimized to work with Qwik

Qwik UI Headless Kit provides a complete set of totally customizable components with built-in structure, behavior, and state. This library serves as a foundation of your design system, providing the missing or non-existent functionality from native solutions.

It gives you, the developer, more time to focus on what matters most, building your awesome app! Apply your favorite styling technology, CSS-in-JS, Tailwind CSS, or whatever floats your boat. Add just a few ad hoc styles or implement a full-on design system, Qwik UI Headless makes it easy.


In 2024, developers should not have to recreate the same WAI-Aria Patterns from scratch. Building custom components is challenging, and developers shouldn't need to reinvent common UI patterns.

Our aim is to ensure Qwik UI is not just an effective, but also a simple, reliable, and flexible choice for developing applications.

Qwik UI Headless is optimized to squeeze every possible ounce of performance out of Qwik (Like lemonade from lemons that had a run-in with a steamroller.) πŸ₯€

Why Qwik UI Headless?

The client and the server

Like Qwik itself, Qwik UI is super performant because it renders everything it can on the server

Unlike many other solutions that focus solely on client-side components, Qwik UI takes advantage of the server, the client, and the concept of resumability.

This means that Qwik UI can operate with any meta-framework that supports Qwik, including the full framework benefits. At the time of writing, that includes Qwik City and Astro.

Embracing native first

Qwik values HTML as the source of truth, and this principle extends to Qwik UI components. We appreciate and adopt the excellent work done by the Open UI Group when appropriate.

This approach also encompasses future native APIs. Users of Qwik UI might find themselves using components that can be gradually adopted into the native specification. This implies that, eventually, these custom patterns might not need any JavaScript.

Thanks to resumability, we do less work because there are less components to execute. With Qwik UI we build on top of that, providing the same functionality with less code needed to prefetch in the first place.



Qwik UI is a headless library, and comes with zero or very minimal styling. This means the design of your components are completely customizable.

This is in contrast to styled libraries such as Bootstrap or Material UI, where styles often need to be stripped in order to be custom.

Accessible at its core

Everyone should have equal access to information and functionality on the web. Every Qwik UI component is designed to follow the WCAG Guidelines.

However, it's a common misconception that meeting WCAG success criteria guarantees full accessibility of your components. Unfortunately, this is not the case.

The ultimate measure of your components' accessibility is user testing. This aspect, often overlooked in other projects, is a high priority for us.

Developer Experience that matches UX

Many libraries tout their excellent Developer Experience (DX), but this doesn't necessarily translate into a superior User Experience (UX).

Conversely, some packages offer great UX, but fall short when it comes to DX.

One of the benefits of Qwik is its ability to create performant applications without compromising on DX. Our goal is to extend this same balance of performance and ease-of-use to those utilizing Qwik UI components.

Some examples being:

Community Driven

Qwik UI is for the community, by the community. An open source project that would not be where it is without the awesome work of its contributors.



We strongly believe in having a learner's mindset, and as such, we've drawn inspiration from a multitude of projects, learning from their successes and challenges.

Qwik UI's development has been shaped by the following remarkable projects: