// docs
Documentation
Everything you need to go from a URL to a maintained regression suite.
Getting Started
What is AegisRunner?
Automated regression testing for web apps. Scan your site, generate Playwright tests, run on Chromium/Firefox/WebKit, auto-heal when locators drift.
Quick Start Guide
First project scanned and first tests running in about five minutes. Covers free scan, auto-scan on project creation, multi-browser runs, and self-healing tests.
Free Scan
Try AegisRunner with no signup. Drop in a URL and email, get a one-page scan and AI-generated tests by email in about 90 seconds.
Dashboard Overview
How the dashboard works: per-project vs workspace mode, stats, quick actions, the getting-started checklist, coverage gaps, and recent activity.
Live Demos
Public scans of well-known production sites — Stripe, Tailwind, React, Next.js, Astro, Svelte, Nuxt — with the AI-generated test suites and downloadable Playwright code.
Account Settings
Personal profile, security (password / 2FA / sessions), email preferences, API tokens, account deletion.
Managing Projects
Create projects, switch between the eight tabs, configure tokens and login scripts, set up environments, manage team roles, and delete safely.
Two-Factor Authentication (2FA)
TOTP 2FA via any authenticator app. Backup codes, recovery flow, organization-wide enforcement on Business+.
Troubleshooting
Billing & Plans
Team & Collaboration
Team Management
Invite teammates, manage roles, track invitations, bulk operations on Pro+, domain auto-join, SSO JIT.
Roles & Permissions (RBAC)
Owner / Admin / Member / Viewer at organization and project layers. Full permission matrix, invitation states, seat limits, audit logs.
SSO / SAML Single Sign-On
SAML SSO with Okta, Entra, Google Workspace. JIT provisioning, group-to-role mappings on Enterprise, enforcement.
Integrations
CI/CD Integration
Trigger scans and runs from any CI. Token setup, full payload, GitHub PR sticky comments, commit status checks, smart test selection.
Slack Integration
Slack Incoming Webhook setup, multi-channel routing on Pro+, mentions, reactions, slash commands.
Integrations Guide
Index of all integrations: notifications, CI, deployment hooks, SSO, BYOK, test data, audit logs.
Notifications & Alerts
Email, Slack, Discord, Teams, webhooks. Per-channel event filters so engineering doesn't see the QA noise. HMAC-signed webhooks.
Deployment Webhooks
Auto-trigger scans on every deploy. Vercel, Netlify, GitLab, or a signed generic webhook. Works with preview URLs and pairs with PR comments.
Issue Tracking (Jira & GitHub)
Auto-file GitHub Issues or Jira tickets per failure cluster. Updates and de-duplicates across runs. Auto-resolves when failures clear.
Test Execution
Running Tests
Run test suites across Chromium, Firefox, and WebKit. Live results, auto-heal, AI triage, single-test re-runs, and CI triggering.
Debugging Failed Tests
Auto-heal first, AI triage second. Then screenshots, logs, traces. Plus common failure modes — locators, timeouts, auth, flakes, bot-block — and how to fix each.
POM Export
Export any suite as a structured Playwright project with Page Object Model architecture. Drop into your repo and run.
Visual Regression Testing
Pixel-level screenshot diffs at every test step. 3-panel diff UI, accept/reject, masking, plan-based retention.
API Testing
Mix HTTP API steps with UI steps in any test. JSON-path assertions, value capture, GraphQL, auth patterns.
Failure Triage
Automatic cluster + label of every failure: real regression, new failure, flake, environment, or auto-healed — with concrete fix suggestions.
Smart Test Selection
Run only the tests that matter on this PR. Strategies: changed files, flake, recency, tags, last-run failures.
Accessibility Testing
axe-core WCAG checks on every page. Severity-ranked findings, ARIA snapshots, ruleset config, and compliance report exports.
Regression Manifests
Deterministic CI: capture one good scan as a manifest and replay the exact same path every time. Pair with visual regression for pixel-level checks.
Test Generation
AI-Powered Test Generation
How AegisRunner writes tests for every scanned page: the three-pass pipeline, scenario families, plan-aware coverage, custom prompts, and BYOK.
Creating User Flow Tests
Multi-page tests that simulate real journeys. Mix UI and API steps; capture values across steps; use {{RANDOM}} for unique data.
Composite Test Suites
Combine multiple test suites into one. Share browser session across children for stateful flows. Run policy controls failure behavior.
Test Baseline Review
Review AI-generated tests before they run unattended. Approve, edit, or reject; strict mode for compliance.
Crawling
Starting a New Crawl
Configure and start a new scan. Modes, page scope, device emulation, fill/submit forms, audits, plan limits, baselines, and CI triggering.
Understanding Crawl Results
Read scan results: pages, states, accessibility, SEO, security, performance, AI test coverage banner, baselines, and comparisons.
Test Data Management
Manage tokens, cookies, headers, and login scripts per project / environment. AES-256 at rest, masked in logs.