GitHub contributions visualized as animated fireworks. More commits = bigger fireworks display!
| Kata (型) | Matsuri (祭) |
|---|---|
- Animated SVG fireworks based on daily GitHub contributions
- 6 levels of firework displays (0-5)
- Dual theme system: kata (型) and matsuri (祭) - daily rotation
- Customizable dimensions
- No JavaScript required - pure SVG animations
- Works in GitHub READMEs
The fireworks display features two rotating themes inspired by Japanese firework traditions:
| Level | Name | Description |
|---|---|---|
| 1 | 和火 (Wabi) | Traditional red-orange emotional firework |
| 2 | 牡丹 (Botan/Peony) | Quick-blooming circular burst |
| 3 | 蜂 (Hachi/Bee) | Rotating spinning particles |
| 4 | 冠菊 (Kankiku) | Gold trails with gravity (Weeping Willow) |
| 5 | 錦冠千輪 (Nishiki-Kamuro-Senrin) | Gold/silver + multiple small bursts |
| Level | Name | Description |
|---|---|---|
| 1 | 線香花火 (Senko Hanabi) | Sparkler, gentle fading |
| 2 | 隅田川 (Sumida River) | Heart and star shaped fireworks |
| 3 | 土浦 (Tsuchiura) | Starmine rapid-fire competition |
| 4 | 諏訪湖 (Suwa Lake) | Water reflection fireworks |
| 5 | 長岡 (Nagaoka) | Phoenix grand finale |
A bonus "Niagara" waterfall effect inspired by the Echigo Kamogawa Summer Festival. Triggered when:
- Commits > 50, or
- Commits ≥ 30 on lucky days (every 10th day of year)
This tool uses the same data as GitHub's contribution graph.
- Default: Only public repository contributions are counted
- Include private contributions: Enable in GitHub Settings → Profile → "Include private contributions on my profile"
When enabled, only the commit count is retrieved - repository names and commit details remain private.
Returns SVG fireworks based on user's today's GitHub contributions.
| Parameter | Required | Default | Description |
|---|---|---|---|
user |
Yes | - | GitHub username |
width |
No | 400 | SVG width (200-800) |
height |
No | 200 | SVG height (100-400) |
theme |
No | auto | Theme: kata, matsuri, or omit for daily rotation |
Demo endpoint for testing (no GitHub API required).
| Parameter | Required | Default | Description |
|---|---|---|---|
commits |
No | 0 | Simulated commit count |
level |
No | - | Override level (0-5), ignores commits |
width |
No | 400 | SVG width (200-800) |
height |
No | 200 | SVG height (100-400) |
theme |
No | auto | Theme: kata, matsuri, or omit for daily rotation |
extra |
No | false | Enable Niagara effect (true or 1) |
# Install dependencies
npm install
# Create .dev.vars with your GitHub token
echo "GITHUB_TOKEN=ghp_your_token_here" > .dev.vars
# Start development server
npm run dev
# Run tests
npm test
# Deploy to Cloudflare Workers
npm run deploy- Hono - Web framework
- Cloudflare Workers - Edge runtime
- Vitest - Testing
MIT