firebase/firebase-js-sdk


Firebase Javascript SDK

https://firebase.google.com/docs/web/setup

License: Apache-2.0

Language: TypeScript

Keywords: firebase, firebase-auth, firebase-authentication, firebase-cloud-messaging, firebase-database, firebase-db, firebase-messaging, firebase-realtime-database, firebase-storage, javascript, real-time, typescript


Firebase Javascript SDK

Build Status Build Status Version

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.

Release Notes

SDK Dev Workflow

Prerequisites

Node.js

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 https://nodejs.org/en/download/.

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

Yarn

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

To install yarn follow the instructions listed on their website: https://yarnpkg.com/en/docs/install

Java

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

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

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

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 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 integration directory as well as the packages directory 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 test in an individual package directory.

Building the SDK

Introduction

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

Contributing

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

Project Statistics

Sourcerank 19
Repository Size 66.6 MB
Stars 2,351
Forks 379
Watchers 158
Open issues 223
Dependencies 2,832
Contributors 78
Tags 1,205
Created
Last updated
Last pushed

Top Contributors See all

Sebastian Schmidt Michael Lehenbauer Feiyang Mertcan Mermerkaya Christina Holland Greg Soltis David East wti806 Josh Crowther Ryan Brewster bojeil-google Yifan Yang Gil rsgowman Matt Gaunt Brian Chen Josep Sayol var-const pinarx Bryan Klimt

Packages Referencing this Repo

@firebase/remote-config
The Remote Config package of the Firebase JS SDK
Latest release 0.1.1 - Updated - 2.35K stars
@firebase/remote-config-types
@firebase/remote-config Types
Latest release 0.1.1 - Updated - 2.35K stars
@firebase/analytics
A analytics package for new firebase packages
Latest release 0.2.1 - Updated - 2.35K stars
firebase-jggc
Firebase JavaScript library for web and Node.js
Latest release 5.8.0-jggc-9 - Updated - 2.35K stars
@firebase/testing
This is the testing component for the Firebase JS SDK.
Latest release 0.14.0 - Updated - 2.35K stars
saipos-firebase-wrapper
Monorepo for the Firebase JavaScript SDK
Latest release 0.1.1 - Updated - 2.35K stars
@firebase/performance-types
@firebase/performance Types
Latest release 0.0.4 - Updated - 2.35K stars
@firebase/installations-types
@firebase/installations Types
Latest release 0.2.0 - Updated - 2.35K stars
firebase-database-proxied
This is the Firebase Realtime Database component of the Firebase JS SDK.
Latest release 0.3.4-canary.c29fea1 - Published - 2.35K stars
firebase-tor
Firebase JavaScript library for web and Node.js
Latest release 5.2.3 - Updated - 2.35K stars
firebase-proxied
Firebase JavaScript library for web and Node.js
Latest release 5.2.0-canary.c29fea1 - Published - 2.35K stars
org.webjars.npm:firebase
WebJar for firebase
Latest release 4.13.1 - Updated - 2.35K stars
firebase-tor-database
This is the Firebase Realtime Database component of the Firebase JS SDK.
Latest release 0.3.7 - Updated - 2.35K stars
firebase-tor-util
_NOTE: This is specifically tailored for Firebase JS SDK usage, if you are not a member of the Fi...
Latest release 0.2.1 - Published - 2.35K stars
@firebase/functions
This is the Firebase Functions component of the Firebase JS SDK.
Latest release 0.4.10 - Updated - 2.35K stars
rxfire
Firebase JavaScript library RxJS
Latest release 3.8.5 - Updated - 2.35K stars
@firebase/functions-types
@firebase/functions Types
Latest release 0.3.6 - Updated - 2.35K stars
@firebase/app-types
@firebase/app Types
Latest release 0.3.2 - Updated - 2.35K stars
@firebase/logger
A logger package for use in the Firebase JS SDK
Latest release 0.1.8 - Updated - 2.35K stars
@firebase/storage-types
@firebase/storage Types
Latest release 0.3.1 - Updated - 2.35K stars

Recent Tags See all

rxfire@3.8.5 October 10, 2019
@firebase/webchannel-wrapper@0.2.27 October 10, 2019
@firebase/util@0.2.29 October 10, 2019
@firebase/testing@0.14.0 October 10, 2019
@firebase/storage-types@0.3.4 October 10, 2019
@firebase/storage@0.3.14 October 10, 2019
@firebase/remote-config-types@0.1.1 October 10, 2019
@firebase/remote-config@0.1.1 October 10, 2019
@firebase/polyfill@0.3.24 October 10, 2019
@firebase/performance-types@0.0.4 October 10, 2019
@firebase/performance@0.2.20 October 10, 2019
@firebase/messaging-types@0.3.3 October 10, 2019
@firebase/messaging@0.5.1 October 10, 2019
@firebase/logger@0.1.26 October 10, 2019
@firebase/installations-types@0.2.0 October 10, 2019

Interesting Forks See all

branko-vukmirovic/firebase-js-sdk
Firebase Javascript SDK
TypeScript - Apache-2.0 - Updated - 1 stars - 1 forks
ensysonintel/firebase-js-sdk
Firebase Javascript SDK
TypeScript - Apache-2.0 - Updated - 1 stars
davideast/firebase-js-sdk
Firebase Javascript SDK
TypeScript - Updated - 1 stars
jsayol/firebase-js-sdk
Firebase Javascript SDK
JavaScript - Last pushed - 1 stars
liuchangxian/firebase-js-sdk
Firebase Javascript SDK
JavaScript - Updated - 1 stars - 1 forks

Something wrong with this page? Make a suggestion

Last synced: 2019-05-09 23:52:07 UTC

Login to resync this repository