gatsby-firestore

Gatsby plugin for connecting Firebase Firestore as a data source. Supports subcollections.

Usage

1. Generate and download a Firebase Admin SDK private key by accessing the Firebase Project Console > Settings > Service Accounts

2. Rename and put the downloaded .json crendtial file somewhere in the GatsbyJS project (e.g. ./credentials.json)

3. Add gatsby-source-firestore as a dependency by running using npm or yarn:

   npm i @martinreiche/gatsby-firestore
   # or
   yarn add @martinreiche/gatsby-firestore

4. Configure settings at gatsby-config.js, for example:

   module.exports = {
     plugins: [
       {
         resolve: `@martinreiche/gatsby-firestore`,
         options: {
           // credential or appConfig
           credential: require(`./credentials.json`),
           appConfig: {
             apiKey: 'api-key',
             authDomain: 'project-id.firebaseapp.com',
             databaseURL: 'https://project-id.firebaseio.com',
             projectId: 'project-id',
             storageBucket: 'project-id.appspot.com',
             messagingSenderId: 'sender-id',
             appID: 'app-id',
           },
           types: [
             {
               type: `Book`,
               collection: `books`,
               map: doc => ({
                 title: doc.title,
                 isbn: doc.isbn,
                 author___NODE: doc.author.id,
               }),
             },
             {
               type: `Author`,
               collection: `authors`,
               map: doc => ({
                 name: doc.name,
                 country: doc.country,
                 books___NODE: doc.books.map(book => book.id),
               }),
             },
           ],
         },
       },
     ],
   };

   Note that you will need to have books and authors in Firestore matching this schema before Gatsby can query correctly, e.g books__NODE on author needs to be an array with books as a key of reference types to book documents.

   Test GraphQL query:

   {
     allBooks {
       edges {
         node {
           title
           isbn
           author {
             name
           }
         }
       }
     }
   }

Support for subcollections

To query subcollections, you have to specify the subCollection Array in the types configuration. They can be nested infinitely deep as long as they exist in Firestore. For example, if books were a subcollection of authors in Firestore, you could do the following:

module.exports = {
  plugins: [
    {
      resolve: `@martinreiche/gatsby-firestore`,
      options: {
        // credential or appConfig
        credential: require(`./credentials.json`),
        appConfig: {
          apiKey: 'api-key',
          authDomain: 'project-id.firebaseapp.com',
          databaseURL: 'https://project-id.firebaseio.com',
          projectId: 'project-id',
          storageBucket: 'project-id.appspot.com',
          messagingSenderId: 'sender-id',
          appID: 'app-id',
        },
        types: [
          {
            type: `Author`,
            collection: `authors`,
            map: doc => ({
              name: doc.name,
              country: doc.country,
            }),
            subCollections: [
              {
                type: `Book`,
                collection: `books`,
                map: doc => ({
                  title: doc.title,
                  isbn: doc.isbn,
                }),
              },
            ],
          },
        ],
      },
    },
  ],
};

books now become children of author and you can query them like this:

{
  allAuthor {
    edges {
      node {
        name
        childrenBook {
          title
          isbn
        }
      }
    }
  }
}

Configurations

Acknowledgement

• ryanflorence/gatsby-source-firebase
• taessina/gatsby-source-firestore