ember-cli-bootstrap3-sass

ember-cli-bootstrap3-sass

This addon installs the bootstrap3 javascript components and fonts. Once installed, you can compile the bootstrap sass into your app. Understand that this addon is for Ember applications that are compiling their styles using SASS. If your Ember application is using pure CSS or LESS, than this addon is NOT for you.

This addon will make sure that the latest version of the ember-cli-sass Ember Addon is installed. In addition, the latest version of the bootstrap-sass library from bower will be installed in order to acquire the javascript, fonts, and SASS source.

Installation

Installation is basically two simple steps: one install the addon, and two import the SASS source into your app.scss file.

The following will install this addon along with the bootstrap-sass source and fonts:

$ ember install ember-cli-bootstrap3-sass

Next, inside your app/styles/app.scss file you must compile the bootstrap source into your application's stylesheet:

// `app/styles/app.scss`
...
@import "ember-cli-bootstrap3-sass";
...

Troubleshooting And Tips

• You need ember-cli-sass to be configured in your application. This means that by default your styles have been compiled inside your app/styles/app.scss file. If you've adjusted the configuration to use a different file, then you must add the @import "ember-cli-bootstrap3-sass" directive there.
• As bootstrap-3 version updates are made available, simply reinstall your bower packages and in some cases update your bower.json to ensure the version you want is being brought into your application. Understand that this addon does not entertain installing bootstrap-4 at this time.

Ember Addon Building And Testing

Installation

• git clone this repository
• npm install
• bower install

Running

• ember server
• Visit your app at http://localhost:4200.

Running Tests

• npm test (Runs ember try:testall to test your addon against multiple Ember versions)
• ember test
• ember test --server

Building

• ember build

For more information on using ember-cli, visit http://ember-cli.com/.

Linking This Addon For Local Testing

Linking

• From the command line at the root of this project run the npm link command to link this addon within your local node repository.
• From the other Ember project that you wish to test this addon in, execute the following command: npm link ember-cli-bootstrap3-sass.
• Now in that same other Ember project, you should go into the package.json and add the ember addon with the version *. It will look something like this: "ember-cli-bootstrap3-sass": "*". Now when/if you execute npm install on this other project it will know to look for the linked addon rather than fetch it from the central repository.

Unlinking

• Remove the addon from your local node repository with the following command (that can be run anywhere): npm uninstall -g ember-cli-bootstrap3-sass
• Remove the reference to the ember-cli-bootstrap3-sass in your other project's package.json.
• Run an npm prune from the root of your other project's command line.