Afosto Instant Search Client

This library is an Afosto search client plugin for the open-source InstantSearch.js library (powered by Algolia). With this plugin you can use the amazing widgets of the InstantSearch.js library, while communicating with the Afosto search API.

> Don't want to implement your own UI? You can also try our Afosto instant search widget.

Installation

$3

``sh


Install with Yarn

yarn add @afosto/instant-search-client instantsearch.js

Install with NPM

npm install @afosto/instant-search-client instantsearch.js
`

$3

`sh


Install with Yarn

yarn add @afosto/instant-search-client react-instantsearch-dom

Install with NPM

npm install @afosto/instant-search-client react-instantsearch-dom
`

$3

This library supports the last two versions of major browsers (Chrome, Edge, Firefox, Safari).

`html


`

Getting started

> To use the client you will need an Afosto search engine. Don't have one yet? Sign up on Afosto.com and follow the guides in our documentation.

First you initialize the Afosto search client with your search engine key. This search engine key can be found in the Afosto app.

$3

`js
import { afostoInstantSearch } from '@afosto/instant-search-client';

const client = afostoInstantSearch('my-search-engine-key');
`

$3

`js
const { afostoInstantSearch } = require('@afosto/instant-search-client');

const client = afostoInstantSearch('my-search-engine-key');
`

$3

`js
const client = afostoInstantSearch('my-search-engine-key');
`

Usage

Note: This library is a client for InstantSearch.js it does not contain any UI components by itself. You can use it with the InstantSearch.js library as shown below:

$3

`js
const client = afostoInstantSearch('my-search-engine-key');
const search = instantsearch({
indexName: 'my-index',
searchClient: client,
});

search.start();
`

For more information check the InstantSearch.js documentation.

$3

`js
const client = afostoInstantSearch('my-search-engine-key');

async function initSearch() {
const settings = await client.getSettings();
const [firstIndex] = settings.indexes || [];

const search = instantsearch({
indexName: firstIndex.alias,
searchClient: client,
});

// Do something with the settings.
// For example render filters dynamically.

search.start();
}

initSearch();
`

$3

You can use the initialized Afosto client with the React InstantSearch library.

`js
import { afostoInstantSearch } from '@afosto/instant-search-client';
import { InstantSearch, SearchBox, Hits } from 'react-instantsearch-hooks-web';

const searchClient = afostoInstantSearch('my-search-engine-key');

const App = () => (




);
``

For more information check the React InstantSearch documentation.

Compatibility

- InstantSearch.js v4
- Node >= 14

License

This project is licensed under the terms of the MIT license.