Skip to main content
Paragon generates test code from natural language descriptions. Tell it what to test, and it writes the code.

​
Create a New Test

1

Go to Testing > Tests

Navigate to the Testing section and click “Tests”
2

Click New Test

Click the “Add Test” button
3

Select Repository

Choose which repository this test is for
4

Choose Test Type

Select Unit, Integration, or E2E
5

Describe Your Test

Enter a prompt describing what to test
6

Generate & Save

Click Generate, review the code, then Save

​
Writing Good Prompts

The better your prompt, the better the generated test.

​
Unit Test Prompts

Be specific about the function and expected behavior: 
Test the calculateDiscount function:
- Returns 0 for orders under $50
- Returns 10% off for orders $50-$100
- Returns 20% off for orders over $100
- Throws error for negative amounts

​
Integration Test Prompts

Specify the endpoint, inputs, and expected outputs: 
Test POST /api/users/register:
- Returns 201 and user object for valid email/password
- Returns 400 for invalid email format
- Returns 409 if email already exists
- Password is not included in response

​
E2E Test Prompts

Describe the user journey step by step: 
Test the checkout flow:
1. Go to /products
2. Click "Add to Cart" on the first product
3. Click the cart icon
4. Click "Checkout"
5. Fill in shipping address
6. Enter test credit card 4242424242424242
7. Click "Place Order"
8. Verify order confirmation page shows

​
Test Organization

Tests are organized into Suites (folders) within each repository. 
Repository: my-app
├── Suite: Authentication
│   ├── Test: Login flow
│   ├── Test: Registration
│   └── Test: Password reset
├── Suite: Checkout
│   ├── Test: Add to cart
│   └── Test: Payment processing
└── Suite: API
    ├── Test: GET /api/users
    └── Test: POST /api/orders
When creating a test, you can:
  • Add it to an existing suite
  • Create a new suite

​
Choosing a Framework

For unit and integration tests, select your test framework:
LanguageFrameworks
JavaScript/TypeScriptvitest, jest, mocha
Pythonpytest, unittest
Gogo test
Rustcargo test
Paragon auto-detects your framework from package.json, pyproject.toml, etc. You can override if needed.

​
Choosing Platforms (E2E Only)

For E2E tests, select which browsers to run on:
  • Chrome - Most common, fastest
  • Firefox - Good for cross-browser testing
  • Safari - Required for macOS/iOS compatibility
  • Mobile - Mobile viewport simulation
You can select multiple platforms. Each platform runs as a separate job.

​
Import Existing Tests

Already have tests? Import them instead of generating new ones:
1

Click Import tab

In the new test dialog, click “Import”
2

Select test file

Browse your repository and select an existing test file
3

Save

The test is added to your dashboard for tracking

​
Auto-Detect Tests

Let Paragon scan your repository and find all existing tests:
1

Click Auto-Detect tab

In the new test dialog, click “Auto-Detect”
2

Run scan

Paragon analyzes your repository structure
3

Review results

See all detected test files and frameworks
4

Import selected

Choose which tests to add to the dashboard

​
Editing Tests

Click any test to edit it:
  • Update the test name or description
  • Regenerate code with a new prompt
  • Change platforms (E2E)
  • Move to a different suite

​
Next Steps

Run Tests

Execute your tests and view results