# instantsearch-ui-components

> Common UI components for InstantSearch.

Latest version **0.40.1** (published 2026-09-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install instantsearch-ui-components
pnpm add instantsearch-ui-components
yarn add instantsearch-ui-components
bun add instantsearch-ui-components
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.40.1 |
| Published | 2026-09-15 |
| First published | 2024-01-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 662.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 4059 |
| Author | Algolia, Inc. |
| Maintainers | haroenv, jasonberry, instantsearch-bot, dhaya.b, fabienmotte, anjola-algolia, sarahdayanalgolia |
| Keywords | algolia, components, fast, instantsearch, react, search, jsx, vdom, hyperscript |

## Links

- npm: https://www.npmjs.com/package/instantsearch-ui-components
- Repository: https://github.com/algolia/instantsearch
- Homepage: https://github.com/algolia/instantsearch#readme
- Issues: https://github.com/algolia/instantsearch/issues
- npm.io page: https://npm.io/package/instantsearch-ui-components

## Dependencies (2)

- [@swc/helpers](https://npm.io/package/@swc/helpers.md) 0.5.18
- [markdown-to-jsx](https://npm.io/package/markdown-to-jsx.md) ^7.7.15

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 0.40.1 (latest) — 2026-09-15
- 0.40.0 — 2026-09-03
- 0.39.0 — 2026-09-01
- 0.38.0 — 2026-08-31
- 0.37.0 — 2026-08-25
- 0.36.0 — 2026-08-19
- 0.35.1 — 2026-08-13
- 0.35.0 — 2026-08-12
- 0.34.0 — 2026-08-06
- 0.33.2 — 2026-07-23
- 0.33.1 — 2026-07-07
- 0.33.0 — 2026-06-30
- 0.32.0 — 2026-06-25
- 0.31.0 — 2026-06-19
- 0.30.1 — 2026-06-10
- … 37 more at https://npm.io/package/instantsearch-ui-components/versions

## README

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

- [instantsearch-ui-components](#instantsearch-ui-components)
  - [Contributing](#contributing)
  - [License](#license)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

# instantsearch-ui-components

InstantSearch UI Components is an open-source UI library used by InstantSearch to build UI for search and discovery interfaces. It exports UI components that are compatible with InstantSearch.js, React InstantSearch, and Vue InstantSearch.

> Note: `instantsearch-ui-components` exists for internal usage and isn't designed for public consumption.

## Contributing

We welcome all contributors, from casual to regular 💙

- **Bug report**. Is something not working as expected? [Send a bug report][contributing-bugreport].
- **Feature request**. Would you like to add something to the library? [Send a feature request][contributing-featurerequest].
- **Documentation**. Did you find a typo in the doc? [Open an issue][contributing-newissue] and we'll take care of it.
- **Development**. If you don't know where to start, you can check the open issues that are [tagged easy][contributing-label-easy], the [bugs][contributing-label-bug] or [chores][contributing-label-chore].

To start contributing to code, you need to:

1.  [Fork the project](https://help.github.com/articles/fork-a-repo/)
1.  [Clone the repository](https://help.github.com/articles/cloning-a-repository/)
1.  Install the dependencies: `yarn`

Please read [our contribution process](https://github.com/algolia/instantsearch/blob/master/CONTRIBUTING.md) to learn more.

## License

InstantSearch UI Components is [MIT licensed](../../LICENSE).

<!-- Links -->

[contributing-bugreport]: https://github.com/algolia/instantsearch/issues/new?template=BUG_REPORT.yml&labels=triage,Library%3A%20React+InstantSearch
[contributing-featurerequest]: https://github.com/algolia/instantsearch/discussions/new?category=ideas&labels=triage,Library%3A%20React+InstantSearch&title=Feature%20request%3A%20
[contributing-newissue]: https://github.com/algolia/instantsearch/issues/new?labels=triage,Library%3A%20React+InstantSearch
[contributing-label-easy]: https://github.com/algolia/instantsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22Difficulty%3A+Easy%22+label%3A%22Library%3A%20React+InstantSearch%22
[contributing-label-bug]: https://github.com/algolia/instantsearch/issues?q=is%3Aissue+is%3Aopen+label%3A%22Type%3A+Bug%22+label%3A%22Library%3A%20React+InstantSearch%22
[contributing-label-chore]: https://github.com/algolia/instantsearch/issues?q=is%3Aissue+is%3Aopen+label%3A%22Type%3A+Chore%22+label%3A%22Library%3A%20React+InstantSearch%22

---
_Source: https://npm.io/package/instantsearch-ui-components · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._