burnchart/-old-
Radek Stepan 4cf6af6978 move styles 2016-01-12 15:14:19 +01:00
..
bin skeleton with latest React 2016-01-12 14:55:48 +01:00
docs skeleton with latest React 2016-01-12 14:55:48 +01:00
public skeleton with latest React 2016-01-12 14:55:48 +01:00
src move styles 2016-01-12 15:14:19 +01:00
test skeleton with latest React 2016-01-12 14:55:48 +01:00
Gruntfile.coffee skeleton with latest React 2016-01-12 14:55:48 +01:00
LICENSE skeleton with latest React 2016-01-12 14:55:48 +01:00
README.md skeleton with latest React 2016-01-12 14:55:48 +01:00
Rakefile skeleton with latest React 2016-01-12 14:55:48 +01:00
package.json skeleton with latest React 2016-01-12 14:55:48 +01:00

README.md

#burnchart

GitHub Burndown Chart as a Service. Answers the question "are my projects on track"?

Build Status Coverage Dependencies License

image

##Features

  1. Running from the browser, apart from GitHub account sign in which uses Firebase backend.
  2. Private repos; sign in with your GitHub account.
  3. Store projects in browser's localStorage.
  4. Off days; specify which days of the week to leave out from ideal burndown progression line.
  5. Trend line; to see if you can make it to the deadline at this pace.
  6. Different point counting strategies; select from 1 issues = 1 point or read size from issue label.

##Quick Start

$ npm install burnchart -g
$ burnchart 8080
# burnchart/2.0.8 started on port 8080

##Configuration

At the moment, there is no ui exposed to change the app settings. You have to edit the src/models/config.coffee file.

An array of days when we are not working where Monday = 1. The ideal progression line won't drop on these days.

"off_days": [ ]

Choose from ONE_SIZE which means each issue is worth 1 point or LABELS where issue labels determine its size.

"points": "ONE_SIZE"

If you specify LABELS above, this is the place to set a regex used to parse a label and extract points size from it. When multiple matching size labels exist, their sum is taken.

"size_label": /^size (\d+)$/

##Development

Rake is used as a tool to execute tasks, the steps would be roughly as follows:

apt-get install ruby-full
gem install rake
rake build
rake serve

You can run the following tasks:

rake build                  # Build everything & minify
rake build:css              # Build the styles with LESS
rake build:js               # Build the app with Browserify
rake build:minify           # Minify build for production
rake commit[message]        # Build app and make a commit with latest changes
rake install                # Install dependencies with NPM
rake publish                # Publish to GitHub Pages
rake serve                  # Start a web server on port 8080
rake test                   # Run tests with mocha
rake test:coverage          # Run code coverage, mocha with Blanket.js
rake test:coveralls[token]  # Run code coverage and publish to Coveralls
rake watch                  # Watch everything
rake watch:css              # Watch the styles
rake watch:js               # Watch the app

Please read the Architecture document when contributing code.