@meilisearch/instant-meilisearch
Advanced tools
The search client to use MeiliSearch with InstantSearch.
⚡ How to integrate a front-end search bar in your website using MeiliSearch
MeiliSearch is a powerful, fast, open-source, easy to use and deploy search engine. Both searching and indexing are highly customizable. Features such as typo-tolerance, filters, and synonyms are provided out-of-the-box.
This library is a plugin to establish the communication between your MeiliSearch instance and the open-source InstantSearch tools (powered by Algolia) for your front-end application.
Instead of reinventing the wheel, we have opted to reuse the InstantSearch library for our own front-end tooling. We will contribute upstream any improvements that may result from our adoption of InstantSearch.
If you use React or Vue, you might want to check out these repositories:
NB: If you don't have any MeiliSearch instance running and containing your data, you should take a look at this getting started page.
const searchClient = instantMeiliSearch(
"https://demos.meilisearch.com",
"dc3fedaf922de8937fdea01f0a7d59557f1fd31832cb8440ce94231cfdde7f25"
);
const searchClient = instantMeiliSearch(
"https://demos.meilisearch.com",
"dc3fedaf922de8937fdea01f0a7d59557f1fd31832cb8440ce94231cfdde7f25",
{
paginationTotalHits: 30, // default: 200.
placeholderSearch: false // default: true.
}
);
paginationTotalHits (200 by default): The total (and finite) number of hits you can browse during pagination.
It means, by default, you can browse paginationTotalHits / hitsPerPage = 200 / 20 = 10 pages during pagination.
By default, hitsPerPage is set to 20 but it can be changed with InsantSearch.configure
If the pagination widget is not set, this parameter is ignored.
placeholderSearch (true by default). Displays documents even when the query is empty.
The open-source InstantSearch library powered by Algolia provides all the front-end tools you need to highly customize your search bar environment.
In index.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
</head>
<body>
<div>
<div id="searchbox"></div>
<div id="hits"></div>
</div>
<script src="https://cdn.jsdelivr.net/npm/@meilisearch/instant-meilisearch/dist/instant-meilisearch.umd.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/instantsearch.js@4"></script>
<script src="./app.js"></script>
</body>
</html>
In app.js:
const search = instantsearch({
indexName: "steam-video-games",
searchClient: instantMeiliSearch(
"https://demos.meilisearch.com",
"dc3fedaf922de8937fdea01f0a7d59557f1fd31832cb8440ce94231cfdde7f25",
)
});
search.addWidgets([
instantsearch.widgets.searchBox({
container: "#searchbox"
}),
instantsearch.widgets.hits({
container: "#hits",
templates: {
item: `
<div>
<div class="hit-name">
{{#helpers.highlight}}{ "attribute": "name" }{{/helpers.highlight}}
</div>
</div>
`
}
})
]);
search.start();
🚀 For a full getting started example, please take a look at this CodeSandbox:
💡 If you have never used InstantSearch, we recommend reading this getting started documentation.
This package is compatible with the following MeiliSearch versions:
v0.13.XAny new contribution is more than welcome in this project!
If you want to know more about the development workflow or want to contribute, please visit our contributing guidelines for detailed instructions!
MeiliSearch provides and maintains many SDKs and Integration tools like this one. We want to provide everyone with an amazing search experience for any kind of project. If you want to contribute, make suggestions, or just know what's going on right now, visit us in the integration-guides repository.
FAQs
The search client to use Meilisearch with InstantSearch.
The npm package @meilisearch/instant-meilisearch receives a total of 18,187 weekly downloads. As such, @meilisearch/instant-meilisearch popularity was classified as popular.
We found that @meilisearch/instant-meilisearch demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 5 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.
Security News
A developer is accusing Tencent of violating the GPL by modifying a Python utility and changing its license to BSD, highlighting the importance of copyleft compliance.
Security News
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.