jQuery TourBus

A tour/walkthrough plugin for developers. It includes limited automatic behavior, more like a 'toolkit' than some of the others out there.

Installation

CoffeeScript and LESS source files are available in src while compiled/pre-processed/minified files are in dist. Wire up your asset packager appropriately or include the css and js by hand old-school:

<script src='path/to/jquery.min.js'></script>
<script src='path/to/jquery-tourbus.min.js'></script>
<link href='path/to/jquery-tourbus.min.css' media='all' rel='stylesheet' type='text/css' />

jQuery is the only dependency. I think technically it will be able to support Zepto without too much difficulty.

Documentation

Docs coming to this readme at some point, but for now you'll find all the details and a demo on the website.

Contributing

This project uses grunt plus an npm package.json for development (the plugin itself is not on npm). That means you can hack on it by forking the repo and:

$ npm install -g grunt-cli
$ git clone git@github.com:<you>/jquery-tourbus.git
$ cd jquery-tourbus
$ npm install
$ grunt build
$ open site/index.html # on OSX, opens the demo site in your browser

Other useful tasks:

# run headless tests
$ grunt test

# build test js/etc and open them in your browser
$ grunt build coffee:test
$ open test/runner/basic.html

# clean up minified source in site/ and compiled tests in test/
$ grunt clean

# watch for changes to sources and build
$ grunt watch:dev

# watch for changes to tests and build
$ grunt watch:test

# prepare compiled/minified sources for deploy
$ grunt dist

If you're working on a pull request, please remember to work on a local branch instead of master.

Contributors

• Ryan Funduk
• Gary Taylor
• Joshua Jabbour