badgen

Fast handcraft svg badge generating library.

Github stars Tracking Chart

badgen

npm version
Coverage Status
Bundle size
License

Fast handcraft svg badge generator. Used on badgen.net.

  • ? Zero dependency
  • ⚡️ Fast by design (see benchmarks)
  • ?‍ Running in node & browser

Usage

npm install badgen

const { badgen } = require('badgen')

// only `status` is required.
const svgString = badgen({
  label: 'npm',     // <Text>
  labelColor: 'ADF' // <Color RGB> or <Color Name> (default: '555')
  status: 'v1.2.3', // <Text>, required
  color: 'blue',    // <Color RGB> or <Color Name> (default: 'blue')
  style: 'flat',    // 'flat' or 'classic' (default: 'classic')
  icon: 'data:image/svg+xml;base64,...', // Use icon (default: undefined)
  iconWidth: 13,    // Set this if icon is not square (default: 13)
  scale: 1          // Set badge scale (default: 1)
})

Available color names:










In browser

<script src="https://bundle.run/badgen"></script>
<script>
  var svgString = badgen.badgen({ /*...*/ })
</script>

Benchmarks

npm run bench on iMac 5K (Late 2014), 3.5G i5, with Node.js 12.11.0:

[classic] style, long params x 985,898 ops/sec ±0.37% (94 runs sampled)
[classic] style, full params x 1,284,886 ops/sec ±0.42% (95 runs sampled)
[classic] style, with emoji  x 1,291,768 ops/sec ±0.28% (95 runs sampled)
[classic] style, with icon   x 1,177,120 ops/sec ±0.94% (95 runs sampled)
   [flat] style, long params x 780,504 ops/sec ±0.39% (94 runs sampled)
   [flat] style, full params x 1,012,111 ops/sec ±0.40% (97 runs sampled)
   [flat] style, with emoji  x 1,013,695 ops/sec ±0.91% (95 runs sampled)
   [flat] style, with icon   x 994,481 ops/sec ±0.30% (94 runs sampled)

See Also

Main metrics

Overview
Name With Ownerbadgen/badgen
Primary LanguageJavaScript
Program languageJavaScript (Language Count: 2)
Platform
License:ISC License
所有者活动
Created At2018-06-23 12:03:51
Pushed At2023-10-17 17:12:40
Last Commit At2023-07-21 20:04:46
Release Count46
Last Release Namev3.2.3 (Posted on 2023-07-21 20:04:46)
First Release Namev0.1.0 (Posted on 2018-06-23 00:38:10)
用户参与
Stargazers Count542
Watchers Count5
Fork Count39
Commits Count309
Has Issues Enabled
Issues Count22
Issue Open Count7
Pull Requests Count50
Pull Requests Open Count1
Pull Requests Close Count9
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private