github.com/algolia/docsearch @v4.6.3 sqlite

The easiest way to add search to your documentation – for free.

Documentation • JavaScript Playground • React Playground

DocSearch crawls your documentation, pushes the content to an Algolia index and provides a dropdown search experience on your website.

Preview

Usage

Don't have your Algolia credentials yet? Apply to DocSearch!

JavaScript

Installation

yarn add @docsearch/js@4
# or
npm install @docsearch/js@4

If you don’t want to use a package manager, you can use a standalone endpoint:

<script src="https://cdn.jsdelivr.net/npm/@docsearch/js@4"></script>

Get started

To get started, you need a container for your DocSearch component to go in. If you don’t have one already, you can insert one into your markup:

Then, insert DocSearch into it by calling the docsearch function and providing the container. It can be a CSS selector or an Element.

Make sure to provide a container (for example, a div), not an input. DocSearch generates a fully accessible search box for you.

```js app.js import docsearch from '@docsearch/js';

import '@docsearch/css';

docsearch({ container: '#docsearch', appId: 'YOUR_APP_ID', indexName: 'YOUR_INDEX_NAME', apiKey: 'YOUR_SEARCH_API_KEY', });

### React

#### Installation

```bash
yarn add @docsearch/react@4
# or
npm install @docsearch/react@4

If you don’t want to use a package manager, you can use a standalone endpoint:

<script src="https://cdn.jsdelivr.net/npm/@docsearch/react@4"></script>

Get started

DocSearch generates a fully accessible search box for you.

```jsx App.js import { DocSearch } from '@docsearch/react';

import '@docsearch/css';

function App() { return ( ); }

export default App; ```

Styling

Read documentation →

Related projects

DocSearch is made of the following repositories:

• algolia/docsearch: DocSearch source code.
• algolia/docsearch/packages/website: DocSearch website and documentation.
• algolia/docsearch-configs: DocSearch websites configurations that DocSearch powers.
• algolia/docsearch-scraper: DocSearch crawler that extracts data from your documentation.

Used by

DocSearch is used by Bootstrap, Cheerio, Element Plus, Authelia, MDX, VitePress and many more.

Generated with usedby.dev

License

MIT