# QA Wolf Docs

## Docs

- [How to integrate with Asana](https://docs.qawolf.com/qawolf/Asana-2a15b2a994fb805287acdba6373e6758.md): Connect QA Wolf to Asana to automatically create and sync bug report issues in your Asana workspace.
- [Automate flows using AI](https://docs.qawolf.com/qawolf/Automate-flows-using-AI-2d35b2a994fb8084b524cfc9aca7c358.md): Use Automation AI to create, edit, and debug flows from plain-language or voice instructions.
- [How to integrate with Azure DevOps Boards](https://docs.qawolf.com/qawolf/Azure-DevOps-Boards-29c5b2a994fb81b09697f2f1e4f9fdf1.md): Connect QA Wolf to Azure DevOps Boards to automatically create and sync bug report issues using OAuth.
- [Choose the right CI environment to execute your tests](https://docs.qawolf.com/qawolf/Choose-the-right-CI-environment-to-execute-your-tests-29c5b2a994fb8031a3ddc1355eb4e7be.md): QA Wolf supports testing across any CI environment, so you can align testing goals with your existing release process.
- [Clear a release](https://docs.qawolf.com/qawolf/Clear-a-release-2c55b2a994fb808fa5ddfa157a89adcd.md): Resolving failures is about deliberately clearing a release, not about achieving 100% passing results.
- [Create a new flow](https://docs.qawolf.com/qawolf/Create-a-new-flow-2c15b2a994fb802193a5c05e0219eb59.md): Create flow files and folders and write test code manually in the QA Wolf code editor.
- [How to verify and debug your test](https://docs.qawolf.com/qawolf/Debug-tests-and-flows-2c15b2a994fb805c9e92eec7a4a3e83e.md): Run your test code in a live browser, identify failures, and use debugging tools to fix issues.
- [Diagnose the cause of a failing flow](https://docs.qawolf.com/qawolf/Diagnose-the-cause-of-a-failing-flow-2c65b2a994fb8034ae2bd0def1f8dfe5.md): Learn how to classify flow failures as flakes, bugs, or broken tests using the Investigation view.
- [Configure environments](https://docs.qawolf.com/qawolf/Environment-settings-2cd5b2a994fb8014ba8bd7aa25f3ed0f.md): Create and manage environments in QA Wolf with separate variables, concurrency settings, and VPN access.
- [How to integrate a mobile build with Fastlane](https://docs.qawolf.com/qawolf/Fastlane-2db5b2a994fb802186a3d88573899c78.md): Use the QA Wolf Fastlane plugin to upload mobile build artifacts and trigger test runs from existing lanes.
- [Full Service FAQ](https://docs.qawolf.com/qawolf/Full-Service-FAQs-29c5b2a994fb8000b442fa8aed05c9e5.md): Answers to common questions about QA Wolf full service, including test ownership, coverage, and how the service works.
- [Onboarding to QA Wolf Full Service](https://docs.qawolf.com/qawolf/Full-Service-The-First-Three-Months-29c5b2a994fb81bb9e10e4182639f294.md): What to expect during QA Wolf full service onboarding, including timelines, meetings, and setup steps.
- [How to integrate GitHub/GitHub Actions](https://docs.qawolf.com/qawolf/GitHub-GitHub-Actions-2a15b2a994fb800699f6dc99584915d0.md): Connect QA Wolf to GitHub Actions to automatically trigger test runs when you deploy code from your repository.
- [How to integrate with GitLab](https://docs.qawolf.com/qawolf/GitLab-2a15b2a994fb805d9d14ff27726065ae.md): Connect QA Wolf to GitLab CI/CD to automatically trigger test runs when you deploy code from your repository.
- [Glossary](https://docs.qawolf.com/qawolf/Glossary-29c5b2a994fb806d93f2ce4554a2fcfc.md): Definitions of key QA Wolf terms including workspaces, environments, groups, flows, runs, and maps.
- [How to integrate a mobile build with GitHub Actions](https://docs.qawolf.com/qawolf/Integrate-a-mobile-build-with-GitHub-Actions-2db5b2a994fb8027a901d4238b02fb8f.md): Upload mobile build artifacts and trigger QA Wolf test runs using prebuilt GitHub Actions in your workflow.
- [Integrating with Microsoft Teams](https://docs.qawolf.com/qawolf/Integrate-with-Microsoft-Teams-2b25b2a994fb8051bd2ee9d018a93aae.md): Set up Microsoft Teams to receive QA Wolf notifications by configuring external access and shared channels.
- [How to integrate a non-native bug tracker with webhooks](https://docs.qawolf.com/qawolf/Integrate-with-webhooks-29c5b2a994fb818d9682eb32ff11feff.md): If we don't support your bug tracker through a native integration, you can still use webhooks to integrate.
- [Integrating your CI pipeline for mobile app testing](https://docs.qawolf.com/qawolf/Integrate-your-mobile-CI-pipeline-2da5b2a994fb8037bb15e410d7366fd2.md): Choose an upload method and configure your CI pipeline to send mobile builds to QA Wolf for automated testing.
- [Reviewing run results](https://docs.qawolf.com/qawolf/Interpret-run-results-2d55b2a994fb80199754e4b2d3ce0318.md): Navigate the Runs tab to review pass rates, failure counts, bug reports, and maintenance status for each run.
- [How to integrate with Jira](https://docs.qawolf.com/qawolf/Jira-29c5b2a994fb81d18a87f23808479de0.md): Connect QA Wolf to Jira to automatically create, sync, and close issue tickets from QA Wolf bug reports.
- [How to integrate with Linear](https://docs.qawolf.com/qawolf/Linear-29c5b2a994fb81ce85ded6d005d5e7ab.md): Connect QA Wolf to Linear to automatically create and sync bug report issues with your Linear team.
- [File, review & edit bug reports](https://docs.qawolf.com/qawolf/Manage-bug-reports-2c75b2a994fb80308ddcc7cc60703c2f.md): Create, review, and resolve bug reports in QA Wolf to track confirmed product defects linked to failing flows.
- [Managing maintenance reports](https://docs.qawolf.com/qawolf/Manage-maintenance-reports-2d55b2a994fb80728909f48b1023f7fa.md): File maintenance reports to quarantine failing flows caused by test issues, and resume them after fixes are applied.
- [Create a product map](https://docs.qawolf.com/qawolf/Map-your-app-s-workflows-2a45b2a994fb80ca8a87c8fdc2a443fc.md): Use the AI mapping agent to build and maintain a structured coverage map of your application's user journeys.
- [How to integrate a mobile build with the QA Wolf SDK](https://docs.qawolf.com/qawolf/Mobile-build-with-the-QA-Wolf-SDK-2db5b2a994fb80cdbd1ec31513f2cc15.md): Upload mobile build artifacts and trigger test runs from any CI system using the QA Wolf CI SDK.
- [OpenVPN integration](https://docs.qawolf.com/qawolf/OpenVPN-integration-29f5b2a994fb80e8b2e4cea94fa15bf2.md): Configure an OpenVPN connection so QA Wolf can access your application behind a private network.
- [Ordering flows](https://docs.qawolf.com/qawolf/Ordering-flows-29c5b2a994fb80789f3fea32feae8f92-copied-1.md): Use Run Rules to control the order that dependent flows run in.
- [How to enable PR testing for GitHub Integrations](https://docs.qawolf.com/qawolf/PR-testing-for-GitHub-Integrations-2db5b2a994fb80a0aa94f3297d1f60c3.md): Run QA Wolf tests against preview environments on pull requests and report results as GitHub status checks.
- [How to enable PR testing for GitLab Integrations](https://docs.qawolf.com/qawolf/PR-testing-for-GitLab-Integrations-2db5b2a994fb8075b13dd9d5c2e6be8c.md): Run QA Wolf tests against preview environments on merge requests and report results back to GitLab.
- [Passing data between flows](https://docs.qawolf.com/qawolf/Pass-data-between-flows-29d5b2a994fb801080bce743ab552931.md): Share data between flows using Hopper Flows to coordinate multi-user, multi-device test scenarios in a single run.
- [QA Wolf's static IPv4](https://docs.qawolf.com/qawolf/QA-Wolf-s-static-IPv4-29c5b2a994fb81bf8487d085abf9dc4d.md): QA Wolf's static IPv4 range for firewall allowlisting and IP-restricted access to your application.
- [How to integrate with Qase.io](https://docs.qawolf.com/qawolf/Qase-io-29c5b2a994fb812fb3bfcf8ee3f33a16.md): Sync QA Wolf automated test results to your Qase.io project, including pass/fail status and run metadata.
- [Recommended reading for business users and manual testers](https://docs.qawolf.com/qawolf/Recommended-reading-for-QA-engineers-and-developers-2cd5b2a994fb80768272e9f973188fe8.md): Recommended courses on HTML, JavaScript, CSS, and Playwright to help you get more out of QA Wolf.
- [How to request new coverage](https://docs.qawolf.com/qawolf/Request-new-coverage-29c5b2a994fb81c79523f8ff2eefde47.md): Submit a coverage request to QA Wolf through the platform, Slack, Teams, Discord, or your issue tracker.
- [How Runs work](https://docs.qawolf.com/qawolf/Run-a-flow-or-suite-2a25b2a994fb8014b164d7ad2efd5ddel.md): Learn how QA Wolf executes runs, retries failed flows, and reports results as completed or needs investigation.
- [Scheduling flows](https://docs.qawolf.com/qawolf/Scheduling-flows-29c5b2a994fb80789f3fea32feae8f92.md): Create scheduled and event-based runs, choose which flows to include, and set the execution order.
- [Site-to-Site IPSec Tunnel](https://docs.qawolf.com/qawolf/Site-to-Site-IPSec-Tunnel-29f5b2a994fb80d7a45dd62f9b8a272a.md): Set up an IPSec site-to-site VPN tunnel between your network and QA Wolf using pre-shared key authentication.
- [Tailscale Client-based VPN](https://docs.qawolf.com/qawolf/Tailscale-Client-based-VPN-29f5b2a994fb8021a88af5e1c5b21313-copied-2.md): Connect QA Wolf to your private network through Tailscale by providing an access token or client configuration.
- [How to integrate with TestRail](https://docs.qawolf.com/qawolf/TestRail-29c5b2a994fb8158897afc10c5d66782.md): Sync QA Wolf automated test results to TestRail, including pass/fail status and run metadata for each test run.
- [How to integrate with Testmo](https://docs.qawolf.com/qawolf/Testmo-29c5b2a994fb810bb096c46ec45512fb.md): Sync QA Wolf automated test results to your Testmo project, including pass/fail status and run metadata.
- [Twingate Client-based VPN](https://docs.qawolf.com/qawolf/Twingate-Client-based-VPN-29f5b2a994fb8021a88af5e1c5b21313-copied-1.md): Connect QA Wolf to your private network through Twingate by providing an access token or client configuration.
- [Uploading files](https://docs.qawolf.com/qawolf/Uploading-manually.md): Manually upload files to QA Wolf using the signed URL API.
- [Test a feature that sends or receives emails](https://docs.qawolf.com/qawolf/Use-emails-in-tests-29c5b2a994fb81cf8a03de3eb25ed68e.md): Use the built-in getInbox function to send, receive, and verify emails during your QA Wolf test flows.
- [Use tags effectively](https://docs.qawolf.com/qawolf/Use-tags-effectively-2c35b2a994fb809abbd7ea9402738bdb.md): Apply tags to flows for scheduling purposes, such as grouping by test type, priority, or expected run duration.
- [How to use the Elements tab to pick a locator](https://docs.qawolf.com/qawolf/Use-the-Elements-picker-2c35b2a994fb80a681baca4f6acf3179.md): Inspect DOM elements and build stable locators for automated tests using the Elements tab in QA Wolf.
- [Welcome to QA Wolf](https://docs.qawolf.com/qawolf/Welcome-to-QA-Wolf.md): Create, run, and maintain end-to-end tests automatically with QA Wolf.
- [Configure workspace settings](https://docs.qawolf.com/qawolf/Workspace-settings-2d25b2a994fb807fbd9bece4eb1a4d5f.md): Invite members, manage roles, create tags, and configure workspace-level settings in QA Wolf.
- [How to integrate with Xray](https://docs.qawolf.com/qawolf/Xray-29c5b2a994fb8196a5eddfc6ce4a9e40.md): Sync QA Wolf automated test results to Xray Test Management for Jira, including test executions and metadata.
- [How to integrate with Zephyr](https://docs.qawolf.com/qawolf/Zephyr-29c5b2a994fb81ed97d9e214c8b177c6.md): Sync QA Wolf automated test results to Zephyr Test Management for Jira, including test cycles and metadata.
- [Measure accessibility for native mobile](https://docs.qawolf.com/qawolf/a11y-native.md): Use accessibility IDs to verify that key screens are reachable and usable by screen readers on iOS and Android.
- [Measure web accessibility with axe-core](https://docs.qawolf.com/qawolf/a11y-web.md): Inject axe-core into a Playwright page to catch WCAG violations and gate releases on accessibility quality.
- [Anatomy of a flow](https://docs.qawolf.com/qawolf/anatomy-of-a-qa-wolf-test-mobile-edition.md): Learn the structure of every QA Wolf flow — imports, the flow wrapper, launch styles, and the AAA framework.
- [Audio capture](https://docs.qawolf.com/qawolf/audio-capture.md): Record audio from the device speaker during a test and compare it against a reference file to verify playback.
- [Audio injection](https://docs.qawolf.com/qawolf/audio-injection.md): Inject audio into your app's microphone input to test audio features without real hardware.
- [Barcode and QR code scanning](https://docs.qawolf.com/qawolf/barcode-qrcode-scanning.md): Inject barcode and QR code data into any iOS app to test scanning workflows without a physical camera.
- [Camera injection](https://docs.qawolf.com/qawolf/camera-and-audio-injection.md): Inject images into your app's camera input to test camera features without real hardware.
- [FAQ](https://docs.qawolf.com/qawolf/faq.md): Frequently asked questions about using the QA Wolf platform for end-to-end test automation.
- [Client Reference](https://docs.qawolf.com/qawolf/libraries/emails/api-reference/client.md): Reference notes for runtime-facing client creation and configuration.
- [API Reference](https://docs.qawolf.com/qawolf/libraries/emails/api-reference/index.md): API landing page for @qawolf/emails.
- [Mail Reference](https://docs.qawolf.com/qawolf/libraries/emails/api-reference/mail.md): Reference notes for the flow-facing mail API.
- [Client Lifecycle](https://docs.qawolf.com/qawolf/libraries/emails/core-concepts/client-lifecycle.md): Understand how runners configure the emails client before a flow runs.
- [Inbox Model](https://docs.qawolf.com/qawolf/libraries/emails/core-concepts/inbox-model.md): Understand address selection and message waiting.
- [Get Started](https://docs.qawolf.com/qawolf/libraries/emails/get-started.md): Use QA Wolf inboxes to test email-driven workflows.
- [Runner Setup](https://docs.qawolf.com/qawolf/libraries/emails/how-to/configure-the-runtime-client.md): Configure the emails client in runners and local execution environments.
- [Unique Addresses](https://docs.qawolf.com/qawolf/libraries/emails/how-to/create-a-unique-address.md): Create unique inbox addresses for isolated test runs.
- [Get An Inbox](https://docs.qawolf.com/qawolf/libraries/emails/how-to/get-an-inbox.md): Create an inbox handle for receiving and sending test email.
- [Login Code Flow](https://docs.qawolf.com/qawolf/libraries/emails/how-to/login-code-flow.md): Read a login code from the email generated by the current test step.
- [Send A Message](https://docs.qawolf.com/qawolf/libraries/emails/how-to/send-a-message.md): Send email from a QA Wolf inbox handle.
- [Attachments](https://docs.qawolf.com/qawolf/libraries/emails/how-to/send-attachments.md): Send email with file attachments.
- [Wait For A Message](https://docs.qawolf.com/qawolf/libraries/emails/how-to/wait-for-a-message.md): Wait for the next email sent to a QA Wolf inbox.
- [Wait For Many Messages](https://docs.qawolf.com/qawolf/libraries/emails/how-to/wait-for-many-messages.md): Wait for a batch of emails sent to one QA Wolf inbox.
- [Emails Troubleshooting](https://docs.qawolf.com/qawolf/libraries/emails/troubleshooting.md): Common issues when using @qawolf/emails.
- [Android Reference](https://docs.qawolf.com/qawolf/libraries/flows/api-reference/android.md): Reference notes for @qawolf/flows/android.
- [CLI Reference](https://docs.qawolf.com/qawolf/libraries/flows/api-reference/cli.md): Reference notes for @qawolf/flows/cli.
- [API Reference](https://docs.qawolf.com/qawolf/libraries/flows/api-reference/index.md): API landing page for @qawolf/flows and its platform entry points.
- [iOS Reference](https://docs.qawolf.com/qawolf/libraries/flows/api-reference/ios.md): Reference notes for @qawolf/flows/ios.
- [Top-Level Reference](https://docs.qawolf.com/qawolf/libraries/flows/api-reference/top-level.md): Reference notes for the top-level @qawolf/flows entry point.
- [Web Reference](https://docs.qawolf.com/qawolf/libraries/flows/api-reference/web.md): Reference notes for @qawolf/flows/web.
- [Flow Model](https://docs.qawolf.com/qawolf/libraries/flows/core-concepts/flow-model.md): Understand the two flow startup styles and when to use each one.
- [Runtime And Launch](https://docs.qawolf.com/qawolf/libraries/flows/core-concepts/runtime-and-launch.md): Know which APIs only work while a flow is running.
- [Targets](https://docs.qawolf.com/qawolf/libraries/flows/core-concepts/targets.md): Use targets to choose the browser, device, or CLI environment.
- [Get Started](https://docs.qawolf.com/qawolf/libraries/flows/get-started.md): Write QA Wolf flows for web, mobile, and CLI targets.
- [Launch Electron](https://docs.qawolf.com/qawolf/libraries/flows/how-to/launch-electron.md): Launch an Electron app from a web flow.
- [Mobile App From Env](https://docs.qawolf.com/qawolf/libraries/flows/how-to/mobile-app-from-env.md): Launch a mobile build from runner-provided inputs or explicit environment variables.
- [Persistent Browser Context](https://docs.qawolf.com/qawolf/libraries/flows/how-to/persistent-browser-context.md): Launch a web flow with a reusable browser profile.
- [Write A CLI Flow](https://docs.qawolf.com/qawolf/libraries/flows/how-to/write-a-cli-flow.md): Create a flow that uses runner utilities without a browser or mobile driver.
- [Write A Web Flow](https://docs.qawolf.com/qawolf/libraries/flows/how-to/write-a-web-flow.md): Create a browser or Electron flow with @qawolf/flows/web.
- [Write An Android Flow](https://docs.qawolf.com/qawolf/libraries/flows/how-to/write-an-android-flow.md): Create an Android flow with Appium's WebdriverIO driver.
- [Write An iOS Flow](https://docs.qawolf.com/qawolf/libraries/flows/how-to/write-an-ios-flow.md): Create an iOS flow with Appium's WebdriverIO driver.
- [Flows Troubleshooting](https://docs.qawolf.com/qawolf/libraries/flows/troubleshooting.md): Common issues when authoring or running flows.
- [Client Reference](https://docs.qawolf.com/qawolf/libraries/testkit/api-reference/client.md): Reference notes for @qawolf/testkit/client.
- [Core Reference](https://docs.qawolf.com/qawolf/libraries/testkit/api-reference/core.md): Reference notes for the top-level @qawolf/testkit entry point.
- [API Reference](https://docs.qawolf.com/qawolf/libraries/testkit/api-reference/index.md): API landing page for @qawolf/testkit and related entry points.
- [Types Reference](https://docs.qawolf.com/qawolf/libraries/testkit/api-reference/types.md): Reference notes for the public types used by @qawolf/testkit.
- [Web Reference](https://docs.qawolf.com/qawolf/libraries/testkit/api-reference/web.md): Reference notes for @qawolf/testkit/web.
- [Client Model](https://docs.qawolf.com/qawolf/libraries/testkit/core-concepts/client-model.md): Know which helpers are pure and which need runner wiring.
- [Entry Points](https://docs.qawolf.com/qawolf/libraries/testkit/core-concepts/entry-points.md): Choose the right @qawolf/testkit import.
- [Get Started](https://docs.qawolf.com/qawolf/libraries/testkit/get-started.md): Use @qawolf/testkit helpers for OTPs, QR codes, screenshots, and network setup.
- [Configure A Runner Client](https://docs.qawolf.com/qawolf/libraries/testkit/how-to/configure-a-runner-client.md): Configure a testkit client in runners and local execution environments.
- [Generate An OTP](https://docs.qawolf.com/qawolf/libraries/testkit/how-to/generate-an-otp.md): Generate a one-time password from an otpauth URI.
- [Read QR Code](https://docs.qawolf.com/qawolf/libraries/testkit/how-to/read-a-qr-code.md): Decode a QR code from a page element.
- [Baseline Screenshot](https://docs.qawolf.com/qawolf/libraries/testkit/how-to/save-a-baseline-screenshot.md): Save a baseline screenshot through a configured testkit client.
- [VPN Setup](https://docs.qawolf.com/qawolf/libraries/testkit/how-to/use-network-helpers.md): Start VPN support from a flow through the configured testkit client.
- [Testkit Troubleshooting](https://docs.qawolf.com/qawolf/libraries/testkit/troubleshooting.md): Common issues when using @qawolf/testkit.
- [Network connectivity](https://docs.qawolf.com/qawolf/network-connectivity.md): Route iOS test device traffic through VPN tunnels to reach internal services, staging environments, or geo-restricted content.
- [Network simulation](https://docs.qawolf.com/qawolf/network-simulation.md): Simulate degraded network conditions on iOS devices to test how your app handles slow connections, high latency, or no connectivity.
- [Non-Deterministic AI Testing](https://docs.qawolf.com/qawolf/non-deterministic-ai-testing.md): Validate AI-generated responses using a judge model and assert on a structured JSON verdict.
- [iOS photo library management](https://docs.qawolf.com/qawolf/photo-library-management.md): Add, list, and delete photos in the device photo library to set up test state or verify your app saved photos.
- [Quick Start](https://docs.qawolf.com/qawolf/quick-start.md): Connect your application, generate your first flow, and run your first tests with QA Wolf.
- [Selecting a Device](https://docs.qawolf.com/qawolf/select-a-target-device-and-os.md): Choose which device, OS, and browser your flow runs on using the target option.
- [Solutions](https://docs.qawolf.com/qawolf/solutions.md): Recipes and helpers for testing specific scenarios in your app.
- [Configure Single Sign-On (SSO)](https://docs.qawolf.com/qawolf/sso.md): Set up SSO to authenticate with QA Wolf using your identity provider, such as Okta, OneLogin, or Entra ID.
- [Video injection](https://docs.qawolf.com/qawolf/video-injection.md): Inject video into your app's camera input to test video features without real hardware.
- [Assert visual appearance](https://docs.qawolf.com/qawolf/visual-diffing.md): Use toHaveScreenshot to catch layout regressions and verify UI elements that can't be targeted with selectors.
- [Measure web performance with Lighthouse](https://docs.qawolf.com/qawolf/web-performance.md): Run a Lighthouse audit in a QA Wolf flow to spot-check Core Web Vitals and key performance metrics.