Skip to main content
Ask AI

Repositories

A repository in TestRelic represents a single test project — typically one Git repository containing one or more test suites. The All Repos page (/entities) is your central hub for managing repository connections.

All Repos page​

The All Repos page displays every repository connected to your organization as a card or table row, showing:

  • Repository name and description
  • Health status — An at-a-glance indicator of recent test health
  • Pass rate — Percentage of passing tests in the most recent runs
  • Trend — Pass rate direction (improving, stable, or degrading)
  • Integration badges — Icons indicating which integrations are connected (GitHub Actions, Jira, etc.)
  • Framework label — The test framework configured for this repo

Adding a repository​

  1. Click + Add Repository (the AddRepoDrawer button) on the All Repos page.
  2. Enter a repository name and optional description.
  3. Copy the generated API key — this key is placed in your reporter configuration.
  4. Configure the @testrelic/playwright-analytics reporter with the key:
playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  reporter: [
    ['@testrelic/playwright-analytics', {
      apiKey: 'YOUR_API_KEY',
      repoId: 'YOUR_REPO_ID',
    }]
  ],
});

See the full reporter configuration reference for all available options.

Repository detail​

Click any repository to open the Repository Detail page. It has four tabs:

Test Cases tab​

Lists all unique test cases (by name and file path) ever recorded for this repository. Useful for understanding test suite coverage and identifying tests that have never passed.

Test Navigation tab​

Embeds the Test Navigation (Pathfinder) view scoped to this specific repository, showing the navigation graph of browser flows captured across all runs.

Test Runs tab​

Shows the run history for this repository. Equivalent to the org-wide Test Runs dashboard but pre-filtered to this repo.

Integrations tab​

Displays the integration status for this repository. For each connected integration (GitHub Actions, Jira, Amplitude) you can see the connection state and configure repository-level settings.

Framework setup snippets​

Inside the Repository Detail page, TestRelic displays setup code snippets specific to your configured framework. For Playwright, this includes:

  • The npm install command for @testrelic/playwright-analytics
  • A complete playwright.config.ts snippet with the reporter configured
  • A link to the full Getting Started guide
Coming soon

Framework snippets for Cypress, Selenium, and Appium are displayed as "coming soon" placeholders. Full support for these frameworks is planned in future releases.

Ask AI from a repository​

The Repository Detail page includes a direct link to open the AI assistant pre-loaded with context about that specific repository. This allows you to ask questions like "What are the most flaky tests in this repo?" with the right context already attached.

See Ask AI for more on AI context attachment.

Health metrics​

Repository health is computed from recent run data:

  • Pass rate — Percentage of test cases that passed in the most recent run.
  • Trend — Computed from the last 5 runs to indicate if health is improving or degrading.
  • Flakiness score — Based on tests that alternate between pass and fail across runs.

These metrics update automatically as new runs are uploaded.