Skip to main content
The Deno 2 Release Candidate is here
Learn more

Maintained

Tai

Tai is a Deno badge generation module. It is written with Maintained’s badging system in mind.

Permissions

You may need to run scripts that use Tai with the allow-read permission, if you use icons in your badges. Tai reads downloaded icons from the filesystem.

Usage

import { generate } from "https://deno.land/x/tai/mod.ts";

const badge = {
    fields: [
    {
      content: "Build Status",
      color: 0, // 0-6 or BadgeColor.Simple (etc), refer to BadgeColor enum
      width: 93 // specifies width of badge text (11px Verdana)
    },
    {
      content: "Passing",
      color: 4,
      width: 67
    },
    // ...
    // Minimum one field, unlimited maximum for true mayhem
  ],
    style: 0 // 0-2 or BadgeStyle.Plastic (etc), refer to BadgeStyle enum
}

// Returns SVG string of badge
const svg = await generate(badge);

BadgeStyle & BadgeColor (exported types)

enum BadgeColor {
    Simple,
    Slate,
    Seabed,
    Subterranean,
    Savannah,
    Sahara,
    Sunset
}

enum BadgeStyle {
    Plastic,
    Flat,
    ForTheBadge
}

(Current) Caveats

Because Tai is built with Maintained in mind first and foremost, it offloads the width calculation of badge fields to the Maintained dashboard. This makes sense to reduce development overhead because the browser can calculate the width, while an additional package would be needed in Tai. Admittedly, this is pretty annoying for using this module by itself, so it might change later. I dunno. No promises.