# algolia/docsearch

:blue_book: The easiest way to add search to your documentation.

Repository: https://github.com/algolia/docsearch
Canonical: https://ross.abutalabs.com/products/docsearch
Homepage: https://docsearch.algolia.com
Language: TypeScript
License: MIT
License Family: permissive
Topics: algolia, search, docsearch, documentation, javascript, react, typescript
Last push: 2026-08-24T21:45:20+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 3939, "days_push": 9, "days_rel": 9, "gap_med": 0.0, "n_releases_24m": 83}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4371, forks 438 (observed 2026-08-28T04:08:46.802412+00:00)

## What it is
DocSearch is Algolia's open-source solution for adding fast, accessible search to documentation sites, combining a hosted crawler that indexes docs into an Algolia index with JavaScript/React frontend packages that render a search modal. Version 5 adds AI-powered 'Ask AI' answers, a Sidepanel for persistent AI conversations, and an MCP server that makes docs searchable by AI agents.

## Use cases
- add search to my documentation site
- searchable docs dropdown for docusaurus or vitepress
- free search for open-source project documentation
- let users ask AI questions about my docs
- make my docs searchable by Claude or Cursor via MCP
- accessible keyboard-navigable search box for a blog or docs

## When to choose
- you run a documentation or technical blog site and want instant, relevant search with minimal setup
- you want a free hosted crawler plus polished, accessible search UI (WAI-ARIA compliant)
- you want AI answers grounded in your docs or MCP integration for AI coding agents
- you use Docusaurus, VitePress, React, or vanilla JS

## When to avoid
- you need full control over the search backend or want to avoid dependency on Algolia's hosted service and its 'Search by Algolia' attribution requirement
- your site content is not documentation-like and needs custom crawling logic beyond the DocSearch crawler
- you need self-hosted search with no external SaaS dependency

## Facets
- artifact type: library
- maturity: stable
- function: search-engine, ui-components, web-framework, mcp
- domain: documentation, web-development, frontend, developer-tools
- platform: browser
- tags: algolia, docsearch, documentation-search, react, autocomplete, ask-ai, crawler, accessibility, docusaurus, vitepress, search, nodejs, web-server

## Member repositories
- algolia/docsearch (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:46.802412+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:21:22.189466+00:00, confidence not recorded.
  - readme: https://github.com/algolia/docsearch (fetched 2026-08-28T04:08:46.802412+00:00, sha 116d2a9618f7)
  - homepage: https://docsearch.algolia.com (fetched 2026-08-29T09:10:06.590187+00:00, sha 8532a84da44c)
  - site_page: https://docsearch.algolia.com/docs/migrating-from-v4 (fetched 2026-08-29T09:10:06.612287+00:00, sha 1263129e947b)
  - site_page: https://docsearch.algolia.com/docs/packages/overview (fetched 2026-08-29T09:10:06.670793+00:00, sha 1616840383ed)
  - site_page: https://docsearch.algolia.com/docs/what-is-docsearch (fetched 2026-08-29T09:10:06.697572+00:00, sha 99e8b7d1cff1)
  - site_page: https://docsearch.algolia.com/docs/v4/what-is-docsearch (fetched 2026-08-29T09:10:06.719299+00:00, sha 9f46e84934b3)
  - site_page: https://docsearch.algolia.com/docs/v3/what-is-docsearch (fetched 2026-08-29T09:10:06.735740+00:00, sha 9d103a253e12)
  - site_page: https://docsearch.algolia.com/docs/legacy/dropdown (fetched 2026-08-29T09:10:06.767492+00:00, sha cfe6ef0a8c3b)
  - site_page: https://docsearch.algolia.com/docs/mcp/installation (fetched 2026-08-29T09:10:06.862218+00:00, sha 25833eede302)
- Data as of 2026-08-30T08:39:29.467469+00:00.