A badge generator for Laravel.

v3.0.0 2023-08-21 16:12 UTC

This package is auto-updated.

Last update: 2024-05-13 09:14:20 UTC


An SVG badge generator for Laravel.


This version requires PHP 8.2 and Laravel 11.0 and above. For older versions of PHP or Laravel, check out the 3.x branch.

To get the latest version, simply require the project using Composer:

composer require cachethq/badger

Once installed, if you are not using automatic package discovery, then you need to register the Cachet\Badger\BadgerServiceProvider service provider in your config/app.php.


Get started immediately:

// Using the Facade
Badger::generate('license', 'MIT', 'blue', 'plastic')

// Dependency injection example
$badger->generate('license', 'MIT', '#ff69b4', 'plastic')


The generate method takes four parameters:

Badger::generate('license', 'MIT', 'blue', 'flat-square')

The first parameter is the subject, or what it is the badge is showing. In the example above this is the license. The second parameter is the value (the right hand of the badge). Next is the color of the badge. This can be one of the following preset colors or a valid hex string.

  • brightgreen
  • green
  • yellow
  • yellowgreen
  • orange
  • red
  • blue
  • grey
  • lightgray

And finally the fourth parameter is the badge type. This determines the style of the badge and can be one of the four values below.

  • flat-square (default)
  • plastic-flat, flat
  • plastic
  • social (without links)


If you discover a security vulnerability within this package, please e-mail us at All security vulnerabilities will be promptly addressed.


Cachet Badger is licensed under The MIT License (MIT).

Based on the work done at badges/poser.