Skip to content

canuckasaurus/emberfire

 
 

Repository files navigation

EmberFire (Firebase + Ember Data)

Build Status Version

EmberFire is the officially supported adapter for using Firebase with Ember Data.

The FirebaseAdapter provides all of the standard DS.Adapter methods and will automatically synchronize the store with Firebase. EmberFire is packaged as an addon with Ember CLI by default, and is also available to use without the CLI. See below for instructions on getting started, and check out the full EmberFire documentation on the Firebase website. EmberFire works with Ember Data beta.11 through beta.14.1 (and beta.15 but with deprecation warnings).

Join the Firebase + Ember Google Group to ask technical questions, share apps you've built, and chat with other developers in the community.

Installing EmberFire with the Ember CLI

To install EmberFire as an addon with your Ember CLI app, run the following command within your app's directory:

$ ember install:addon emberfire

This will add Firebase as a dependency in your bower.json file, create app/adapters/application.js and add configuration to config/environment.js. Now, update your firebase url in config/environment.js:

// config/environment.js
module.exports = function(environment) {
  var ENV = {
    modulePrefix: 'firebase-app',
    environment: environment,
    firebase: 'https://YOUR-FIREBASE-NAME.firebaseio.com/',
    baseURL: '/',
    ...

Your Firebase data will now be synced with the Ember Data store. For detailed EmberFire documentation, check out the quickstart or guide in the Firebase docs.

Using EmberFire Without Ember CLI

EmberFire also works without ember-cli. See the Firebase documentation for instructions on getting started.

Contributing to EmberFire

If you'd like to contribute to EmberFire, run the following commands to get your environment set up:

Installation

  • git clone this repository
  • npm install -g ember-cli bower
  • npm install
  • bower install

Using a local EmberFire workdir in another project

From your emberfire workdir

  • npm link
  • rm -rf node_modules
  • npm install --production (does not install dev dependencies, these can trip you up!)

From your app workdir

  • npm link emberfire

  • Update your package.json so that emberfire is in devDependencies and is set to version 0.0.0

    "devDependencies": {
      "emberfire": "0.0.0"
    

Running Tests

  • ember test
  • ember test --server
Running tests against a specific version of ember-data

Invoke ./config/select-dep-versions.js with environment var EMBER_DATA_VERSION=<version> where <version> is an ember-data version number (e.g. 1.0.0-beta.12) or beta or canary.

Example:

EMBER_DATA_VERSION=canary ./config/select-dep-versions.js && ember test

Running the FireBlog demo app

About

Official Ember Data adapter for Firebase

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 90.0%
  • CSS 5.6%
  • Handlebars 2.8%
  • HTML 1.6%