> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polarity.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> AI-powered test generation, execution, and evolution for your repositories.

Paragon Testing lets you generate, run, and evolve tests for your repositories. Import existing tests, generate new ones with AI, and let Paragon automatically propose test updates when your code changes.

## How It Works

```
Add a repository → Import or generate tests → Tests run automatically → Evolve tests keep them updated
```

<Steps>
  <Step title="Add a Repository">
    Connect a GitHub repository and configure test settings
  </Step>

  <Step title="Import or Generate Tests">
    Import existing tests or generate new ones with AI
  </Step>

  <Step title="Run Tests">
    Execute manually, on schedule, or automatically on PR/push
  </Step>

  <Step title="Evolve Tests">
    Paragon proposes test updates when your code changes
  </Step>
</Steps>

## Test Types

Paragon supports two modes of testing:

### Code Tests (Unit & Integration)

Tests that live in your repository and run via your test framework.

* **Unit Tests**: Test individual functions or components in isolation
* **Integration Tests**: Test multiple parts working together (APIs, databases)
* **Frameworks**: vitest, jest, mocha, pytest, go test, cargo test, and more

Code tests can run automatically on PRs and pushes.

### E2E Tests (Step-Based)

Browser-based tests that run against a deployed URL.

* **Step-Based Builder**: Visual interface to create test flows
* **AI Actions**: Natural language steps like "fill in the login form"
* **Multi-Platform**: Chrome, Firefox, Safari, Mobile

E2E tests run against your production or staging URL.

### Performance Tests

Measure page load speed and Core Web Vitals.

* **Metrics**: LCP, FCP, CLS, TTFB
* **Budgets**: Set thresholds and get alerts when exceeded
* **Conditions**: Test under various network and CPU throttling

## Key Features

| Feature                  | Description                                       |
| ------------------------ | ------------------------------------------------- |
| **Test Runner**          | Run code tests on PR/push, E2E tests on prod URLs |
| **Evolving Tests**       | Auto-propose test updates when code changes       |
| **Multi-Platform**       | Run E2E tests across browsers and devices         |
| **Regression Detection** | Automatically flag tests that start failing       |
| **GitHub Integration**   | Results on PRs, blocking status checks            |

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/dashboard/testing/quickstart">
    Get tests running on PRs in 5 minutes
  </Card>

  <Card title="Generate Tests" icon="wand-magic-sparkles" href="/dashboard/testing/generating">
    Create tests with AI
  </Card>
</CardGroup>