# 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.
- [Overview](https://docs.qawolf.com/qawolf/CI-CD-Overview.md): QA Wolf integrates with your CI pipeline to run tests automatically. Choose the outcome that matches your use case.
- [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.
- [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 with Microsoft Teams](https://docs.qawolf.com/qawolf/Integrating-with-microsoft-teams.md): Set up Microsoft Teams to receive QA Wolf notifications by configuring external access and shared channels.
- [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.
- [Pass data between flows](https://docs.qawolf.com/qawolf/Pass-data-between-flows-29d5b2a994fb801080bce743ab552931.md): Share authentication tokens, user IDs, and other values across flows in a coordinated 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.
- [Prepare your environments for testing](https://docs.qawolf.com/qawolf/Test-environments-2dc5b2a994fb800e8ce4fe36ee34764a.md): The guidance below focuses on keeping your environment predictable, scalable, and ready for concurrent automated testing.
- [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.
- [Upload 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 mail.inbox() from @qawolf/emails to send, receive, and verify emails during your QA Wolf 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, callback parameters, 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.
- [Connect to a VPN (web)](https://docs.qawolf.com/qawolf/connect-with-vpn-web.md): Start an OpenVPN tunnel from a web flow to reach internal services or staging environments.
- [Testing Electron apps](https://docs.qawolf.com/qawolf/electron.md): Test a desktop app built with Electron from a QA Wolf flow.
- [FAQ](https://docs.qawolf.com/qawolf/faq.md): Frequently asked questions about using the QA Wolf platform for end-to-end test automation.
- [Get the most out of Automate](https://docs.qawolf.com/qawolf/getting-the-most-out-of-automate.md): Tips for writing better prompts and working more effectively with Automate.
- [Getting good results with Mapping](https://docs.qawolf.com/qawolf/getting-the-most-out-of-mapping.md): Tips for getting more accurate, complete test outlines from Mapping.
- [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.
- [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.
- [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.
- [Testkit Troubleshooting](https://docs.qawolf.com/qawolf/libraries/testkit/troubleshooting.md): Common issues when using @qawolf/testkit.
- [Use your network drive](https://docs.qawolf.com/qawolf/mount-a-file-share.md): Mount your CIFS/SMB file share onto the runner so your flow can read and write files during a test run.
- [Connect to a VPN (iOS)](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 (iOS)](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.
- [Test QR code authentication](https://docs.qawolf.com/qawolf/qrcode.md): Read a QR code from the page and use its value to complete authentication.
- [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.
- [Reuse state between runs](https://docs.qawolf.com/qawolf/reuse-state-between-runs.md): Use environment variables to carry state from one run into the next, so flows can skip work they've already done.
- [Share logic across flows](https://docs.qawolf.com/qawolf/sharing-code-across-flows.md): Use helper functions and platform-specific entry points to keep flows linear and share logic across platforms.
- [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.
- [Test MFA with an authenticator app](https://docs.qawolf.com/qawolf/test-mfa.md): Generate a time-based OTP code in your flow to complete multi-factor authentication.
- [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.