TrackerTracker

Multi-project Scrum UI for Pivotal Tracker.

Features

Simultaneously view and manage stories across multiple projects
Scrum-like UI displays one column per story state, including "In QA" and "Passed QA"
Search across all projects simultaneously
Quickly drill down using any combination of projects, labels, users, and searches
All labels for all projects are visible and have epic-like mini progress charts
Columns can be rearranged
Labels, searches, column order, selected projects all survive browser restart
Enter your Pivotal API token and user name and off you go
Most actions are supported: update story descriptions, add notes, drag them to different columns to update their status and priority
Write your own custom columns and filters in a couple lines of JS
Assign QAs and pairs to stories
TeamCity integration: view build status in story detail view
Forecasting charts

Wallboard mode, to mimic a wall of post-it notes
Workspaces let you quickly switch between sets of projects, filters, and columns. Use numbers 1-9 to switch between workspaces 1-9 in one keypress.
Special labels that change story appearance (blocked, orange, yellow, green, blue)

Who Is This For?

Companies like a particular technology startup that use Pivotal Tracker and have multiple small projects going at once, but no good way to visualize and track progress across them all.

Project Status

This is beta software, use at your own risk. If you have any issues or feature requests, we would love to know, please open an issue. Contributions and pull requests are also very welcome.

Demo

A demo install is up and running at http://trackertracker.glomerate.com. API tokens are not logged by the server. The only thing exposed in the server logs are project IDs, which are useless without proper access to them.

Server Installation

Two Minute Heroku Install

Assuming you have a verified Heroku account and Heroku toolbelt installed:

git clone git@github.com:intentmedia/TrackerTracker.git
cd TrackerTracker
heroku apps:create [optional app name]
heroku addons:add rediscloud
git push heroku [local branch:]master

Ubuntu Server Install (Tested on 12.04)

# Need this to get the most recent version of node/npm - maybe not needed on 12.10
add-apt-repository ppa:richarvey/nodejs
aptitude update
aptitude install build-essential git-core nodejs npm redis-server
npm -g install grunt-cli forever
git clone git@github.com:intentmedia/TrackerTracker.git
cd TrackerTracker
npm install
grunt
forever start --watch -l ~/forever.log -o ~/out.log -e ~/err.log app/app.js

OS X Developer Installation

Install Homebrew: http://mxcl.github.com/homebrew/
Install Redis and NodeJS: brew install redis node
Install NPM: curl https://npmjs.org/install.sh | sh
Install Grunt-CLI and Karma: npm -g install grunt-cli karma
Install TrackerTracker: git clone git@github.com:intentmedia/TrackerTracker.git
Install NPM packages: cd TrackerTracker && npm install

Running the app

In terminal window #1, start redis:

redis-server

In terminal window #2, in the TrackerTracker directory, run grunt once to bundle your static files, and then start the node server:

grunt
node app/app

Development Workflow

Open a terminal window and run:

grunt watch

Whenever a file is changed, the entire client-side application is linted, bundled, and tested. This shouldn't take more than a couple seconds.

Running the Jasmine test suite once

karma start

Single-run benchmarks (includes starting Karma, capturing the browser, running the tests, and killing processes):

PhantomJS 1.8.1: 12.3 seconds
Firefox 17: 4.1 seconds
Chrome 26: 3.4 seconds
Safari 6: 2.9 seconds

Browser Support

TrackerTracker has been tested and built for Chrome, Safari, and Firefox. It seems fine in IE 9, but broken in IE 10. (Progress!) All basic interactions work on iPad. Fluid's localStorage implementation doesn't survive a restart, so for now Fluid should be considered unsupported.

Contributors

Andrew Childs (@andrewchilds)
Adrian CB (@adriancb)
Kurt Schrader (@kurt)
John Whitfield (@jkwhitfield)
James Cartledge (jcartledge)
Tom Cabanski (tcabanski)

mence/TrackerTracker