yashksaini-coder/GitBanner Profile Card
Generate a personalized GitHub stats banner: commits, stars, languages, persona, top projects (SVG + PNG).
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| github-token | A GitHub personal access token used to query the GraphQL/REST APIs. Required scopes: read:user (and repo if include-private is true). Defaults to github.token in workflows, but a PAT is recommended for full data. | yes | — |
| username | GitHub login to render. Defaults to the repository owner. | no | "" |
| theme | Theme name. Currently supported: dark. | no | dark |
| format | Output format — svg, png, or both. | no | both |
| output-path | Output path without extension. Files are written as <output-path>.svg and <output-path>.png. | no | gitbanner |
| include-private | Include private repository stats (requires repo scope on the token). | no | false |
| exclude | Comma-separated list of repository names to exclude from per-repo calculations (top lists, languages, project highlights). The user's profile README repo (a repo named exactly after the user) is always excluded automatically. | no | "" |
| commit | When true, commit and push the regenerated card if it changed. | no | true |
| commit-message | Commit message used when committing the regenerated card. | no | chore: refresh GitBanner stats |
Outputs
| name | description |
|---|---|
| card-path | Filesystem path of the primary generated card (SVG by default, PNG if format=png). |