| card-type | Type of card to generate (user-stats, top-langs, or contrib). "stats" is accepted as an alias for "user-stats". | yes | user-stats |
| username | GitHub username | yes | — |
| token | GitHub Personal Access Token | yes | — |
| output | Output SVG file path | yes | — |
| theme | Theme name (default, dark, vue-dark, etc.) | no | default |
| show-icons | Show icons next to stats (user-stats card only) | no | false |
| hide-border | Hide card border | no | false |
| hide-title | Hide card title | no | false |
| hide-rank | Hide rank circle (user-stats card only) | no | false |
| include-all-commits | Include all commits, not just current year (user-stats card only) | no | false |
| hide | Comma-separated stats/languages to hide | no | "" |
| show | Comma-separated optional stats to add - user-stats only (repos, reviews, prs_merged, prs_merged_percentage, discussions_started, discussions_answered) | no | "" |
| custom-title | Custom card title | no | "" |
| layout | Layout style (normal, compact, donut, donut-vertical, pie) - top-langs only | no | normal |
| langs-count | Number of languages to show (top-langs only) | no | 5 |
| limit | Number of repositories to show (contrib only) | no | 10 |
| hide-progress | Hide progress bars (top-langs only) | no | false |
| weighting | Weighting preset (size-only, balanced, expertise, diversity) - top-langs only | no | "" |
| exclude-repo | Comma-separated repos to exclude (top-langs only) | no | "" |
| contrib-types | Comma-separated list of contribution types to fetch (commits,prs,issues,reviews) - contrib only | no | commits,prs |
| title-color | Custom title color (hex without #) | no | "" |
| text-color | Custom text color (hex without #) | no | "" |
| bg-color | Custom background color or gradient | no | "" |
| border-color | Custom border color (hex without #) | no | "" |
| card-width | Card width in pixels | no | "" |
| border-radius | Border radius | no | 4.5 |
| disable-animations | Disable CSS animations | no | false |