https://github.com/algolia/algolia-firebase-nodejs

An example showing how to push data from Firebase to Algolia
https://github.com/algolia/algolia-firebase-nodejs

Last synced: 13 days ago
JSON representation

An example showing how to push data from Firebase to Algolia

• Host: GitHub
• URL: https://github.com/algolia/algolia-firebase-nodejs
• Owner: algolia
• Archived: true
• Created: 2017-03-19T03:52:10.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-09-08T16:25:54.000Z (about 7 years ago)
• Last Synced: 2024-04-11T05:18:22.451Z (7 months ago)
• Language: JavaScript
• Homepage:
• Size: 11.7 KB
• Stars: 24
• Watchers: 70
• Forks: 10
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# algolia-firebase-nodejs example

Algolia is a nice way to make your Firebase data searchable. Out of the box you get prefix matching, typo tolerance and more advanced features like faceting and filtering. This repository contains contains example code and instructions on how to run it.

## Key files

1. `importFirebaseToAlgolia.js`: Shows how to do a one-time import of all Firebase data under a specific ref.

1. `syncFirebaseToAlgolia.js`: Shows how to listen to changes of children of a ref and sync them to Algolia.

1. `loadFirebase.js`: Loads test data into Firebase so it can be sent to Algolia later.

## Prerequisites

#### Firebase

Create a [new Realtime Database](https://console.firebase.google.com), or you can use one that already exists. We'll be using the ref "contacts" for the whole example, so make sure there isn't any data there already.

#### Algolia

Create a [new Algolia application](https://www.algolia.com/manage/applications), or use one that already exists. We'll be creating an index called "contacts", so make sure that doesn't already exist.

## Usage

Clone this repository.

```

git clone [email protected]:algolia/algolia-firebase-nodejs.git

```

Install dependencies with `npm install` or `yarn`.

```

yarn

```

Create a file called `.env`. Substitute your values for the placeholders:

``` shell

ALGOLIA_APP_ID=

ALGOLIA_API_KEY=

FIREBASE_DATABASE_URL=https://.firebaseio.com

```

Make sure the Algolia API key you've chosen has write access. If in doubt, use your Admin API Key.

Download a service account JSON file from Firebase. This will be used to authenticate you as an admin so you can read and write data. From the Firebase console for your database, click the gear icon and choose "Project Settings". Go to the "Service Accounts" tab. Click "Generate New Private Key". Move the downloaded file into this directory and name it `serviceAccountKey.json`.

This file and .env are in the .gitgnore, so you don't have to worry about accidentally checking them in.

#### Load example data

Load example contacts data into your Firebase database running:

```

node loadFirebase

```

Look at the code in the `loadFirebase.js` file to see what is happening. If this is successful, you will see a message "Contacts loaded to firebase" and you will be able to see data in your Firebase database in the console.

#### First-time import into Algolia

Import these contacts records into Algolia by running:

```

node importFirebaseToAlgolia

```

If this is successful, you should see "Firebase<>Algolia import done". Your contact records have been imported into Algolia and you can see them in your dashboard.

#### Ongoing sync to Algolia

In a real application, you will want to listen for Firebase changes and index them as they come in. To do this, run:

```

node syncFirebaseToAlgolia

```

This process will keep running indefinitely, listening for changes to the "contacts" node in your Firebase database. When it receives a change, it will add, update or delete the record in Algolia and then log to the console.