// 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
From one URL to a report and generated tests in minutes — scan, review, run.
Dashboard Overview
How the app is laid out: your projects grid, the Report / Tests / Runs lenses inside a project, and the live Activity panel.
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.
Account Settings
Your account settings: profile, security & 2FA, team, billing, SSO, and the audit log — all under Settings.
Live Demos
Browse Live Demos to see real reports AegisRunner generated for public demo apps — pages, audits and tests.
Managing Projects
Create, open, and manage projects from the projects grid; switch lenses; manage members in Settings.
Two-Factor Authentication (2FA)
TOTP 2FA via any authenticator app. Backup codes, recovery flow, organization-wide enforcement on Business+.
Test Execution
Running Tests
Run suites and read results in the Runs lens: per-case steps, screenshots, recordings, re-run, auto-heal, triage.
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
Visual-regression assertions capture screenshots and pixel diffs during a run; full-page baselines are managed in Manage → Regression.
API Testing
Mix HTTP API steps with UI steps in any test. JSON-path assertions, value capture, GraphQL, auth patterns.
Failure Triage
Learn how AegisRunner AI automatically clusters test failures by root cause with severity ratings and fix recommendations.
Smart Test Selection
Use smart test selection strategies to run focused test subsets. Recent failures, smoke tests, high priority, changed routes, and regression risk.
Accessibility Testing
axe-core WCAG checks on every page. Severity-ranked findings, ARIA snapshots, ruleset config, and compliance report exports.
Regression Manifests
Snapshot a known-good scan as a baseline, then re-run it to replay the exact same pages and surface what changed. In Manage → Regression.
Test Generation
AI-Powered Test Generation
AI test generation runs automatically after a scan; suites appear in the Tests lens tagged by type. Regenerate anytime.
Creating User Flow Tests
Multi-step and multi-page flows are generated as Journey & Composite suites; view and edit their steps in the Tests lens.
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
Lock in a known-good scan as a baseline and re-run it to see exactly what changed. Managed in Manage → Regression.
Integrations
CI/CD Integration
Trigger scans and test runs from your CI/CD pipeline with a project trigger token. Set up under Manage → Integrations.
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
Get alerted when scans or runs finish or fail — Email, Slack, Discord, Teams or webhooks, per project, in Manage → Notifications.
Deployment Webhooks
Auto-scan after every deploy by connecting Vercel, Netlify or GitLab deploy hooks in Manage → Integrations.
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.
Crawling
Starting a New Crawl
Configure and start a scan: Quick vs Advanced, page budget, device, sitemap, form filling.
Understanding Crawl Results
Read scan results in the Report lens: page list, health dots, audits per page, and anchored tests.
Test Data Management
Manage tokens, cookies, headers, and login scripts per project / environment. AES-256 at rest, masked in logs.
Troubleshooting
Team & Collaboration
Team Management
Invite people to your org (Settings → Team) and to individual projects (Manage → Members). Four roles control access.
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.
Billing & Plans
Can't find what you need?
Email support@aegisrunner.com or open a support request. We typically reply within a business day.