Build it, copy it, ship it
Tweak the options and watch your badge update live. Copy the snippet straight into your README.
Pick a look that fits
Every shields.io-compatible style, rendered live from the API.
Built to drop in and forget
Real-time count
Member numbers refresh automatically — your badge is always current, with smart caching for speed.
Fully customizable
Five styles, custom label, colors and an optional logo. Mix and match to match your project's brand.
Just a URL
No build step, no SDK. Add query parameters to a single endpoint and you're done.
Self-host ready
Open source under MIT. Deploy your own instance on Vercel with a bot token for private chats.
Groups & channels
Works identically for interactive groups and broadcast channels — same endpoint, same params.
Free & open
No registration, no rate-limit paywall. Available on npm and JSR with full TypeScript types.
One endpoint, six parameters
| Parameter | Description | Default |
|---|---|---|
channelId | Chat username (@name) or numeric ID for private chats | — |
style | flat · plastic · flat-square · for-the-badge · social | flat |
label | Left-side label text | Telegram |
color | Message background, hex without # | 2AABEE |
labelColor | Label background, hex without # | 555555 |
logo | Show the Telegram logo | true |
Buy the maintainer a coffee ☕
This tool is free and open source. If it saved you time, a tip keeps it running.
