tailwindlabs

headlessui: Build Accessible, Unstyled UI Components

Headless UI provides unstyled, accessible components for React and Vue, designed to work with Tailwind CSS. It suits teams that want interaction and accessibility behavior without adopting a predesigned visual style.

View on GitHub Compare
Stars
28.8k
Forks
1.2k
Stars, last 30 days
+52

Our take

Health score

32/100

How it is scored
Activity
31
Community
57
Issues
21
Pull requests
20

+52 stars in the last 30 days

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

28,832

Forks

1,219

Change since Nov 16, 2026: +3 stars·+1 forks

Overview

Headless UI is a component library for building interfaces in React and Vue. It provides accessible component behavior without imposing visual styling, so teams can shape components to fit their own design system, including one built with Tailwind CSS.

It is a good fit when you want reusable UI building blocks but need control over their appearance. It is less suited to projects looking for a ready-made visual component theme.

Key Features

  • Provides component packages for React and Vue.
  • Leaves components unstyled, giving projects control over presentation.
  • Focuses on accessibility in its UI components.
  • Designed to integrate with Tailwind CSS.
  • Offers a Tailwind CSS package alongside its framework-specific packages.
  • Documents installation and usage at headlessui.com.

Use Cases

  • React teams building a custom design system that needs accessible component behavior without preset styling.
  • Vue developers who want reusable UI components while keeping control of their interface’s visual design.
  • Tailwind CSS projects that need component behavior to complement utility-based styling.
  • Product teams replacing repeated, custom-built interaction patterns with shared components.

Getting Started

Install the package for your framework:

npm install @headlessui/react@latest

For Vue, use npm install @headlessui/vue@latest. See the README and documentation for details.

Alternatives

  • 21st: 21st is a React registry of Tailwind and Radix UI components, while Headless UI provides unstyled accessible components for React and Vue.
ProjectLanguageLicenseStarsStatus
headlessuiTypeScriptMIT28.8kNot checked yet
21stTypeScriptMIT5.5kInactive

Considerations

  • Components do not provide a finished visual theme. You are responsible for styling them to suit your interface.
  • The project offers separate React and Vue packages, so choose the package that matches your framework.
  • The README notes that the insiders versions track the latest commit on main and do not follow semver, so their APIs may change before release.

Found this useful?

Share it with someone who would like headlessui.

Comparisons