Unpoly

Unobtrusive JavaScript framework for server-side applications

Unpoly enables fast and flexible frontends with minimal changes to your server-side code.

This repository is home to both the Unpoly JavaScript code and its (optional) bindings for Ruby on Rails (unpoly-rails gem).

Overview:

Install dependencies for tests:

To run Jasmine tests for Unpoly:

To run RSpec tests for the unpoly-rails gem:

We are currently feeding four release channels:

We always release to all channel simultaneously.

To prepare a new version:

Edit lib/unpoly/rails/version.rb and bump the version number. Use semantic versioning.
Add an entry to CHANGELOG.md
Commit and push the version bump and CHANGELOG.md

Now we can release a new version. This requires your to be logged into Rubygems and npm:

From the project root, type rake publish:build. This will output minified JS and CSS files to the dist folder. It also updates the package.json for npm.
Commit and push the generated files. There is a rake task rake publish:commit that helps with this.
From the project root, type rake publish:release. This will publish a new gem version to Rubygems.org.
It will also push a tag for this version, which Bower requires for its own versioning scheme. Finally it publishes to npm.

Always remember to build, commit and push build artifacts before calling rake publish:release so the Git tag points to the correct commit.

If you have done this process a few times and know what you're doing, you can call rake publish:all to run all these steps in sequence.

After you have published all release channels, remember to: