Repositories
The Repositories page gives you a current inventory of all repositories that your GitHub App installation can access, with Previewops activity overlaid on each one.
Navigate to it from the Repositories item in the dashboard sidebar.
What it shows
The list view provides the complete repository details:
| Field | Description |
|---|---|
| Repository | Repository name, full path (org/repo), and Public / Private badge |
| Preview status | Number of currently active previews, or whether the repository is idle or has not yet been deployed |
| QA | Whether QA scenarios are configured, and how many |
| Last deploy | Relative time of the most recent deploy (e.g. "3d ago") |
| Active previews | Count of unexpired previews that have not been deleted |
| Health | One of three states — see Health states |
Health states
| State | Meaning |
|---|---|
| Healthy | The repository has deployment history, whether or not a preview is currently active |
| Attention | An operational signal requires review. This state is reserved for failure signals as they become available. |
| Needs setup | The repository has never had a preview deployed |
Health and preview status are separate. A repository can have an Idle preview status and still be Healthy: it has deployed successfully before but has no active preview now.
Summary cards
The top of the page shows four at-a-glance numbers:
- Total repositories — all repositories accessible to your GitHub App installation, with a deployed-before versus never-deployed breakdown
- Active previews — total unexpired, undeleted previews across all repositories
- QA-enabled repositories — repositories with at least one active QA scenario
- Repositories need attention — repositories whose health is Attention or Needs setup
Filtering and sorting
Use the filter bar to narrow the list:
| Filter | Options |
|---|---|
| Search | Filter by repository name or full path |
| Status | All / Active (previews running) / Idle (no active previews, previously deployed) / No previews (never deployed) |
| QA | All / QA enabled / QA disabled |
| Health | All / Healthy / Attention / Needs setup |
| Sort | Last activity · Name A→Z · Health · Most scenarios |
Switch between list view (the complete table) and grid view (compact cards showing repository identity, health, preview and scenario counts, and last deployment) using the toggle in the top-right of the filter bar.
Syncing from GitHub
The repository list is fetched live from GitHub each time you open the page. Click Sync from GitHub to refresh it manually — for example, after adding or removing repositories from your GitHub App installation.
The Last synced badge in the header shows when the list was last loaded successfully, including the initial page load.
Managing GitHub App access
The Manage GitHub access button links directly to the GitHub settings page for your App installation. From there, you can grant the App access to selected repositories or every repository in the organisation.
Note: Changes made in GitHub take effect on the next Sync from GitHub in Previewops.
Available on all plans
The Repositories page is available to all plans, including Free BYOC. The data shown reflects only the repositories that your GitHub App installation currently has access to.