trello-burndown
An easy to use SCRUM burndown chart for Trello boards.
Getting started
Get quickly up and runnning with the docker image or binary.
Or compile the binary or docker image from source.
How it works
- The points must be present in the title between parenthesis like so:
(2) Add login page
- The last column of the board is where finished cards are found.
- Weekends are ignored. Points that were completed in the weekend are appointed to the next monday.
Screenshots
Viewing a burndown chart
Adding a trello board
Index page with table of trello boards
Installation
Obtain trello tokens
- Login to trello
- Generate a Developer API key
- Generate a token by visiting the following URL:
https://trello.com/1/authorize?name=trello-burndown&expiration=never&response_type=token&key=DEVELOPER_API_KEY
. Replace "DEVELOPER_API_KEY" with the key you generated in the previous step. - Write both the Developer API key and the generated token down, you will need these to configure the application.
Docker: Setup & Running
-
Create a new directory to store the configuration and SQLite3 database.
λ mkdir trello-burndown && cd trello-burndown
-
Create a file named
config.yaml
in the same directory, copy the contents from the default here. -
Edit the configuration file with your favorite editor and set the developer api key and generated token you wrote down earlier.
-
Run it! (Check docker hub for available versions)
λ docker run -d -p 8080:8080 --volume $(pwd):/root:Z swordbeta/trello-burndown:latest
Note 1: The config file must be present in the /root directory inside the docker container.
Note 2:
:Z
is required on systems with SELinux set to enforcing.
Binary: Setup & Running
-
Download the latest release from here.
-
Create a file named
config.yaml
in the same directory, copy the contents from the default here. -
Edit the configuration file with your favorite editor and set the developer api key and generated token you wrote down earlier.
-
Run it! You could run this as a daemon with upstart/supervisord/systemd/etc.
λ ./trello-burndown
Compile from source
First clone the repository:
λ git clone https://github.com/mtricht/trello-burndown.git
λ cd trello-burndown
To build the docker image:
λ make docker
Or a binary targeting linux/amd64:
λ make build