Back to Explore

tailwindlabs/headlessui

GitHub
1 updates · last 90 days1 watchersOpen source

Last release: 2026-04-07

Headless UI provides completely unstyled, fully accessible UI components for React and Vue, designed to work well with Tailwind CSS. It’s useful when you want accessibility features and behavior from the components, while styling the visuals yourself. You can install it via npm packages like @headlessui/react, @headlessui/vue, and related Tailwind integration.

Project status

  • Tailwindlabs/headlessui (notably @headlessui/react) appears actively maintained, with recent updates through at least v2.2.10 dated 2026-04-07, and the upstream repo showing a last push on 2026-04-13.
  • Apparent update cadence is steady but not rapid, with the most recent sequence showing v2.2.10 (2026-04-07), then v2.2.9 (2025-09-25), and subsequent earlier bug-fix updates roughly spaced across 2025.

AI summary generated 2026-06-04

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • @headlessui/react@v2.2.10

    2026-04-07

    Headless UI React v2.2.10 primarily fixes rendering problems related to React hydration and React.lazy boundaries. Specifically, it avoids rendering Portal during the server handoff/hydration phase, and it improves internal element resolution to prevent Symbol(react.lazy) related issues when passing props (notably around Fragment).

  • @headlessui/react@v2.2.9

    2025-09-25

    Headless UI React v2.2.9 focuses on interaction and focus-management fixes across Combobox, Listbox, Dialog, and related components, with special attention to mobile and shadow DOM behavior. It also adjusts Combobox typing and improves Listbox value freezing behavior when selection occurs.

  • @headlessui/react@v2.2.8

    2025-09-12

    Headless UI React v2.2.8 focuses on fixing correctness issues across multiple components, including Combobox keyboard interaction and several state synchronization and rendering edge cases. The release notes are almost entirely labeled as “Fixed”, with one notable TypeScript typing correction related to `onChange` variance.

    Breaking

  • @headlessui/react@v2.2.7

    2025-07-30

    v2.2.7 focuses on interaction correctness fixes for Menu, Listbox, and Combobox, including preventing double activation and avoiding hover-driven activation when navigating via keyboard. It also includes an SSR memory leak fix and an adjustment related to programmatic click behavior. Several pointer-activation internals were changed beyond what is explicitly described in the release notes.

  • @headlessui/react@v2.2.6

    2025-07-24

    This release (v2.2.6) includes a targeted fix for Listbox behavior related to premature closing. The code change modifies the shared quick-release pointer handling logic so it only triggers after a small amount of pointer movement.

  • @headlessui/react@v2.2.5

    2025-07-23

    Headless UI React v2.2.5 includes a fix intended to prevent the Listbox from closing immediately after opening on touch devices. The diff shows targeted changes to Listbox pointer and click handling, plus a small Jest DOM polyfill update to support pointerType.

  • @headlessui/react@v2.2.4

    2025-05-20

    This release of @headlessui/react (v2.2.4) is primarily a bug fix for Combobox virtual mode, addressing an unexpected undefined error. The release notes describe only that user-facing fix.

  • @headlessui/react@v2.2.3

    2025-05-12

    Headless UI React v2.2.3 adds a “quick trigger” action to Menu, Listbox, and Combobox, and includes several interaction fixes (Label behavior, focus restoration, Listbox option focus). It also claims a performance improvement around avoiding unnecessary rerenders when nesting components (for example, Menu inside Dialog).

    Features

  • @headlessui/react@v2.2.2

    2025-04-17

    v2.2.2 focuses on performance improvements to the `Menu`, `Listbox`, and `Combobox` components, plus a behavior tweak to open `Menu` and `Listbox` on `mousedown`. It also fixes `Transition` incorrectly exposing the `Closing` state.

  • @headlessui/react@v2.2.1

    2025-04-04

    This release of @headlessui/react v2.2.1 adds support for a tabIndex prop on Checkbox and RadioGroup, and fixes several accessibility and Combobox issues. In particular, it corrects aria-invalid to use a valid 'true' string and extends Combobox to properly expose an invalid state, including a fix for Combobox virtual mode behavior.

    Features