| github-token | Repository-scoped token used to read stars and publish artifacts | yes | — |
| stargazers-token | Optional admin or collaborator user token used only to bootstrap historical timestamps | no | — |
| output-branch | Branch that stores the generated history and SVG files | no | star-history |
| output-path | Repository-relative directory inside the output branch | no | . |
| chart-style | Color theme (classic, minimal, gradient, midnight, sunset, ocean, forest, flame, mono) | no | classic |
| chart-variant | Chart shape override (area, line, or glow); defaults to the theme's own variant | no | "" |
| chart-title | Custom heading for the star chart (defaults to "Star History") | no | "" |
| smooth | Draw a smooth monotone curve instead of straight segments | no | true |
| background-color | Override the light-mode surface color (hex, e.g. | no | "" |
| background-color-dark | Override the dark-mode surface color (hex, e.g. | no | "" |
| accent-color | Override the light-mode line/accent color (hex) | no | "" |
| accent-color-dark | Override the dark-mode line/accent color (hex) | no | "" |
| animate | Add a reduced-motion-aware SVG entrance animation | no | true |
| contributors | Generate light and dark contributor wall SVG files | no | false |
| contributors-limit | Maximum number of non-bot contributors to include (1-200) | no | 150 |
| contributors-title | Custom heading for the contributor wall (defaults to "Contributors") | no | "" |
| contributors-columns | Number of avatars per row in the contributor wall (4-32) | no | 16 |
| avatar-size | Avatar edge length in pixels for the contributor wall (24-128) | no | 48 |
| avatar-gap | Spacing in pixels between contributor avatars (0-48) | no | 8 |
| avatar-shape | Avatar shape in the contributor wall (circle, squircle, or square) | no | circle |
| padding | Outer padding in pixels around the contributor wall (8-96) | no | 32 |
| bootstrap | Fetch historical timestamps with stargazers-token when no history exists | no | false |
| commit-message | Commit message used when generated artifacts change | no | chore: update star history |