Skip to content

mmalerba/angularfire

This branch is 10 commits ahead of, 17 commits behind angular/angularfire:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

dcf70a3 · Jul 10, 2024
May 22, 2024
May 15, 2024
Jul 10, 2024
May 14, 2024
May 22, 2024
Oct 25, 2023
May 14, 2024
Aug 11, 2016
Jan 30, 2020
Sep 9, 2021
Oct 25, 2023
Aug 19, 2021
Jan 30, 2020
Oct 25, 2023
Jun 2, 2020
Jan 11, 2016
Jan 23, 2018
May 15, 2024
Sep 9, 2021
Dec 7, 2023
Aug 29, 2023
Aug 28, 2023
Aug 28, 2023
May 23, 2024
May 23, 2024
Aug 28, 2023
Aug 28, 2023
Oct 25, 2023
Aug 28, 2023
Oct 25, 2023
Jan 30, 2020

Repository files navigation

AngularFire

AngularFire smooths over the rough edges an Angular developer might encounter when implementing the framework-agnostic Firebase JS SDK & aims to provide a more natural developer experience by conforming to Angular conventions.

ng add @angular/fire

  • Dependency injection - Provide and Inject Firebase services in your components.
  • Zone.js wrappers - Stable zones allow proper functionality of service workers, forms, SSR, and pre-rendering.
  • Observable based - Utilize RxJS rather than callbacks for real-time streams.
  • NgRx friendly API - Integrate with NgRx using AngularFire's action based APIs.
  • Lazy-loading - AngularFire dynamically imports much of Firebase, reducing the time to load your app.
  • Deploy schematics - Get your Angular application deployed on Firebase Hosting with a single command.
  • Google Analytics - Zero-effort Angular Router awareness in Google Analytics.
  • Router Guards - Guard your Angular routes with built-in Firebase Authentication checks.

Example use

import { provideFirebaseApp, initializeApp } from '@angular/fire/app';
import { getFirestore, provideFirestore } from '@angular/fire/firestore';

export const appConfig: ApplicationConfig = {
  providers: [
    provideFirebaseApp(() => initializeApp({ ... })),
    provideFirestore(() => getFirestore()),
    ...
  ],
  ...
})
import { inject } from '@angular/core';
import { Firestore, collectionData, collection } from '@angular/fire/firestore';
import { Observable } from 'rxjs';

interface Item {
  name: string,
  ...
};

@Component({
  selector: 'app-root',
  standalone: true,
  template: `
  <ul>
    @for (item of (item$ | async); track item) {
      <li>
        {{ item.name }}
      </li>
    }
  </ul>
  `
})
export class AppComponent {
  item$: Observable<Item[]>;
  firestore: Firestore = inject(Firestore);

  constructor() {
    const itemCollection = collection(this.firestore, 'items');
    this.item$ = collectionData<Item>(itemCollection);
  }
}

Polyfills

Neither AngularFire nor Firebase ship with polyfills. To have compatibility across a wide-range of environments, we suggest the following polyfills be added to your application:

API Environments Suggested Polyfill License
Various ES5+ features Safari < 10 core-js/stable MIT
globalThis Chrome < 71
Safari < 12.1
iOS < 12.2
Node < 12
globalThis MIT
Proxy Safari < 10 proxy-polyfill Apache 2.0
fetch Safari < 10.1
iOS < 10.3
cross-fetch MIT

Resources

Quickstart - Get your first application up and running by following our quickstart guide.

Contributing

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

Upgrading to v7.0? Check out our guide.

Sample apps

We have three sample apps in this repository:

  1. samples/compat a kitchen sink application that demonstrates use of the "compatibility" API
  2. samples/modular a kitchen sink application that demonstrates the new tree-shakable API
  3. samples/advanced the same app as samples/modular but demonstrates more advanced concepts such as Angular Universal state-transfer, dynamically importing Firebase feature modules, and Firestore data bundling.

Having troubles?

Get help on our Q&A board, the official Firebase Mailing List, the Firebase Community Slack (#angularfire2), the Angular Community Discord (#firebase), Gitter, the Firebase subreddit, or Stack Overflow.

NOTE: While relatively stable, AngularFire is a developer preview and is subject to change before general availability. Questions on the mailing list and issues filed here are answered on a best-effort basis by maintainers and other community members. If you are able to reproduce a problem with Firebase outside of AngularFire's implementation, please file an issue on the Firebase JS SDK or reach out to the personalized Firebase support channel.

Developer Guide

This developer guide assumes you're using the new tree-shakable AngularFire API, if you're looking for the compatibility API you can find the documentation here.

See the v7 upgrade guide for more information on this change..

Firebase product integrations

import { } from '@angular/fire/analytics';
import { } from '@angular/fire/auth';
import { } from '@angular/fire/firestore';
import { } from '@angular/fire/functions';
import { } from '@angular/fire/messaging';
import { } from '@angular/fire/storage';
import { } from '@angular/fire/performance';
import { } from '@angular/fire/database';
import { } from '@angular/fire/remote-config';
import { } from '@angular/fire/app-check';
import { } from '@angular/fire/vertexai-preview';

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 89.4%
  • JavaScript 7.0%
  • CSS 2.4%
  • Nunjucks 1.1%
  • Shell 0.1%