@mozaik/ext-github
v2.0.0-alpha.10
Published
Mozaik github widgets
Downloads
22
Readme
Mozaïk GitHub widgets
This branch contains code for the version compatible with Mozaïk v2, if you're looking for v1, please use mozaik-1 branch.
This repository contains some GitHub widgets to use with Mozaïk.
Demo
You can see a live demo of the widgets here
Widgets
Github Client Configuration
In order to use the Mozaïk github widgets, you should configure its client. It's not required that you provide a token for authentication, but then you'll only be able to see public repos and the rate limit will apply.
parameters
key | env key | required | default | description
----------|------------------|----------|------------------------|----------------------------
token
| GITHUB_API_TOKEN | no | '' | github authentication token
baseUrl
| GITHUB_BASE_URL | no | https://api.github.com | github api url (useful for enterprise)
usage
# config.yml
api:
github:
baseUrl: ""
token: MY_GITHUB_TOKEN
Widgets doc
Badges
OrgBadge
Show github organization badge.
parameters
key | required | description
--------|----------|--------------------------
org
| yes | github organization identifier
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: OrgBadge
organization: github
columns: 1
rows: 1
x: 0
y: 0
RepoBadge
Show repository info.
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: RepoBadge
repository: plouc/mozaik
columns: 1
rows: 1
x: 0
y: 0
UserBadge
Show github user badge.
parameters
key | required | description
--------|----------|--------------------------
user
| yes | github user identifier
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: UserBadge
user: plouc
columns: 1
rows: 1
x: 0
y: 0
Stats
RepoCommitActivityHistogram
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: RepoCommitActivityHistogram
repository: plouc/mozaik
columns: 2
rows: 1
x: 0
y: 0
RepoCommitActivityLine
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: RepoCommitActivityLine
repository: plouc/mozaik
columns: 2
rows: 1
x: 0
y: 0
RepoContributorsStats
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: RepoContributorsStats
repository: plouc/mozaik
columns: 2
rows: 1
x: 0
y: 0
Traffic
RepoTrafficClonesHistogram
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: RepoTrafficClonesHistogram
repository: plouc/mozaik
columns: 2
rows: 1
x: 0
y: 0
RepoTrafficClonesLine
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: RepoTrafficClonesLine
repository: plouc/mozaik
columns: 2
rows: 1
x: 0
y: 0
RepoTrafficViewsHistogram
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: RepoTrafficViewsHistogram
repository: plouc/mozaik
columns: 2
rows: 1
x: 0
y: 0
RepoTrafficViewsLine
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: RepoTrafficViewsLine
repository: plouc/mozaik
columns: 2
rows: 1
x: 0
y: 0
Branches
Show github branches with authors.
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: Branches
repository: plouc/mozaik
columns: 1
rows: 1
x: 0
y: 0
PullRequests
Show github repository pull requests with authors.
parameters
key | required | description
-------------|----------|---------------
repository
| yes | github repository
title
| no | overrides default title if provided
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: PullRequests
repository: plouc/mozaik
columns: 1
rows: 1
x: 0
y: 0
Status
Shows the latest Github system status information from https://status.github.com/
usage
# config.yml
dashboards:
- # …
widgets:
- extension: github
widget: Status
columns: 1
rows: 1
x: 0
y: 0