- ×Show All
- CDN (
- npm package
- Bower package
Please see Environment Support.
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
To download Node.js visit https://nodejs.org/en/download/.
In addition to Node.js we use
yarnto facilitate multi package development.
yarnfollow the instructions listed on their website: https://yarnpkg.com/en/docs/install
The closure compiler requires a modern Java installation. Java 8+ should be installed: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
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.0or greater, your
yarnversion should be
1.0.0or greater, and your
javaversion should be
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
Once you have Node.js and
yarninstalled 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:
Once you have installed all the dependencies, you can build the entire SDK by running the following command the root of the SDK:
$ yarn build
Testing the SDK
A production project is required to test the Firebase JS SDK. You can create a new project by visiting the Firebase Console.
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.
Visit the authentication config in your project and enable the
Anonymoussign-in provider to complete your project config.
The remainder of the test setup requires choosing a test project. You can choose the project manually or specify the project directly at the root of the package.
# Select a project manually when running setup $ yarn test:setup # Specify the specific project for setup $ yarn test:setup --projectId=<your-test-project>
Running the tests
Each of the directories in the
integrationdirectory as well as the
packagesdirectory have their own test suites. You will need to build the SDK before running tests. Test suites can be run all together 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 testin an individual package directory.
Building the SDK
Each package in the
packagesdirectory, constitute a piece of our implementation. The SDK is built via a combination of all of these packages which are published under the
firebasescope on NPM.
Each package in the
packagesdirectory exposes a
devscript. This script will set up a watcher for development on the individual piece of the SDK. In addition, there is a top level
devscript 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
As part of this repo, we use the NPM package
huskyto implement git hooks. We leverage the prepush hook to do two things:
- Automated code styling (using
- Automated LICENSE header insertion
Cross-browser Testing Platform and Open Source <3 Provided by Sauce Labs
- CDN (