angular_fire 0.2.1

  • README.md
  • CHANGELOG.md
  • Installing
  • Versions
  • 69

angular_fire

An unofficial library for AngularDart and Firebase.

pub package Build Status

Install

The current stable release of angular_fire works best with the following:

dependencies:
  angular2: ^3.1.0
  angular_fire: ^0.1.0
  firebase: ^3.1.0

To get started, you need to, at minimum, include the Firebase SDK:

<body>
  <script src="https://www.gstatic.com/firebasejs/4.0.0/firebase.js"></script>
</body>

Usage

Services

FirebaseAuth

A high-level authentication service. First setup for dependency injection:

import 'package:angular2/angular2.dart';
import 'package:angular2/platform/browser.dart';
import 'package:angular_fire/angular_fire.dart';
import 'package:firebase/firebase.dart' as sdk;

main() {
  bootstrap(AngularFireExample, <dynamic>[
    provide(
      FirebaseAuth,
      useValue: new FirebaseAuth(
        sdk.initializeApp(
          apiKey: '...',
          authDomain: '...',
          databaseURL: '...',
          storageBucket: '...',
        ),
      ),
    ),
  ]);
}

Then inject into your app and use. See GoogleSignInComponent below for an example.

Components

GoogleSignInComponent

Displays a rendered sign in box for Google authentication that follows the branding guidelines.


import 'package:angular2/angular2.dart';
import 'package:angular_fire/angular_fire.dart';

@Component(
  selector: 'angular-fire-example',
  directives: const [
    GoogleSignInComponent,
  ],
  template: r'''
    <google-sign-in (trigger)="signIn()">
    </google-sign-in>
  ''',
)
class AngularFireExample {
  final FirebaseAuth _auth;
  
  void onTrigger() {
    _auth.signIn();
  }
}

NOTE: To use this component, you must have the brand assets in your web/assets directory, or use the [assetPath] property, or the googleSignInAssetPath token at bootstrap time to configure the location of your assets - for example on an external CDN.

IfFirebaseAuthDirective

Like ngIf, but shows content if the value matches the current authentication:

<div *ifFirebaseAuth="true; let currentUser = currentUser">
  Logged in as: {{currentUser.displayName}}.
  <button (click)="signOut()">Sign Out</button>
</div>

<div *ifFirebaseAuth="false">
  Waiting for sign in...

  <br>

  <google-sign-in
      (trigger)="signIn()">
  </google-sign-in>
</div>

Contributing

We welcome a diverse set of contributions, including, but not limited to:

For the stability of the API and existing users, consider opening an issue first before implementing a large new feature or breaking an API. For smaller changes (like documentation, bug fixes), just send a pull request.

Testing

Run the (simple) test suite in Dartium. It doesn't currently run on Travis:

$ pub run angular_test -p dartium

0.2.1

  • Add an option to add additional authorization scopes to googleSignIn:
// Authenticate and allow read-only access to Google Calendar.
final user = await firebaseAuth.googleSignIn(
  scopes: [
    'https://www.googleapis.com/auth/calendar.readonly',  
  ],
);

if (user != null) {
  // You have access!
}

0.2.0

  • Fixed a bug that flashed signed off content before loading.
  • Changed the default behavior of Google sign-in to prompt for account:
abstract class FirebaseAuth {
  Future<FirebaseUser> googleSignIn({bool prompt: true});
}

0.1.1

  • Removed a print statement that was always occurring.
  • Added a high-level FirebaseAuth class, and Google sign-in.
  • Added IfFirebaseAuthDirective.

0.1.0

  • Initial commit of GoogleSignInComppnent.

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  angular_fire: "^0.2.1"

2. Install it

You can install packages from the command line:

with pub:


$ pub get

Alternatively, your editor might support pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:angular_fire/angular_fire.dart';
        
Version Uploaded Documentation Archive
0.2.1 Jun 1, 2017 Go to the documentation of angular_fire 0.2.1 Download angular_fire 0.2.1 archive
0.2.0 Jun 1, 2017 Go to the documentation of angular_fire 0.2.0 Download angular_fire 0.2.0 archive
0.1.1 May 30, 2017 Go to the documentation of angular_fire 0.1.1 Download angular_fire 0.1.1 archive
0.1.0 May 30, 2017 Go to the documentation of angular_fire 0.1.0 Download angular_fire 0.1.0 archive

Analysis

This feature is new.
We welcome feedback.
More details: scoring.

We analyzed this package, and provided a score, details, and suggestions below.

  • completed on Feb 3, 2018
  • Dart: 2.0.0-dev.20.0
  • pana: 0.10.1

Scores

Popularity:
Describes how popular the package is relative to other packages. [more]
38 / 100
Health:
Code health derived from static analysis. [more]
99 / 100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
100 / 100
Overall score:
Weighted score of the above. [more]
69

Platforms

Detected platforms: web

Primary library: package:angular_fire/angular_fire.dart with components: html, js.

Suggestions

  • The description is too short.

    Add more detail about the package, what it does and what is its target use case. Try to write at least 60 characters.

  • Package is pre-v1 release.

    While there is nothing inherently wrong with versions of 0.*.*, it usually means that the author is still experimenting with the general direction API.

  • Maintain an example.

    Create a short demo in the example/ directory to show how to use this package. Common file name patterns include: main.dart, example.dart or you could also use angular_fire.dart.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=1.22.0 <2.0.0
angular2 ^3.0.0 3.1.0+1
firebase ^3.0.0 3.2.0 4.3.1
meta ^1.0.5 1.1.2
Transitive dependencies
analyzer 0.30.0+4 0.31.0+1
args 0.13.7 1.3.0
async 2.0.3
barback 0.15.2+14
browser 0.10.0+2
build 0.9.3 0.12.0+1
build_barback 0.2.2 0.5.0+3
charcode 1.1.1
cli_util 0.1.2+1
code_builder 1.0.4 3.0.1
code_transformers 0.5.1+4
collection 1.14.5
convert 2.0.1
crypto 2.0.2+1
csslib 0.13.7+1 0.14.1
dart_style 1.0.9+1
fixnum 0.10.6
front_end 0.1.0-alpha.4.1 0.1.0-alpha.8
func 1.0.0
glob 1.1.5
html 0.13.2+2
http 0.11.3+16
http_parser 3.1.1
intl 0.15.2
isolate 1.1.0
js 0.6.1
kernel 0.3.0-alpha.1.1 0.3.0-alpha.5
logging 0.11.3+1
matcher 0.12.1+4
package_config 1.0.3
path 1.5.1
plugin 0.2.0+2
pool 1.3.4
protobuf 0.5.5 0.7.0
quiver 0.25.0 0.28.0
source_gen 0.5.10+1 0.7.4+3
source_maps 0.10.4
source_span 1.4.0
stack_trace 1.9.1
string_scanner 1.0.2
typed_data 1.1.5
utf 0.9.0+4
watcher 0.9.7+7
yaml 2.1.13
Dev dependencies
angular_test 1.0.0-beta+1
dart_to_js_script_rewriter ^1.0.1
test ^0.12.20+8