/badge-generator

Magically generate Markdown badges for your docs 🛡️ 🦡 🧙

Primary LanguageTypeScriptMIT LicenseMIT

Badge Generator
🛡️ 🦡 🧙

Magically generate Markdown badges for your docs

GH Pages Deploy GitHub tag License

CodeQL Known Vulnerabilities

Made with Node Package - Yarn Package - Vue Package - Typescript

WebsiteSample badgesDocumentation

Overview

A convenience tool that makes it easy to generate custom Markdown for badges to put on your documentation or website.

Choose a page, enter your details, and click Submit to generate some Markdown code for you to copy and paste.

External tools are used to actually render badges - mostly using shields.io.

Preview

Sample screenshot

Open the web app

Start creating badges for your docs.

Site

Sample badges

Examples of a few badges generated with the app and rendered here on a markdown doc

Note that most of the badges at the top of this README.md file were also generated using this app.

Social badges

Link to your project. From another project - even paste these in an online forum or your blog.

MichaelCurrin - badge-generator stars - badge-generator forks - badge-generator

Repo metadata

Add to the top of your README.md file. These are about your specific repo. Some are dynamic and some are hardcoded (like license below).

GitHub tag License issues - badge-generator

Generic

Put whatever text value you want in this static (fixed) badge. You can change the color, logo and destination link. Use the badge for your repo, website or documentation.

Foo - Bar Maintained - yes Contributions - welcome

Packages

You might want to list a dependency of your repo with the value actually in use, instead of a static badge.

Here we have Vue listed as a dependency of this Badge Generator repo and the version number changes to reflect what is in the package.json file.

package - vue

Dynamic data

Similar to above but more flexible.

Create a badge that references any value within a public data file (currently only JSON files are supported by Badge Generator). The badge stays up to date with whatever value is in the target file.

In the example below, we lookup the version of VS Code IDE needed by a VS Code extension. The query is $.engines.vscode and that is done against this target package.json file on GitHub.

auto-commit-msg

Catalogue

Pre-made badges around languages and tools. Just copy and paste them - no form input needed. You might put a static value there for what version you support without making it dynamic.

If you can't find a badge you're looking for there, use the Generic badge option to make your own.

OS - Linux Made with Bash Made with Python

Documentation

User guide for using the app and how setup and run the app yourself

view - Documentation

License

Released under MIT by @MichaelCurrin.

  • You can freely modify and reuse.
  • The original license must be included with copies of this software.
  • Please link back to this repo if you use a significant portion the source code.