// docs
Documentation
Everything you need to go from a URL — or a mobile app build — to a maintained regression suite across web, iOS and Android.
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.
Getting Started
What is AegisRunner?
AegisRunner explores web and native mobile products, generates and independently reviews tests, runs eligible cases, and keeps findings tied to evidence.
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.
Public Audit
Run a bounded website audit with no signup, then use a verified Free account for AI-generated tests and test execution.
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.
Set Up 2FA for Your AegisRunner Account
Enable two-factor authentication for your AegisRunner account, save backup codes, recover access, and manage organization requirements.
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.
Mobile App Testing
Upload an Android APK or iOS IPA — AegisRunner explores it on a real device, generates and runs tests, and reports crashes, accessibility and visual bugs.
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.
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.
Integrations
CI/CD Integration
Trigger scans and test runs from your CI/CD pipeline with a project trigger token. Set up under Manage → CI/CD.
Slack Integration
Slack Incoming Webhook setup, multi-channel routing on Pro+, mentions, reactions, slash commands.
Testing behind a firewall
Test private, staging, localhost, and IP-restricted apps with a local runner, an optional tunnel, static-IP allowlisting, or a self-hosted runner.
Framework plugins (Vite · Nuxt · Next)
Put AegisRunner in your dev loop: one line in your Vite, Nuxt or Next config opens a tunnel to your localhost app and scans it with AI on a keypress.
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 → CI/CD.
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.
Troubleshooting
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.
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.
Account & Billing
Billing & Plans
Can't find what you need?
Email support@aegisrunner.com or open a support request. We typically reply within a business day.