@elao/github-agile-dashboard
v1.1.0
Published
Github Agile Dashboard
Downloads
18
Readme
📉 Github Agile Dashboard
Installation
npm install -g @elao/github-agile-dashboard
Configuration
GitHub authentication
As recommended by GitHub, Gad relies on github.user
and github.token
variables in your git config to authenticate you on GitHub API. Follow these three steps and you're good to go:
Set up your GitHub username in your git config:
git config --global github.user "Tom32i"
Generate a GitHub personal access token with the following access rights:
repo
anduser
.Set up your GitHub token in your git config:
git config --global github.token MyGitHubPersonalAccessToken
Usage
Configure your agile project on GitHub
- Create a milestone "Backlog" (or whatever name) with no due date : it will be your backlog.
- Create a milestone per Sprint with a due date.
- Create two labels "Ready to review" and "In Progress".
- Create issues in milestone "Backlog".
- Add an estimation
[x]
in the issue title, for example: "Add a user login [3]". - Create Pull Request in sprint milestone with tag "Ready to review" or "In Progress".
Commands
In your projet repository, just enter gad [command] (options)
.
| Command | Description | Options |
|---|---|---|
| sprint | Show the state of the current sprint | sprint -s=-1
Show the previous sprint |
| sprints | Show the state of all sprints | limit -l=2
limit the number of sprint to display |
| backlog | Show the state of the backlog | |
| review | Display PullRequest that are awaiting your review | |
| changelog | Generate a markdown changelog of the current sprint | all --all
include open issues in the changelog. sprint -s=-2
Show the changelog from two sprints ago |
| estimate | Show stories that are missing estimation | |
| sum | Calculate the sum of the stories matching the given filters | label --label=API
include issues with label "API" |
| status | Show the status of the repository | |
| help | Show list of commands | |
| exit | Quit the dashboard | |
Options
You can manually specify any of the options on the fly:
gad -o [organisation|owner] -r [repo] -u [username] -p [password|token]
E.g.: gad -o Elao -r symfony-standard -u Tom32i -p MyGitHubPersonalAccessToken
Cache
For performance purpose, Gad keeps a little cache file for each repository.
By default, it's located in ~/.gad/cache
but you can specify a different path with the cacheDir
option:
gad -c ./cache
Contributing
Installation
git clone [email protected]:Elao/github-agile-dashboard.git
cd github-agile-dashboard
npm install
Usage
node gad.js -o [organisation|owner] -r [repo] -u [username] -p [password|token]
Coding style
npm run lint
Publishing on NPM
npm publish --access public