Drag-based JavaScript component, embracing endless UI solutions
Specs & (sweet) demos: http://skidding.github.io/dragdealer
The basic way to install Dragdealer is to include the minified script into your web page.
It can also be installed through npm, using something like browserify.
var Dragdealer = require('dragdealer').Dragdealer;Dragdealer has CI set up through Travis CI and Sauce Labs (who both offer their outstanding services for free to open-source projects.) Any pull-request will be tested automatically after each commit.
You can also run the tests by hand, of course.
Just load index.html in a browser of choice and pull the top slider to the right or access URL with the /#runner hashtag directly. Example: http://skidding.github.io/dragdealer/#runner
You can start a web server using the ./node_modules/.bin/grunt dev task, which will make the project available at localhost:9999
Run the ./node_modules/.bin/grunt test grunt task to run the tests from the terminal.
If you have SauceLabs credentials (SAUCE_USERNAME and SAUCE_ACCESS_KEY), tests will run there, otherwise the task will fall back to PhantomJS.
You can also force grunt to run the tests one way or the other using the test-phantomjs and test-saucelabs tasks.
node_modules/.bin/uglifyjs src/dragdealer.js -o src/dragdealer.min.js
Make sure you ran npm install in the project directory first. Also, you can use global paths if you have the npm modules installed globally (-g), but you shouldn't need to.
There's no contributing guide so far, but you're more than welcome to start a discussion.