svg-shield

Easy SVG shields (badges) for node with custom text and colors

Usage no npm install needed!

<script type="module">
  import svgShield from 'https://cdn.skypack.dev/svg-shield';
</script>

README

svg-shield

SVG shields (badges) for node with custom text, colors, and widths.

These SVGs show how you can customize the text, both colors, and the width of each side.

Sample Shield

Sample Shield

These SVGs are based on those used by shields.io.

Install

npm install svg-shield --save

API

var shield = require( "svg-shield" );
var options = { name: "name", value: "value" }; // see Options section
shield.getShield( options, function ( err, svg ) {
    // do something with svg now, for example with Express
    return res.type( "image/svg+xml" ).send( svg );
}

Options

nameWidth default 90

The width of the left side of the shield

valueWidth default 40

The width of the right side of the shield

nameBgColor default "#555"

The background color of the right side of the shield, commonly a neutral color, like gray

valueBgColor default "#4b1"

The background color of the right side of the shield, commonly an indicator color, like red or green

name default ""

The text on the left side of the shield

value default ""

The text on the right side of the shield

fontFamily default "sans-serif"

The font that should be used for badge text

fontSize default 11

The size of the badge text, values are bounded to min: 8, max: 17

radius default 5

The size of the chamfer of the badge, values are bounded to min: 0, max: 10

License

MIT