Skip to main content
Before you can generate or run tests, you need to add a repository to the testing dashboard.

​
Add a Repository

1

Go to Testing > Repos

Navigate to the Testing section and click “Repos” in the sidebar
2

Click Add Repository

Click the “Add Repository” button
3

Select from GitHub

Choose a repository from your connected GitHub account
4

Configure Settings

Set the base URL and default platforms (optional)
5

Save

Click “Add Repository” to finish

​
Repository Settings

When adding a repository, you can configure:
SettingDescriptionExample
Base URLThe URL where your app runs (for E2E tests)https://staging.myapp.com
PlatformsDefault browsers for E2E testsChrome, Firefox, Safari
Environment VariablesSecrets needed for tests (encrypted)API_KEY, DATABASE_URL

​
Base URL

For E2E tests, Paragon needs to know where your app is running. This is typically:
  • A staging/preview environment
  • A local URL if running tests locally
  • Your production URL (not recommended for destructive tests)
https://staging.myapp.com
https://preview-pr-123.myapp.com
http://localhost:3000

​
Environment Variables

Add any secrets your tests need. These are encrypted and only decrypted when tests run. Common examples:
  • API_KEY - API authentication
  • TEST_USER_EMAIL - Test account credentials
  • TEST_USER_PASSWORD - Test account password
  • DATABASE_URL - Database connection string
Never commit secrets to your repository. Use environment variables instead.

​
Auto-Detection

When you add a repository, Paragon scans it to detect:
  • Existing test files - Tests you’ve already written
  • Test framework - vitest, jest, pytest, etc.
  • Project structure - Where source code and tests live
This helps Paragon generate tests that match your existing setup.

​
Repository Health

After running tests, you’ll see a health indicator for each repository:
  • Green - All tests passing
  • Yellow - Some tests skipped or flaky
  • Red - Failing tests
The health bar on the dashboard shows the ratio of passing to failing tests at a glance.

​
Managing Repositories

​
Edit Settings

Click on a repository to update its base URL, platforms, or environment variables.

​
Remove Repository

Click the delete button to remove a repository. This removes all tests and run history for that repository.
Removing a repository from the testing dashboard does not affect your actual GitHub repository.

​
Next Steps

Create Tests

Generate your first AI-powered tests