ember-template

A template for starting projects with Ember as a client. Build pipeline and development server provided by ember-cli. Bootstrap and Sass included.

Dependencies

Install build dependencies with npm install. Install runtime dependencies with bower install.

• ember.js
• ember-cli
• Bootstrap

At the beginning of each cohort, update this template by upgrading ember-cli and generating a new Ember application in another location. Copy files over a handful at a time and check diffs. You should preserve the pods structure and other customizations, including Bootstrap.

Installation

1. Download this template.
2. Unzip and rename the template directory.
3. Empty README.md and fill with your own content.
4. Move into the new project and git init.
5. Replace all instances of 'ga-wdi-boston.ember-template' with your app name. This includes package.json, bower.json, app/index.html, tests/index.html, and config/environment.js, possibly others.
6. Install dependencies with npm install and bower install.
7. Run the development server with ember server. Use the --proxy flag to avoid writing development-specific CORS and CSP settings.

Structure

Build dependencies are stored in package.json. Client dependencies are stored in bower.json.

Do not configure grunt packages directly in the Gruntfile.js. Instead, store configurations in the grunt directory. You won't need a top-level key, since that's generated by the Gruntfile.js based on the filename of the configuration object stored in the grunt directory.

Developers should store source code following Ember conventions. This template uses the "pods" layout for organizing code. For an introduction, see Organize Your Ember App with Pods.

Tasks

Developers should run these often!

• grunt nag or just grunt: runs code quality analysis tools on your code and complains
• grunt reformat: reformats all your code in a standard style
• ember server: generates bundles, watches, and livereloads (use the --proxy flag when developing locally)
• ember test: runs any automated tests
• ember build: prepare a distribution for deployment (use the --environment flag if you've customized builds)
• ember generate: make use of the many generators for code (try ember help generate for more details)

Additional Resources

• ember inspector for chrome
• ember inspector for firefox

License

Source code distributed under the MIT license. Text and other assets copyright General Assembly, Inc., all rights reserved.