Create an SVG of your GitHub Sponsors

npm install --save-dev ghsvg

• Create a .env file if you don't already have one in your project, and set the GITHUB_TOKEN in it.

GITHUB_TOKEN=ghp_xxx

• Create a configuration file.

Configuration file can be

• A .ghsrc file written in JSON or YAML.
• A .ghsrc.json, .ghsrc.yml, .ghsrc.yaml, or .ghsrc.json5 file.
• A .ghsrc.js, .ghsrc.cjs or .ghsrc.mjs file that exports an object.
• A .ghsrc.toml file.

• username: The GitHub user or organization for fetching the sponsors.

• outFile: The output SVG file.
• otherSponsors: A newline separated file with sponsors from sources other than GitHub Sponsors.
• range: The dollar amount range of sponsorships you want to include.
• monthlyTiersRange: Specify a different range for monthly sponsorships you want to include.
• oneTimeTiersRange: Specify a different range for one-time sponsorships you want to include.
• customAmountRange: Specify a different range for custom amount sponsorships you want to include.
• svgWidth: The total width of the SVG (in px).
• svgImageWidth: The width of each image in the SVG (in px).
• svgImageSpace: The space between each image in the SVG (in px).
• quiet: No Output

Note: Since the sponsorship amount is not public, if you are creating the SVG for an account other than yours, the ranges will have no effect and all sponsors will be included.

{
  "username": "shivammathur",
  "outFile": "sponsors.svg",
  "range": [1, 12000],
  "svgWidth": 1024,
  "svgImageWidth": 64
}

module.exports = {
  "username": "shivammathur",
  "outFile": "sponsors.svg",
  "range": [1, 12000],
  "svgWidth": 1024,
  "svgImageWidth": 64,
};

username: shivammathur
outFile: sponsors.svg
range: [1, 12000]
svgWidth: 1024
svgImageWidth: 64

username = "shivammathur"
outFile = "sponsors.svg"
range = [ 1, 12_000 ]
svgWidth = 1_024
svgImageWidth = 64

npx ghsvg

In addition to using a configuration file, you can also specify the configuration options in the CLI. To see available options:

npx ghsvg --help

MIT