Skip to content

Statics

RonDevHub edited this page Oct 21, 2025 · 3 revisions

Static Badges

Static badges are the simplest type of badges you can generate with this system.
They don't require any external API requests (like GitHub) and are fully customizable through URL parameters.


URL Pattern

static/{label}-{labelBgColor}-{labelTextColor}/{message}-{msgBgColor}-{msgTextColor}/{style}

  • {label} → Text on the left side (label).
  • {labelBgColor} → Background color for the label (hex without #).
  • {labelTextColor} → Text color for the label (hex without #).
  • {message} → Text on the right side (message).
  • {msgBgColor} → Background color for the message.
  • {msgTextColor} → Text color for the message.
  • {style} → Badge style (flat, flat-square, plastic, round, for-the-badge).

Examples

Basic Static Badge

static/Hello/World

Result:

Basic


With Custom Colors

static/Custom-ff6600-fff/Badge-333333-fff/flat-square

Result:

Custom


Fun Example with Emoji ❤️

static/I❤️-000000-fff/PHP-3a6e8f-fff/round

Result:

Emoji


Styles

You can choose between different badge styles, similar to Shields.io.

Style Example
flat flat
flat-square flat-square
plastic plastic
round round
for-the-badge for-the-badge
classic flat-square
social flat-square
minimalist flat-square
pill flat-square

URL Encoding and Special Characters

  • Use _ (underscore) to represent a space:
    static/Hello_World-555-fff/Badge-0B7DBE-fff/flat
    Hello World

  • Use __ (double underscore) to represent an underscore _.

  • Use -- (double dash) to represent a dash -.

  • Use * (asterisk) as a placeholder for the default value.

Example:
static/My__Repo-555-fff/Awesome--Project-0B7DBE-fff/flat

➡️ Becomes → My_Repo | Awesome-Project


Quick Summary

  • Lightweight: No external API needed.
  • Customizable: Colors, styles, text, even emojis.
  • Flexible: Encode special characters for clean results.
  • Fast: Uses simple file caching for speed.

Showcase

Here are some example static badges you can directly test:

  • PHP
    static/Powered_by-777-fff/PHP-8892BF-fff/flat-square

  • Version
    static/Version-555-fff/1.0.0-0B7DBE-fff/for-the-badge

  • Custom
    static/Open-2ecc71-fff/Source-34495e-fff/round


Cheat Sheet

Parameter Description Example
{label} Text on the left side Hello
{labelBgColor} Label background color (hex, no #) 555
{labelTextColor} Label text color (hex, no #) fff
{message} Text on the right side World
{msgBgColor} Message background color 0B7DBE
{msgTextColor} Message text color fff
{style} Badge style flat

Example: static/Hello-555-fff/World-0B7DBE-fff/flat


✨ That's it! You now have full control over static badges 🎉

Clone this wiki locally