Skip to content
benjamin-blankePublic

About

Glyph is a modern, developer-focused platform for creating beautiful dynamic badges for GitHub READMEs, project documentation, and websites. Simple to customize, easy to integrate, and built to make every project stand out with clean, minimal, and consistent visuals.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

75 Commits

Folders and files

Repository files navigation

Glyph Badges

In Progress Dicsord Join Website

Quick start

[![Join the Discord](https://glyphbadges.dev/badge/Discord-Join-the-community-5865F2.svg?text=Join%20our%20community&bg=5865F2&labelBg=23272A&logo=discord&style=flat)](https://discord.gg/opushost)

Browse the complete collection in BADGES.md. Every entry shows the rendered badge followed by its customer URL parameters.

Dynamic status badges

![Status](https://glyphbadges.dev/badge/Status-Degraded-F59E0B.svg?text=Degraded&bg=F59E0B&labelBg=23272A&logo=status)

Supported states include OPERATIONAL, DEGRADED, DOWN, MAINTENANCE, INCIDENT, INVESTIGATING, MONITORING, RESOLVED, SCHEDULED, ONLINE, and OFFLINE. See STATUS.md for all formats.

Dynamic Discord badge

Fetch a Discord user's current avatar and username through Lanyard:

![Discord User](https://glyphbadges.dev/badge/discorduser?userId=123456789012345678)

The badge displays the avatar and username as @username.

Repository charts

Display live GitHub repository charts for any public repository:

![Star history](https://glyphbadges.dev/chart?owner=benjamin-blanke&repo=glyph&type=stars)
![Commit activity](https://glyphbadges.dev/chart?owner=benjamin-blanke&repo=glyph&type=commits)

Use type=stars, commits, contributors, languages, or releases. See docs/graphs/README.md for all examples and parameters.

Skill icons

Create a README-ready row of skill icons using short names:

![Skills](https://glyphbadges.dev/skills?js,ts,react,next,tailwind)

Use theme=light for light icon variants. See docs/SKILLS.md for the complete upstream icon catalog and supported names.

Project covers

Create a fixed-style project cover matching Glyph's dark dotted design:

![Project cover](https://glyphbadges.dev/cover?title=Acme%20Toolkit&description=A%20delightful%20component%20library)

The cover uses Bricolage Grotesque from Google Fonts, with the title rendered at weight 800 and the description at weight 400. The font family and visual style are fixed so covers stay consistent.

Livck Cloud beta

Glyph has a Beta integration for public Livck status pages:

![Livck Beta](https://glyphbadges.dev/badge/livck?url=https%3A%2F%2Fstatus.waveserv.com)

It checks Livck whenever the image is requested. Replace the encoded URL to use another public Livck status page.

URL format

https://glyphbadges.dev/badge/<label>-<message>-<color>.svg?text=<text>&bg=<background>&labelBg=<label-background>&logo=<icon>&style=<style>

Example:

https://glyphbadges.dev/badge/Build-Passing-16A34A.svg?text=Passing&bg=16A34A&labelBg=23272A&logo=check&style=rounded

?text= brings custom text, ?bg= changes the message background, ?label= changes the label, ?labelBg= changes the label background, ?logo= selects an inline logo, and ?style= selects flat, flat-square, or rounded. Aliases include message, color, background, labelColor, and labelBackground. See docs/URLS.md, docs/STYLES.md, and docs/ICONS.md.

If rendering fails, Glyph returns a native red warning badge with an inline warning icon instead of leaving Markdown with a broken-image placeholder.

Development

npm install
npm run typecheck

AI Declaration

Glyph is not an AI-generated project. The project is designed, developed, and maintained by Benjamin Blanke.

I sometimes use GitHub Copilot to help upload local changes, review code, or assist with development tasks. All changes are reviewed and controlled by me before being added to the repository.

Contributing

See docs/CONTRIBUTING.md for the icon, SVG, testing, and documentation conventions.

License

Glyph is available under the MIT License.

About

Glyph is a modern, developer-focused platform for creating beautiful dynamic badges for GitHub READMEs, project documentation, and websites. Simple to customize, easy to integrate, and built to make every project stand out with clean, minimal, and consistent visuals.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Contributors

Languages