Skip to content
This repository has been archived by the owner on Mar 2, 2021. It is now read-only.
/ badge-it Public archive

Github action to automatically add badges to your readme ⚡

License

Notifications You must be signed in to change notification settings

rocktimsaikia/badge-it

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

badge-it Build Status

Github action to automatically add shield badges to your README.md ⚡

A Github action to add badges in your README.md without any hassle. We love badges but generially it's a tedious job to copy paste badges from shield.io to your README.md .So this Action helps to add badges without you having to do all the copy pasting and configuration.

Usage

  • Badges - To add your preffered badge, check it's correspoding key in the Availabe Badges section below and add the key in the badges input seperated by commas (,).

  • Badge Style - To specifiy style for your badges .Add your preffered badge style in the badge-style input. Default is flat.

- name: Add Badges
  uses: rocktimsaikia/badge-it@master
  with:
    GITHUB_TOKEN: ${{ secrets.MY_TOKEN }}
    badges: 'gh_license, gh_version, gh_stars'
    badge-style: 'flat-square'

Inputs

  • GITHUB_TOKEN - A personal Github token.
  • badges - Name of the badges to add to your README.
  • badge-style - The style type for your badges.

Available Badges

Keys are enclosed in brackets ()

  • GitHub - Github license (gh_license)
  • GitHub - Package.json version (gh_version)
  • GitHub - Stars (gh_stars)
  • GitHub - Fork counts (gh_fork)
  • GitHub - Followers counts (gh_followers)
  • GitHub - Open issues (gh_open_issues)
  • GitHub - Closed issues (gh_closed_issues)
  • GitHub - open pull requests (gh_open_pr)
  • GitHub - All dependecnies (gh_dependencies)
  • GitHub - Repo Size (gh_repo_size)
  • GitHub - Code Size (gh_code_size)
  • GitHub - TravisCI.com (travis_com)
  • GitHub - TravisCI.org key(travis_org)

Todo

There are many more badges that can be added here. If you want to contribute open a issue to discuss before hand. Currenly this action accepts only specifically Github related badges. But badges for CI services can also be added here. Thats could a be seperate issue on itself.

Related