Skip to main content
Deno 2 is finally here 🎉️
Learn more

CLI Badges

Generate Badges for your CLI.

Features

  • Make Beautiful Badges in CLI
  • Works with all terminals
  • Link support (soon)
  • Variety of colors to choose from
  • Written in TS with Deno
  • many more coming…

Usage

import { badges } from "https://deno.land/x/cli_badges@v0.0.1/index.ts";

console.log(badges('failed', '2', {msgBg: 'red'}))

console.log(badges('success', '2', {msgBg: 'green'}))

console.log(badges('skipped', '2', {msgBg: 'yellow'}))

Output

sample_output

badges function

badges function accepts the following arguments:

  • label: label of the badge
  • msg: message of the badge
  • opts: accepts an interface of BadgeOptions

BadgeOptions Interface

interface BadgeOptions {
  msgBg: string; // default is blue
  labelBg: string; // default is black
  msgColor: string; // default is white
  labelColor: string; // default is white
  msgStyle?: string;
  labelStyle?: string;
  msgWidth?: number;
  labelWidth?: number;
}

Available Options

Foreground Colors

  • black
  • red
  • blue
  • green
  • yellow
  • magenta
  • cyan
  • white
  • gray

Custom color support coming soon

Background Colors

  • black
  • red
  • blue
  • green
  • yellow
  • magenta
  • cyan
  • white

Custom color support coming soon

Styles

  • bold
  • italic
  • inverse
  • dim
  • strike
  • underline

Acknowledgments

I thank the author of nombrekeff/cli-badges for his original implementation in JS wth Node and also helped me with some Deno issues and giving me guidance on this project as this is my first project with TS.

License

Licensed under MIT.