stefanpenner / ember-app-kit

deprecated: see https://github.com/stefanpenner/ember-cli
MIT License
1.02k stars 230 forks source link

Deprecated

this project has been deprecated in-favour of the ember-cli project:

Migrating to Ember CLI

First, run npm install -g ember-cli to install Ember CLI. Now, on top of your existing EAK project, run ember init. Ember CLI will then migrate your project, showing you a diff of its overrides, and letting you edit them, as it goes along.

Ember Init Overrides

Ember CLI Migrator

The Ember CLI Migrator can help you migrate your files to the standard ember-cli structure, while preserving your Git history. This tool can help you get 90% of the way there when working with EAK.

Importing Ember and Ember Data

You now have to explicitly import Ember and Ember Data. Add import Ember from "ember and import DS from "ember-data" anywhere you declared a route, controller, model, and so on.

Migrating your API Stub

To work with the API stub again, run ember generate server. This command generates a server directory for your mocks and proxies where you can then migrate your routes accordingly.

You may also want to look into Ember CLI Rest API Blueprint which generates DS.RESTAdapter compatible express routes for a given Model.

Custom Environments

Support for custom environments like staging is currently still in progress, see Ember CLI PR #1520

Using The Express Server

The Express server has been exposed and now lives under this directory. You can now customize it any way you want, from enhancing the static file server, to simply using it as an API stub. You may even develop it further and turn it into a full-stack solution.

Cleanup

You can remove the Gruntfile and tasks folder since we won't be needing them anymore.

For now, you can check the app blueprint to see what other files you no longer need.

Troubleshooting

Ember App Kit Build Status

Ember App Kit aims to be the foundation for ambitious web applications built with Ember. It's been replaced by an executable ember-cli which dramatically improves buildtimes (via broccoli) and provides sane-upgrade paths, feel free to check that project out. We intend to provide a sensible upgrade path.

This project has been extracted out of several real world applications and is actively used. Currently it covers the basics fairly well, but much still needs to be done. As we learn and as more contributors join in it continues to evolve. If you encounter any bugs, clunky features or missing documentation, just submit an issue and we'll respond ASAP.

At the very least, it helps setup your Ember.js applications directory structure.

We welcome ideas and experiments.

Getting Started

Features

Special Thanks

Some ideas in ember-app-kit originated in work by Yapp Labs (@yapplabs) with McGraw-Hill Education Labs (@mhelabs) on yapplabs/glazier. Thanks to Yapp and MHE for supporting the Ember ecosystem!

License

Copyright 2013 by Stefan Penner and Ember App Kit Contributors, and licensed under the MIT License. See included LICENSE file for details.