Meilisearch | Documentation | Slack | Roadmap | Website | FAQ
⚡ The Meilisearch API extension written for Firebase
Author: Meilisearch (https://meilisearch.com)
Description: Full-text Search on Firebase with Meilisearch
Details: Use this extension to synchronize documents from a Cloud Firestore collection to a Meilisearch index. This allows you to use full-text search in your Cloud Firestore documents.
This extension listens to each creation, update, or deletion of your documents to keep them in sync with your Meilisearch index. This ensures that the data in Meilisearch mirrors your content in Cloud Firestore. You can then run queries on this mirrored dataset.
Note that this extension only listens for changes to documents in a specific collection, but not changes in any subcollection. However, you can install additional instances of this extension to listen to other collections in your Firestore database.
Before installing this extension, you'll need to:
- Set up Cloud Firestore in your Firebase project
- Run a Meilisearch instance. There are many easy ways to download and run a Meilisearch instance
Documents indexed in Meilisearch must have a unique id. The extension will use Firestore's default field: Document ID for this purpose. Document ID will be renamed to_firestore_id to be used as the document id. If your documents have another field containing the string id, it will not be set as the primary key.
Important: If your documents contain a field called _firestore_id, it will be ignored.
Geosearch has a specific format in Meilisearch, your documents must have a valid _geo field with an object composed of lat and lng. If a GeoPoint from Firestore with the name _geo is found, the field latitude is renamed to lat and longitude to lng.
If a GeoPoint is found without the name _geo, it is added as an array.
This extension does not export all existing documents into Meilisearch unless they have been modified or created after its installation. You can run the import script provided by this extension to retrieve your Meilisearch dataset with all the documents present in your Firestore collection
To install an extension, your project must be on the Blaze (pay as you go) plan
- You will be charged a small amount (typically around $0.01/month) for the Firebase resources required by this extension, even if it is not used.
- This extension uses other Firebase or Google Cloud services which may have
associated charges if you exceed the service’s free tier:
- Cloud Firestore
- Cloud Functions (Node.js 10+ runtime. See FAQs)
When you use Firebase extensions, you're only charged for the underlying resources that you use. A paid-tier billing plan is only required if the extension uses a service that requires a paid-tier plan, for example calling a Google Cloud API or making outbound network requests to non-Google services. All Firebase services offer a free tier of usage. Learn more about Firebase billing.
Configuration Parameters:
-
Cloud Functions location: Where do you want to deploy the functions created for this extension? If you need help selecting a location, refer to the location selection guide.
-
Collection path: What is the path of the collection you would like to export into Meilisearch?
-
Fields to index in Meilisearch: What fields do you want to index in Meilisearch? Create a comma-separated list of the field names, or leave it blank to include all fields. The id field is always indexed even when omitted from the list.
-
Meilisearch Index Name: What Meilisearch index do you want to index your data in?
-
Meilisearch host: What is the URL of the host of your Meilisearch database? Make sure your URL starts with
http://orhttps:// -
Meilisearch API key: What is your Meilisearch API key with permission to perform actions on indexes? Both the API keys and the master key are valid choices but we strongly recommend using an API key for security purposes. Check out our guide on security.
Cloud Functions:
- indexingWorker: Cloud function triggered by document modification in Firestore to import changes into Meilisearch.
firebase ext:install meilisearch/firestore-meilisearch --project=[your-project-id]Learn more about installing extensions in the Firebase Extensions documentation: console, CLI
This package only guarantees the compatibility with the version v0.28.0 of Meilisearch.
Any new contribution is more than welcome in this project!
If you want to know more about the development workflow or wish to contribute, please see 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 wish to contribute, make suggestions, or want to know what's going on right now, visit the integration-guides repository.