Quick Start

Set up your first VigilQA project and run AI-generated tests in under 20 minutes.

Step 1 — Activate your trial

Go to sentinelflux.in and click Start free trial. You'll get 14 days of full Pro access with no credit card required. After email verification, you'll land on the dashboard's onboarding wizard.

Step 2 — Create a project

From the dashboard, click New Project and provide:

• Project name — any identifier (e.g. my-app-staging)
• Application URL — the base URL of your application (e.g. https://staging.myapp.com)
• Application type — Web UI, REST API, GraphQL API, or mixed
• Modules to enable — select the test types you want (you can change this later)

VigilQA will verify it can reach the application URL before saving the project.

Step 3 — Build the Knowledge Base

The Knowledge Base (KB) is where you describe your application's expected behaviour. Navigate to Project → Knowledge Base → Add Domain.

Each domain maps to a functional area of your application (e.g. Authentication, Checkout, API / Products). Within each domain, add scenarios — plain-language descriptions of what should work:

# Example KB entry (YAML format shown for reference)
domain: authentication
scenarios:
  - id: AUTH-001
    title: "User can log in with valid credentials"
    steps:
      - Navigate to /login
      - Enter registered email and password
      - Click Sign In
    expected: Redirect to /dashboard with user session active

  - id: AUTH-002
    title: "Invalid password shows error message"
    steps:
      - Navigate to /login
      - Enter registered email with wrong password
      - Click Sign In
    expected: Error message "Invalid credentials" displayed; no redirect

Step 4 — Run the Generation Pipeline

Once you have at least one domain with scenarios, click Generate Tests. The five generation agents run in sequence:

1. AppExplorer crawls your app and captures live DOM selectors for each page referenced in the KB
2. DocGen converts KB scenarios into structured test case documents
3. DocReview validates the documents for completeness and consistency
4. ScriptGen produces executable pytest scripts using the captured selectors
5. ScriptReview validates syntax, selector existence, and assertion quality

The full pipeline for 10–20 scenarios typically completes in 3–7 minutes. You can monitor progress in real time under Agent Activities.

Step 5 — Review and approve

Generated scripts land in Approvals before being committed to your test suite. Review the generated code, optionally edit it, then click Approve. Rejected items return to the queue with your comments so the agent can regenerate.

Step 6 — Run your first test suite

Navigate to Test Plans, select or create a plan, and click Run Now. The results appear in real time in Test Runs. After the run completes, post-run agents automatically analyse the results.

Step 7 — Connect CI/CD

To trigger runs automatically on every deployment, connect your CI/CD pipeline. Navigate to Settings → CI/CD Integration to get your project's API token and webhook URL.

See the integration guides for your platform:

• GitHub Actions
• GitLab CI
• Jenkins & Other