API Reference


The official library for Firebase and Angular

5.2.1  •  Updated 9 months ago  •  by angular  •  MIT License


The official library for Firebase and Angular

Build Status Join the chat at https://gitter.im/angular/angularfire2

What is AngularFire?

  • Observable based - Use the power of RxJS, Angular, and Firebase.
  • Realtime bindings - Synchronize data in realtime.
  • Authentication - Log users in with a variety of providers and monitor authentication state.
  • Offline Data - Store data offline automatically with AngularFirestore.
  • Server-side Render - Generate static HTML to boost perceived performance or create static sites.
  • ngrx friendly - Integrate with ngrx using AngularFire’s action based APIs.
  • Manage binary data - Upload, download, and delete binary files like images, videos, and other blobs.
  • Call server code - Directly call serverless Cloud Functions with user context automatically passed.
  • Push notifications - Register and listen for push notifications
  • Modular - Include only what’s needed. No AngularFire package is above 3kb with most under 2kb (gzipped).

Quick links


Stackblitz Template - Remember to set your Firebase configuration in app/app.module.ts.

Upgrading to v5.0? Check out our guide.

Having troubles? Get help on the Firebase Mailing List (officially supported), the Firebase Community Slack (look for the #angularfire2 room), Gitter, or Stack Overflow.


npm install firebase @angular/fire --save

Example use:

import { Component } from '@angular/core';
import { AngularFirestore } from '@angular/fire/firestore';
import { Observable } from 'rxjs';

  selector: 'app-root',
  template: `
    <li *ngFor="let item of items | async">
      {{ item.name }}
export class MyApp {
  items: Observable<any[]>;
  constructor(db: AngularFirestore) {
    this.items = db.collection('items').valueChanges();

Developer Guide

Getting started

Interacting with your database(s)

Firebase offers two cloud-based, client-accessible database solutions that support realtime data syncing. Learn about the differences between them in the Firebase Documentation.

Cloud Firestore

AngularFirestore allows you to work with Cloud Firestore, the new flagship database for mobile app development. It improves on the successes of Realtime Database with a new, more intuitive data model. Cloud Firestore also features richer, faster queries and scales better than Realtime Database.

Realtime Database

AngularFireDatabase allows you to work with the Realtime Database, Firebase’s original database. It’s an efficient, low-latency solution for mobile apps that require synced states across clients in realtime.

Authenticate users

Upload files

Send push notifications

Monitor your application performance in production

Directly call Cloud Functions

Deploying your application

Firebase Hosting is production-grade web content hosting for developers. With Hosting, you can quickly and easily deploy web apps and static content to a global content delivery network (CDN) with a single command.

Server-side rendering

Angular Universal is a technology that allows you to run your Angular application on a server. This allows you to generate your HTML in a process called server-side rendering (SSR). Angularfire is compatible with server-side rendering; allowing you to take advantage of the Search Engine Optimization, link previews, the performance gains granted by the technology, and more. Learn more about Angular Universal.



Weekly Downloads



Last ver 9 months ago
Created 1 year ago
Last commit 4 months ago
2 days between commits


Node version: 10.16.0
1320.4K unpacked


MIT License
OSI Approved
0 vulnerabilities


158 contributors
David East
Maintainer, 188 commits, 218 merges, 68 PRs
Works at Firebase / Google
James Daniels
Maintainer, 146 commits, 134 merges, 94 PRs
Works at Google
Jeff Cross
130 commits, 38 merges, 40 PRs
Works at Google
Maintainer, 8 commits, 14 merges, 7 PRs
Nicholas Jamieson
19 commits, 14 PRs
Works at rexlabsio
15 commits, 17 PRs


Ready for the next level?
Join Openbase's founding team to help us build the ultimate open-source app store, work with the latest technologies, and enjoy great culture, impact and autonomy
Openbase helps developers choose among and use millions of open-source packages, so they can build amazing products faster.
© 2020 Devstore, Inc.