# Documentation

URL: https://testmode.ai/docs/

> Guides, reference and troubleshooting for Testmode: set up a project, write tests in plain English, run them and read the results.

Testmode is an AI testing tool for web apps. You describe a test in plain English, and Testmode runs it in a real browser, with no test scripts and no changes to your code.

Tests run in a cloud browser, so the app you test must be reachable from the public internet. Testmode tests web apps only, not native mobile apps, desktop apps or APIs.

[Screenshot: Testmode Overview for the Toolshop project, with the pass rate ring, the weekly chart and recent passed and failed runs. Caption: The Overview page of a project: its pass rate, runs over the week and the latest results.]

## How it works

<div class="tm-grid-3">

**You describe**

Write a test case as plain-English steps and an **Expected Outcome**. For example: search the Toolshop for `hammer`, and expect every result to be a hammer.

**Testmode runs**

Testmode opens your environment in a fresh cloud browser, logs in first when the test has a login credential, and works through your test.

**You read the verdict**

Each test ends `Passed` or `Failed`, with a written summary and a screenshot after every browser action the agent took.

</div>

## Start here

New to Testmode? The quickstart takes you from sign-up to your first result on a public practice shop, so you don't need your own app yet: create your account and first project, write a test case in plain English, then run it and read the result.

- [Quickstart: run your first Testmode test](https://testmode.ai/docs/quickstart/): One guided path from sign-up to a first result.
- [What you can do with Testmode](https://testmode.ai/docs/capabilities/): Plain-English tests, automatic login, evidence, schedules, Explore and the Assistant.
- [What Testmode can and cannot test](https://testmode.ai/docs/what-testmode-can-test/): A candid fit check: reachable URLs, login, CAPTCHA, iframes and more.
- [A tour of the Testmode app](https://testmode.ai/docs/product-tour/): The sidebar, project switcher, Overview and command palette.

## Browse by area

- [Concepts](https://testmode.ai/docs/how-testmode-runs-a-test/): How a test runs, how organizations and projects fit together, and what Testmode records.
- [Account and team](https://testmode.ai/docs/manage-your-organization/): Sign in, invite people and understand the four roles.
- [Project setup](https://testmode.ai/docs/environments/): Environments, login credentials and variables.
- [Test cases](https://testmode.ai/docs/write-a-test-case/): Write steps and an Expected Outcome that the agent can follow.
- [Test plans and schedules](https://testmode.ai/docs/test-plans/): Group test cases, run them on a schedule and email the results.
- [Runs and results](https://testmode.ai/docs/read-run-results/): Start runs, then read verdicts, screenshots and browser logs.
- [Explore](https://testmode.ai/docs/start-an-exploration/): Let the exploratory agent visit your app and propose tests.
- [Credits and billing](https://testmode.ai/docs/how-credits-work/): What a run costs and how your organization's balance works.

## Popular tasks

- [Write effective steps](https://testmode.ai/docs/writing-effective-steps/): Wording the agent follows reliably, with before-and-after examples.
- [Run tests](https://testmode.ai/docs/run-tests/): Choose an environment and run one test, a plan or every enabled test case.
- [Schedule test plans](https://testmode.ai/docs/schedule-test-plans/): Run a plan hourly, daily, weekly or monthly.
- [Understand run and test statuses](https://testmode.ai/docs/run-and-test-statuses/): What Queued, Running, Passed, Failed and Skipped mean, and why a test waits.
- [Log in automatically](https://testmode.ai/docs/credentials-and-automatic-login/): Store a test login once and reuse it across tests.
- [Use keyboard shortcuts](https://testmode.ai/docs/keyboard-shortcuts/): Open the command palette, start a run and move between pages.

## Explore and the Assistant

- [Review exploration proposals](https://testmode.ai/docs/review-and-apply-proposals/): Accept, edit or reject the changes the exploratory agent proposes, then apply them.
- [Create tests with the Assistant](https://testmode.ai/docs/create-tests-with-the-assistant/): Describe a test in a chat, confirm it, and the Assistant creates it.

## Reference and help

- [Troubleshoot failed tests](https://testmode.ai/docs/troubleshoot-failed-tests/): Work out why a test failed and what to change.
- [Limits and defaults](https://testmode.ai/docs/limits/): Time limits, credential sessions, schedules, list sizes and Assistant limits.
- [Glossary](https://testmode.ai/docs/glossary/): The terms used across Testmode and these docs.
- [FAQ](https://testmode.ai/docs/faq/): Answers to common questions about using Testmode.