Codecov

Code coverage done right.®

Welcome to Codecov Documentation. You'll find comprehensive guides and documentation to help you start working with Codecov as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Quick Start

A quick start guide and collection of references for those that are brand new to codecov.

Getting started with codecov is easy. The rest of this page will outline important first steps to getting your first repository up and running on codecov.

Trying to get Started with Codecov Enterprise?

Many of the instructions below can be used with our on-premises offering with minimal changes.

If you're attempting to setup an on-premises install of Codecov Enterprise, be sure to read our Enterprise Install Guide

Getting Started

Basic Usage

  1. Sign up on codecov.io and link either your GitHub, GitLab, or Bitbucket account.
  2. Once linked, Codecov will automatically sync all the repositories to which you have access.
  3. You can click on an organization from your dashboard to access its repositories, or navigate directly to a specific repository using: https://codecov.io/<repo-provider>/<account-name>/<repo-name>. Example: https://codecov.io/gh/scrapy/scrapy.
A repository that has no coverage reports uploaded to codecov. Note that the repository upload token is displayed here.

A repository that has no coverage reports uploaded to codecov. Note that the repository upload token is displayed here.

  1. Use the bash uploader and a repository upload token, to upload a coverage report to Codecov.
  2. Navigate back to the repository on Codecov, and you should see coverage information.

Don't Want to Use The Bash Uploader Directly?

Codecov has a number of framework/language specific implementations for uploading coverage reports. You can access many of these from our list of Supported Languages

Advanced Usage

  1. Get codecov comments on your Pull Requests: (GitLab/Bitbucket) use a Team Bot, (GitHub) use the codecov GitHub integration.
  2. Enforce relative or absolute thresholds during your CI build using the [Codecov YAML](https://docs.codecov.io/docs/supported-ci-providers0
  3. Use flags to categorize reports in a single repository. This is great for monorepos or projects that include different types of test coverage (e.g., unit, end to end, integration).
  4. Use codecov with the Sourcegraph Browser Extension. Note that on-premises versions of repository providers (e.g. GitHub Enterprise) are currently not supported with the Codecov Sourcegraph Browser Extension.

Common Questions

What languages does Codecov support?
See Supported Languages

Will Codecov work with my CI provider?
See the List of CI Providers that work with Codecov out of the box, but all CI providers are able to be detected.

Additionally, you can read more about how Codecov fits in with your CI provider in the CI Provider Relationship

Will Codecov work with my repository provider?
Codecov works with Bitbucket, GitLab, and GitHub; and supports each provider's on-premises offering.


What's Next

Consult our FAQ for even more helpful information

Frequently Asked Questions