Ember Widgets by Addepar

A collection of small widgets, easy to drop into place as Ember Components.

Demo and Documentation

http://addepar.github.com/ember-widgets/

Getting started

JS Bin Starter Kit

http://emberjs.jsbin.com/hebexa/1/edit

Installation

With bower: bower install ember-widgets --save

Or, just include dist/js/ember-widgets.js and dist/css/ember-widgets.css in your app.

Once it's installed, you can customize the look of ember-widgets with CSS.

Developing or Testing

$ npm install -g grunt-cli
$ npm install
$ grunt

To view examples, start the node server. From the root directory:

$ node examples.js.

You can view the examples at http://localhost:8000/gh_pages.

For developing, install pre-commit hooks to run tests in PhantomJS:

./bin/create-hook-symlinks

Dependencies

ember
jquery
bootstrap v3
lodash
ember list-view

Contributing

Got something to add? Great! Bug reports, feature ideas, and (especially) pull requests are extremely helpful, and this project wouldn't be where it is today without lots of help from the community.

Please read the contribution guidelines for directions on opening issues and working on the project.

Versioning

Ember Widgets uses Semantic Versioning to keep track of releases using the following format:

<major>.<minor>.<patch>

In a nutshell, this means:

Breaking changes to the API or behavior increases the major version
Adding functionality in a backwards-compatible way increases the minor version
Making backwards-compatible bug fixes increases the patch version

Maintainers

Update version numbers and release using https://github.com/webpro/grunt-release-it:

$ vim CHANGELOG.md
$ grunt release-it:<options>

By default, this will release a new patch version. Other suggested commands:

$ grunt release-it:minor
$ grunt release-it:major
$ grunt release-it:X.Y.Z

Ember Widgets uses the "distribution repository" feature of release-it to push to the gh-pages branch and update documentation. When prompted, do NOT update the tag for the distribution repository. We'll streamline the release process a bit more soon.

Copyright and License

Licensed under the BSD License (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file.

brian-d / ember-widgets