Norvell's Public Machinations

    This package has been deprecated

    Author message:

    Please prefer istanbul-badges-readme package over this one

    TypeScript icon, indicating that this package has built-in type declarations

    1.5.1 • Public • Published

    Jest Badges Readme

    CodeClimate DevDeps GitHub license npm version PRs Welcome BuiltBy ForTheBadge

    Creates Jest Coverage badges for your file

    Statements Branches Functions Lines Build Status
    Statements Branches Functions Lines BuildStatus


    • To be short, all it does is: Creates your dynamically with your Jest Coverage Badges based on your file


    • Global Installation

        npm i -g @olavoparno/jest-badges-readme
    • Local Installation

        npm i @olavoparno/jest-badges-readme --save-dev

    Configuration and requirements

    1. Have Jest installed and with its Coverage Reporting configuration as below
    • It may be set inside your Jest config within package.json or inside your jest config file i.e. jest.config.js or jestconfig.json

        "coverageReporters": [
    1. Have a file created with the following template (please do feel free to change its presentation structure, e.g. in a table or not)
    | Statements | Branches | Functions | Lines |
    | -----------|----------|-----------|-------|
    | ![Statements](#statements# "Make me better!") | ![Branches](#branches# "Make me better!") | ![Functions](#functions# "Make me better!") | ![Lines](#lines# "Make me better!") |
    1. Call if from your terminal or from your NPM/YARN Scripts
    • For locally installed library

        "make-badges": "node_modules/.bin/jest-badges-readme"
    • For globally installed library

        "make-badges": "npm run jest-badges-readme"
    • You may also provide a different coverage folder path passed as arguments

        "make-badges": "npm run jest-badges-readme --coverageDir='./my-custom-coverage-folder'"
    • And finally via the very terminal

        jest-badges-readme --coverageDir='./my-custom-coverage-folder'

    Short summary onto what Jest and Jest Badges Readme covers for us

    • % Stmts (which states for Statements)
    • % Branch (pretty self explanatory)
    • % Functions (won't repeat myself)
    • % Lines (last but not least)

    This library will create badges URLs for these former 4 items into your if you followed the previous steps

    • Open up your and add 4 markers inside it for each Jest coverage item respectively. These markers must be as follows:

      1. '#statements#'
      2. '#branches#'
      3. '#functions#'
      4. '#lines#'

    If you feel you might need a local building badge indicator, add these NPM scripts in order to manage your local building badge as well

      "prebuild": "echo nok > .buildstatus",
      "postbuild": "echo ok > .buildstatus"
    • Add one more marker like the example below. This is going to create a file called .buildstatus in your project's root telling this library if your build is either successful or a failure
      1. '#buildstatus#'

    Example of with building status too

    | Statements | Branches | Functions | Lines | Build Status |
    | -----------|----------|-----------|-------| ------------ |
    | ![Statements](#statements# "Make me better!") | ![Branches](#branches# "Make me better!") | ![Functions](#functions# "Make me better!") | ![Lines](#lines# "Make me better!") | ![BuildStatus](#buildstatus# "Building Status") |

    Using as a part of your githooks

    • If you want to have this run on the precommit hook and update the commit in place, just install husky and add the precommit script to your package.json
    1. Install Husky
      npm install --save-dev husky 
    1. Add your precommit script
      "husky": {
        "hooks": {
          "pre-commit": "jest && node_modules/.bin/jest-badges-readme && git add ''"
    1. Git Commit and Push. Just use your workflow as usual. If your tests fail, no commit. If they pass, update the and add the file to the commit. Nice!


    The purpose of this library is to motivate developers to constantly write a solid documentation and testing. A complete and nice looking documentation is key to a successful development and code maintainability. Please feel free to open any issues you might come up with and to submit your own PRs. There is not a contributing guide yet


    Thanks goes to these wonderful people (emoji key):

    Olavo Parno
    Olavo Parno

    🤔 💻 ⚠️

    🤔 🐛 🖋
    Dave Fisher
    Dave Fisher


    This project follows the all-contributors specification. Contributions of any kind welcome!


    Jest Badges Readme is MIT licensed.


    npm i @olavoparno/jest-badges-readme

    DownloadsWeekly Downloads






    Unpacked Size

    84.8 kB

    Total Files


    Last publish


    • absurdus