burnchart
v4.0.0-rc.1
Published
GitHub Burndown Chart as a Service. Answers the question "are my projects on track"?
Downloads
23
Readme
burnchart
GitHub Burndown Chart as a Service. Answers the question "are my projects on track"?
Features
- Running from the browser, apart from GitHub account sign in which uses Firebase backend.
- Private repos; sign in with your GitHub account.
- Off days; specify which days of the week to leave out from ideal burndown progression line.
- Trend line; to see if you can make it to the deadline at this pace.
- Different point counting strategies; select from 1 issues = 1 point or read size from issue label.
Quickstart
$ yarn install
$ ./cli.js --port 1234
# burnchart/4.0.0 started on port 1234
FAQ
Browser 404 Errors
If you are running a dev mode on localhost (yarn start
) and start the app by navigating to a URL that contains a .
character - Vite
serves a 404. To fix this either navigate to the page through homepage or start the app through the cli - yarn start:preview
.
GitHub Bugs
Some milestones show "incorrect" issues associated. Consider the two following views of a milestones:
- https://github.com/nhn/tui.calendar/milestone/6 - 21 closed issues
- https://github.com/nhn/tui.calendar/issues?q=is%3Aissue+milestone%3Av1.12.13+is%3Aclosed - 11 closed issues (what we show)
Configuration
At the moment, there is no UI exposed to change the app settings. You have to either edit the src/config.js
file or use URL query string parameters to override these on a per-user basis.
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+)$/
Firebase
Signup for Firebase and go to your console and create a new project there.
You can leave the Database/Storage section as is, you only want to configure your "Authentication". There, enable "GitHub" and add your domain in "Authorised domains". Mine is set to radekstepan.com
and type: Custom
. If you want to run the app locally, you may want to add localhost
and/or 0.0.0.0
as well.
Since you are using your own Firebase project, you want to copy a couple of keys/ids into the firebase.*
section of src/config.js
.
firebase.apiKey
is "Web API key" from the "Settings" page (in "Project Overview")firebase.authDomain
is one of the authorised domains in "Authentication", then "Sign-in method"