Skip to content
Branch: master
Clone or download
egilmorez Add firestore.FieldValue.increment to index.d.ts (#1632)
* Adding firestore.FieldValue.increment.
Latest commit 03a4c8d Mar 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add new storage owner Feb 27, 2019
.vscode Fix vscode test runners based on changes in #1561. (#1584) Mar 7, 2019
config add deps update configuration to all projects (#1599) Mar 12, 2019
integration Publish firebase@5.9.1 Mar 21, 2019
packages Add firestore.FieldValue.increment to index.d.ts (#1632) Mar 25, 2019
scripts Add html extension to toc on homepage (#1625) Mar 22, 2019
tools Fix bugs in internal rollup config (#1530) Feb 16, 2019
.browserslistrc Update Chrome and Safari version in cross-browser test. Jun 1, 2018
.editorconfig Add Cloud Firestore Support Oct 3, 2017
.gitignore Add autodocumentation scripts that run Typedoc (#1553) Feb 27, 2019
.prettierignore Open Source Firebase Authentication (#273) Oct 30, 2017
.prettierrc Monorepo Refactor (#171) Oct 7, 2017
.yarnrc Upgrade dependencies (#676) Apr 12, 2018 Monorepo Refactor (#171) Oct 7, 2017 Remove IE9 and 10 in (#342) Nov 29, 2017
LICENSE feat(*): initial open source push (#2) May 16, 2017 [README] Supported Node.js versions for SDK development (#1359) Nov 5, 2018
lerna.json Do not print duplicate error messages to stdout. (#1468) Jan 18, 2019
package.json Modify doc generation script to also generate node reference docs (#1604 Mar 15, 2019
yarn.lock exclude karma-sauce-launcher in dep auto update (#1609) Mar 15, 2019

Firebase Javascript SDK

Build Status Build Status

The Firebase JavaScript SDK implements the client-side libraries used by applications using Firebase services. This SDK is distributed via:

To get started using Firebase, see Add Firebase to your JavaScript Project.

Current Release Notes

SDK Dev Workflow



Before you can start working on the Firebase JS SDK, you need to have Node.js installed on your machine. The currently supported versions are 8.0.0 or greater, but smaller than 10.0.0.

To download Node.js visit

NOTE: You can use a tool like NVM or N to install and manage multiple node versions


In addition to Node.js we use yarn to facilitate multi package development.

To install yarn follow the instructions listed on their website:


The closure compiler requires a modern Java installation. Java 8+ should be installed:

Verify Prerequisites

You can verify your setup by running the following commands in your terminal:

$ node -v
$ yarn -v
$ java -version

Your Node.js version should be 8.0.0 or greater, your yarn version should be 1.0.0 or greater, and your java version should be 1.8.0 or greater.

NOTE: We will update the documentation as new versions are required, however for continuing development on the SDK, staying up to date on the stable versions of these packages is advised

Install Dependencies

Once you have Node.js and yarn installed on your machine and have validated that you are running the proper version, you can set up the development environment by running the following at the root of the SDK:

$ yarn

Testing the SDK

Test Setup

A production project is required to test the Firebase JS SDK. You can create a new project by visiting the Firebase Console.

Firestore Support

Visit the database section of the console and enable the Cloud Firestore Beta. You can select either of the default permissions settings as we will overwrite them below.

Authentication Support

Visit the authentication config in your project and enable the Anonymous sign-in provider to complete your project config.

Automated Setup

The remainder of the test setup can be done by running the following command at the root of the package:

yarn test:setup

Running the tests

Each of the directories in the integration directory as well as the packages directory have their own test suites. These can be run altogether by running the following command at the root of the package:

$ yarn test

In addition, you can run any of the tests individually by running yarn test in an individual package directory.

Building the SDK


The Firebase JS SDK is built with a series of individual packages that are all contained in this repository. Development is coordinated via yarn workspaces and Lerna (a monorepo management tool).

Each package in the packages directory, constitute a piece of our implementation. The SDK is built via a combination of all of these packages which are published under the firebase scope on NPM.

Helper Scripts

Each package in the packages directory exposes a dev script. This script will set up a watcher for development on the individual piece of the SDK. In addition, there is a top level dev script that can be run to start all of the watch tasks as well as a sandbox server.

You can run the dev script by running the following at the root of the package:

yarn dev

Prepush Hooks

As part of this repo, we use the NPM package husky to implement git hooks. We leverage the prepush hook to do two things:

  • Automated code styling (using prettier)
  • Automated LICENSE header insertion


See Contributing for more information on contributing to the Firebase JavaScript SDK.

Big Thanks

Cross-browser Testing Platform and Open Source <3 Provided by Sauce Labs

You can’t perform that action at this time.