# Spur Documentation

> Spur is an AI-powered QA engineer. Create, run, and analyze automated end-to-end tests for web and mobile apps using natural language.

> ## Agent Instructions
> Spur is an AI-powered QA engineer that lets teams create and run automated end-to-end tests for web and mobile apps using natural language.
> When answering questions about Spur, cite the relevant page from docs.spurtest.com.

- [Welcome to Spur!](https://docs.spurtest.com/getting-started/introduction.md): Your AI-powered QA Engineer - Create and run automated tests using natural language.
- [Write your first test](https://docs.spurtest.com/getting-started/first-test.md): Create your first Spur test in minutes by generating steps from a video or Loom link, writing them manually, or importing an existing automation script.
- [Web Prompting Guide](https://docs.spurtest.com/getting-started/web-prompting.md): Write clear, reliable test instructions for web applications that produce consistent results.
- [Mobile Prompting Guide](https://docs.spurtest.com/getting-started/mobile-prompting.md): Write clear, reliable natural-language steps for Spur to run on an iOS Simulator or Android Emulator.
- [Overview of Prompt Library](https://docs.spurtest.com/getting-started/prompt-library.md): A collection of effective prompt patterns and examples for different testing scenarios
- [High-Level Instructions](https://docs.spurtest.com/getting-started/prompt-library/high-level-instructions.md): User-focused test prompts where you describe the goal and let the agent determine the steps
- [Persona Based Tests](https://docs.spurtest.com/getting-started/prompt-library/persona-based-tests.md): Give the agent a persona to uncover user-specific experiences and accessibility issues
- [Exploratory Tests](https://docs.spurtest.com/getting-started/prompt-library/exploratory-tests.md): Let the agent freely explore your site to discover edge cases and unexpected behaviours
- [Other Useful Prompts](https://docs.spurtest.com/getting-started/prompt-library/other-useful-prompts.md): Additional prompt patterns for specialised testing scenarios like chatbot interactions
- [Common Pitfalls When Writing Tests in Spur](https://docs.spurtest.com/getting-started/common-pitfalls.md): Avoid these common authoring mistakes to ensure your tests run reliably and clearly communicate intent.
- [Frequently Asked Questions](https://docs.spurtest.com/getting-started/FAQ.md): Answers to common questions about Spur, including handling auth states, debugging tests, editing tests, and managing test runs.
- [Video to Test Generation](https://docs.spurtest.com/authoring-tests/test-side-peek/video-to-test.md): Import existing Playwright, Selenium or other automation scripts and transform them into Spur test steps that can be executed with the Spur Agent. For imports beyond Playwright and Selenium, reach out to your dedicated CSM for assistance.
- [Script to Test Generation](https://docs.spurtest.com/authoring-tests/test-side-peek/script-to-test.md): Import existing Playwright, Selenium or other automation scripts and transform them into Spur test steps that can be executed with the Spur Agent.
- [Viewports & device settings](https://docs.spurtest.com/authoring-tests/test-side-peek/viewports.md): Configure viewport dimensions, browser settings, and native device options in Spur so tests run at the screen sizes and platforms your customers actually use.
- [Verification](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/verify.md): Verify actions check that elements appear correctly and content matches expectations.
- [Full Page Analysis](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/full-page-analysis.md): Check a whole web page, top to bottom, in one step: its text, its visuals, or both.
- [Open New Tab](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/browser/open-new-tab.md): Open a URL in a new browser tab while keeping the current page active
- [Redirect](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/browser/redirect.md): Change the URL of the current page to navigate to a different URL
- [Refresh](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/browser/refresh.md): Reload the current page to refresh its content
- [Go Back](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/browser/go-back.md): Navigate back to the previous page in the browser history
- [Close the Current Tab](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/browser/close-tab.md): Close a tab that was opened through a browser action
- [Email](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/email/email-inbox.md): This allows you to test email-based workflows like sign-up flows or email verifications inside your test steps.
- [Extractions](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/extract.md): Guide to extracting and reusing data in Spur tests
- [Javascript](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/javascript.md): Run custom JavaScript during a test step to handle complex interactions, manipulate data, and perform custom validations beyond the standard actions.
- [Make an API Call](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/api-call.md): Add an API Call step in Spur to hit a backend HTTP endpoint for state setup, response assertions, or extracting values like auth tokens for reuse in later steps
- [Log Step](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/log/log-assertions.md): Use Log steps to assert against network requests and console logs during test execution.
- [Overview of Supported Actions](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/actions/actions-overview.md): All available discrete actions you can use in your test steps.
- [Click](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/actions/click.md): Simulate click interactions on elements across your application.
- [Hover](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/actions/hover.md): Simulate mouse hover interactions for dropdown menus, tooltips, and other interactive elements.
- [Scroll](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/actions/scroll.md): Learn how to use scroll actions in Spur
- [Select](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/actions/select.md): Choose options from system and custom dropdowns.
- [Wait](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/actions/wait.md): Pause test execution to allow for page loads, animations, or processing.
- [Type](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/actions/type.md): Enter text into input fields, search boxes, and other text elements.
- [Advanced Mobile Prompting](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/mobile/overview.md): Specialized commands for mobile (iOS & Android) tests — app lifecycle, device gestures, and toast assertions
- [Activate App](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/mobile/activate-app.md): Bring the app under test back to the foreground
- [Restart App](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/mobile/restart-app.md): Terminate and cold-relaunch the app under test, or launch a different app
- [Shake Device](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/mobile/shake-device.md): Simulate a physical device shake gesture (Android only)
- [Flip Device](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/mobile/flip.md): Emulate flipping the device face-up to face-down (Android emulators)
- [Expect Toast / Expect No Toast](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/mobile/expect-toast.md): Assert that a transient toast message did, or did not, appear
- [Encrypted Variables](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/variables/encrypted-variables.md): How to securely store and use sensitive data like passwords in your tests
- [Random String Generation](https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/variables/random-string-gen.md): Spur allows you to generate random alphabetical or numeric strings, which are stored in the test context
- [Advanced Configurations](https://docs.spurtest.com/authoring-tests/test-side-peek/advanced-configurations.md): Change your browser's locale, network speed and HTTPS credentials to test your application under different conditions.
- [Login States](https://docs.spurtest.com/authoring-tests/test-side-peek/login-states.md): Manage authentication across your tests efficiently by reusing login sessions and avoiding redundant authentication steps.
- [Upload Files](https://docs.spurtest.com/authoring-tests/test-side-peek/upload-files.md): Learn how to upload files for testing file upload features in your application.
- [AI Test Generation](https://docs.spurtest.com/authoring-tests/ai-test-generation.md): Spur's AI Test Generation accelerates test creation by automatically generating step-by-step tests or data-driven scenario tables from multiple input sources while transforming hours of manual test authoring into minutes of guided AI assistance.
- [Mobile Streaming](https://docs.spurtest.com/authoring-tests/mobile-streaming.md): Open a live, interactive mobile session in your browser to explore your app, reproduce issues, and try out steps before writing a test.
- [Preview Editor](https://docs.spurtest.com/authoring-tests/preview-editor.md): The Preview Editor provides an interactive test authoring environment where you can write, execute and debug test steps in real-time.
- [Dependencies](https://docs.spurtest.com/authoring-tests/dependencies.md): Test dependencies in Spur allow you to define relationships between tests and control their execution order.
- [Scenario Tables](https://docs.spurtest.com/authoring-tests/scenarios/scenario-tables.md): Parameterize Spur tests with reusable scenario tables so one test runs across multiple data rows instead of duplicating nearly identical test cases.
- [Reference scenario table properties in test steps](https://docs.spurtest.com/authoring-tests/scenarios/scenarios.md): Insert scenario table properties into Spur test steps with the `[` shortcut to build data-driven tests that iterate through every row automatically.
- [Overview of Environments](https://docs.spurtest.com/authoring-tests/environments/environments.md): Run tests across multiple environments with environment-specific configurations for comprehensive application validation.
- [Properties](https://docs.spurtest.com/authoring-tests/environments/properties.md): Environment-specific variables that store configuration values like URLs, credentials, API keys, and custom settings. Properties enable tests to adapt automatically based on the environment they're running in.
- [Web Link vs Domain](https://docs.spurtest.com/documentation/authoring-tests/environments/web-link-vs-domain.md): When configuring Web URLs in your environments, you can choose between two types: Domain and Web Link. Understanding the difference helps you organize tests efficiently and maintain flexibility across your testing workflow.
- [Caching Tests](https://docs.spurtest.com/authoring-tests/caching-tests.md): Cache test results for faster subsequent test runs and improved execution efficiency.
- [Managing Overview](https://docs.spurtest.com/managing-tests/overview.md): Understand how tests are organized in Spur and the tools available to manage them.
- [Test suites: group and run related tests together](https://docs.spurtest.com/managing-tests/suite.md): Group related Spur tests into a test suite to organize by feature, user journey, or environment, then run and manage them together against any target env.
- [Folders](https://docs.spurtest.com/managing-tests/folders.md): Folders helps you organize test suites by feature, project, or team. You can also perform bulk actions on multiple suites within a folder for efficient test management.
- [Test plans: coordinate multi-suite runs](https://docs.spurtest.com/managing-tests/test-plans/test-plans.md): Bundle Spur test suites into a test plan to run them in parallel across environments, browsers, and viewports using each suite's saved configuration.
- [Create Test Plan](https://docs.spurtest.com/documentation/managing-tests/test-plans/create-test-plan.md): Step-by-step guide to creating a Test Plan in Spur to run coordinated test suites across multiple environments and browsers from one place.
- [Drafts](https://docs.spurtest.com/managing-tests/drafts.md): Use drafts to build and refine tests that aren't ready for active test runs yet.
- [Snooze Tests](https://docs.spurtest.com/managing-tests/snooze-tests.md): Snoozing temporarily pauses test execution for a specified duration. This is useful when deploying new features, performing maintenance, or addressing known issues without cluttering your test results.
- [Manual Runs](https://docs.spurtest.com/running-tests/run-modal/run-modal.md): Launch a Spur test run on demand from the run modal, picking environments, browsers, viewports, platforms, and scenarios that multiply into parallel executions.
- [Run test plans on demand or on a schedule](https://docs.spurtest.com/running-tests/test-plans.md): Run Spur test plans on demand or on a schedule with saved environment and browser configurations, email alert notifications, and automatic retries on failure.
- [CI/CD](https://docs.spurtest.com/running-tests/CICD.md): Automatically run your Spur test plans on every pull request and block deployments when tests fail.
- [GitHub](https://docs.spurtest.com/running-tests/cicd/github.md): Wire Spur test plans into GitHub Actions to run automatically on every pull request, report pass/fail status inline, and block merges when tests fail.
- [GitHub Agent](https://docs.spurtest.com/running-tests/cicd/github-agent.md): Install the Spur GitHub App to auto-generate change-aware browser tests from every pull request diff and trigger relevant saved tests for regression coverage.
- [GitLab](https://docs.spurtest.com/running-tests/cicd/gitlab.md): Run Spur test plans automatically on every GitLab merge request and block deployments when tests fail.
- [Override URLs](https://docs.spurtest.com/running-tests/cicd/override-urls.md): Redirect tests to a different URL at runtime without changing your environment configuration.
- [Scheduled Tests](https://docs.spurtest.com/running-tests/scheduler.md): Run your test plans automatically at set intervals — no manual triggering required.
- [Snoozing Tests](https://docs.spurtest.com/running-tests/snoozing-tests/snooze-tests.md): Understand how snoozing a test affects scheduled runs, test plans, and manual execution.
- [Analysis Overview](https://docs.spurtest.com/analysing-tests/analysis-overview.md): Understand where to find your test results and what you can do with them.
- [Spur MCP Integration](https://docs.spurtest.com/analysing-tests/mcp/spur-mcp.md): Give your AI assistant access to Spur through the Model Context Protocol to run tests, analyze results, and debug failures without leaving your editor.
- [MCP Setup](https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-setup.md): Connect the Spur MCP server to Codex, Cursor, Claude, VS Code, ChatGPT, Gemini CLI, Windsurf, Zed, or another MCP client.
- [Discover and Run Tests](https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-discover-tests.md): Use your AI assistant to explore what tests are available in Spur and run them without leaving your editor.
- [Fix Raised Bugs](https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-fix-bugs.md): Use your AI assistant to pull failure details from Spur and resolve bugs directly in your code.
- [Connecting with Other MCP Tools](https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-connecting-other-mcps.md): Combine the Spur MCP with GitHub, Jira, Linear, and other tools to give your AI assistant richer context for testing.
- [In-Sprint Test Generation](https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-in-sprint-testing.md): Use Claude Code and the Spur MCP to generate, run, and iterate on tests directly from pull requests and tickets — without leaving your editor.
- [Triaging Test Plan Failures with MCP](https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-test-plans.md): Use the Spur MCP to run test plans, review every failure, and drill into root causes — without leaving your editor.
- [Spur AI](https://docs.spurtest.com/analysing-tests/spur-ai-chat.md): Chat with Spur's built-in AI assistant to analyze runs, triage failures, and manage your testing workflow in natural language — without leaving the app.
- [Using Spur AI Effectively](https://docs.spurtest.com/analysing-tests/spur-ai-chat-best-practices.md): Scope each conversation to one topic to keep Spur AI's answers sharp and your usage efficient.
- [Shareable Links](https://docs.spurtest.com/analysing-tests/shareable-links.md): Send a full Spur test result — steps, failure reasons, video replay, console logs, and network logs — to anyone via a shareable link with no login required.
- [Integrations Overview](https://docs.spurtest.com/analysing-tests/integrations/integrations.md): Setup instructions of integrations, and a list of all currently available integrations.
- [Jira Tickets](https://docs.spurtest.com/analysing-tests/integrations/jira.md): Connect Spur with Jira to file bug tickets from failed test runs, sync ticket status back to Spur, and set project, priority, and assignee defaults.
- [Linear Tickets](https://docs.spurtest.com/analysing-tests/integrations/linear.md): Connect Spur with Linear for streamlined issue tracking and automated bug reporting.
- [Azure DevOps Work Items](https://docs.spurtest.com/analysing-tests/integrations/azure-devops.md): Connect Azure DevOps to file work items from test results, set project and field defaults, and read work items in Spur AI.
- [Slack Alerts](https://docs.spurtest.com/analysing-tests/integrations/slack.md): Connect Spur with Slack for real-time test result notifications in your workspace.
- [Email Alerts](https://docs.spurtest.com/analysing-tests/integrations/email.md): Configure email notifications for test results and alerts.
- [GitHub Integration](https://docs.spurtest.com/analysing-tests/integrations/github.md): Connect Spur with GitHub for automated testing on pull requests.
- [GitLab Integration](https://docs.spurtest.com/analysing-tests/integrations/gitlab.md): Connect Spur with GitLab for automated testing on merge requests.
- [Test plan review](https://docs.spurtest.com/analysing-tests/test-plan-review.md): Walk through every failure, warning, and error in a test plan run in Spur, triage each result, group by cause, and rerun failing tests without leaving the page.
- [Test Overview Page](https://docs.spurtest.com/analysing-tests/test-overview-page.md): Monitor and manage your test suite health with a centralized dashboard.
- [Warning Suppression](https://docs.spurtest.com/analysing-tests/warning-suppression.md): Silence known warnings so they stop cluttering test results.
- [Spur for Data Science Teams](https://docs.spurtest.com/additional-resources/spur-for-data-science-teams.md): Automate analytics event validation, tracking QA, and data quality monitoring — without writing code or inspecting DevTools manually.
- [Network & Console Monitoring](https://docs.spurtest.com/additional-resources/network-console-monitoring.md): Use Log steps to assert against network requests and console logs during test execution.
- [IP Whitelisting](https://docs.spurtest.com/additional-resources/ip-whitelisting.md): Allow Spur agent to access your application by whitelisting our IP addresses.
- [User Roles](https://docs.spurtest.com/additional-resources/user-roles.md): Understand the difference between admin and member roles, and how admins manage your team in Spur.
- [Deep Links](https://docs.spurtest.com/additional-resources/deep-links.md): Use deep links in Spur to navigate directly to specific screens in your mobile app during testing.
- [In-Sprint Test Generation](https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-in-sprint-testing.md): Use Claude Code and the Spur MCP to generate, run, and iterate on tests directly from pull requests and tickets — without leaving your editor.
- [GitHub Agent](https://docs.spurtest.com/running-tests/cicd/github-agent.md): Install the Spur GitHub App to auto-generate change-aware browser tests from every pull request diff and trigger relevant saved tests for regression coverage.
- [Google SSO](https://docs.spurtest.com/additional-resources/sso-providers/google-sso.md)
- [Azure SSO](https://docs.spurtest.com/additional-resources/sso-providers/azure-sso.md)
- [Contact Us](https://docs.spurtest.com/additional-resources/contact-us.md): Get in touch with the Spur team for support, questions, or feedback.
- [Changelog](https://docs.spurtest.com/changelog/introduction.md): Release notes for Spur: new features, integrations, AI capabilities, and improvements to test authoring, execution, and analysis, updated regularly.

## Optional

- [Press](https://www.ycombinator.com/launches/LeX-spur-your-ai-qa-engineerr)
- [Community](https://www.linkedin.com/company/spur-test/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.