Codecov Browser Extension for GitHub

Automatically see code coverage data and line annotations while browsing files or reviewing pull requests in GitHub.

Installing

If you wish to simply use the extension, it is available as a Firefox Add On and a Chrome Extension.

About this extension

The Codecov browser extension makes it easy to identify needed test areas by showing you absolute coverage and coverage changes overlaid with your code right in GitHub.

Once installed, get:

• Line coverage information while viewing commits and single files
• Line coverage information and coverage totals on Pull Requests
• The ability to filter coverage using Flags and Components directly in the GitHub UI

Pre-requisites:

• Must use either Firefox or Google Chrome web browsers.
• Must have GitHub's Global navigation update enabled

How to enable: Click your avatar at the top-right of a GitHub page and select “Feature preview”. Then select “Global navigation update” and click the Enable button located at the top right of the modal. The extension uses your logged-in session to determine what private repos you have access to. Please make sure to log in to Codecov using your web browser to view coverage data for private repos in GitHub,

Use with Self-Hosted and Dedicated Cloud Versions of Codecov

You can use this extension against installations of Codecov and GitHub that are:

• Self-hosted
• Part of Codecov's Dedicated Cloud plan

In order to do so you must provide:

• The URL of the Codecov installation
• The URL of your GitHub installation (even if that url is just https://github.com)
• An API token for Codecov

You can provide this information by using the Settings menu for the Extension in your browser.

Running Locally

$ web-ext run -s dist -t chromium

Note: You must be on GitHub's new UI for this extension to perform its magic. ✨

As of today, GitHub will show you the old UI if not logged in (running in a temporary profile using web-ext).

---

Build Instructions

These steps will build the extension in the dist/ folder.

MacOS 13.3.1 (22E261)
NodeJS version 19.8.1

Chrome

$ npm install
$ npm run build

Firefox

$ npm install
$ npm run build
$ cp dist/manifest.firefox.json dist/manifest.json

About Codecov

Codecov is the all-in-one code coverage reporting solution for any test suite - giving developers actionable insights to deploy reliable code with confidence.

License