An NPM package for running atomic updates to Algolia indices

This package runs atomic updates to Algolia Indices. What does that mean?

Simply put, this package reads your local index, and updates the new or updated records, while removing deleted records.

It does this all at once, so your index is never out of sync with your content, and you use the smallest amount of operations possible.

(Stay on that free plan as long as you can!)

To install this script, you must have Node & NPM installed. Once installed, run the following command in your terminal:

npm install atomic-algolia

This package can be used in NPM "scripts" or in Javascript Files.

It reads an array of objects or local JSON file with an array of valid records. For example:

[
    {
        "objectID": "1",
        "title": "An example record"
    }
]

To use this package in your NPM scripts, add the command to your script in package.json.

Note, this package can only be used in NPM scripts to update a single index from a local JSON file. To update multiple indices or pass in a Javascript object, create your own script by following the instructions in Javascript Files

E.g:

...
"scripts": {
    "algolia": "atomic-algolia"
}
...

Lastly, run your NPM command. E.g:

ALGOLIA_APP_ID={{ YOUR_APP_ID}} ALGOLIA_ADMIN_KEY={{ YOUR_ADMIN_KEY }} ALGOLIA_INDEX_NAME={{ YOUR_INDEX_NAME }} ALGOLIA_INDEX_FILE={{ YOUR_FILE_PATH }} npm run algolia

To use this package in your own local script, require it in your file. E.g:

var atomicalgolia = require("atomic-algolia")
var indexName = "example_index"
var indexPath = "./index.json"
var cb = function(error, result) {
    if (err) throw error

    console.log(result)
}

atomicalgolia(indexName, indexPath, cb)

Then call the script from your terminal as follows:

ALGOLIA_APP_ID={{ YOUR_APP_ID}} ALGOLIA_ADMIN_KEY={{ YOUR_ADMIN_KEY }} node YOUR_SCRIPT.js

var atomicalgolia = require("atomic-algolia")
var indexName = "example_index"

var indexData = [
    {
        objectID: "1",
        title: "An example record"
    }
]

var cb = function(error, result) {
    if (error) throw error

    console.log(result)
}

atomicalgolia(indexName, indexData, cb)

Then call the script from your terminal as follows:

ALGOLIA_APP_ID={{ YOUR_APP_ID}} ALGOLIA_ADMIN_KEY={{ YOUR_ADMIN_KEY }} node YOUR_SCRIPT.js

A .env file can be added to the root of your project with the required environment variables. This way, you don't have to specify them in package.json or when running the command.

Run the following command:

touch .env && open .env

Then paste in the following contents, and update the placeholder variable marked with braces {{ }}

ALGOLIA_APP_ID={{ YOUR_APP_ID }}
ALGOLIA_ADMIN_KEY={{ YOUR_ADMIN_KEY }}
ALGOLIA_INDEX_NAME={{ YOUR_INDEX_NAME }}
ALGOLIA_INDEX_FILE={{ YOUR_INDEX_FILE }}

ALGOLIA_APP_ID: the ID of the Algolia app instance that contains your index.

ALGOLIA_ADMIN_KEY: the adminstrative key for the Algolia app instance that contains your index.

ALGOLIA_INDEX_NAME: the name of the index you're updating.

ALGOLIA_INDEX_FILE: the relative path to your index file from the root of your project.

Thanks goes to these wonderful people (emoji key):

chrisdmacrae 💬 💻 🎨 📖

Tim Carry 💬 💻 📖

swamidass 🐛 💻

This project follows the all-contributors specification. Contributions of any kind welcome!