> ## Documentation Index
> Fetch the complete documentation index at: https://docs.percio.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Sign up, run your first test, and read the report — in about 5 minutes

This walks you through your first Percio test using the web app. If you'd rather test `localhost` or wire Percio into Cursor, jump to the [Agent overview](/agent/overview).

## 1. Create an account

Head to [percio.app](https://percio.app) and sign up with email or Google. Email sign-ups are confirmed via a link sent to your inbox — click it to finish creating your account.

If you're picking the **Indie** plan, you'll start a 14-day trial (credit card required). **Pro** has no trial. See [Plans](/billing/plans) for the full comparison.

## 2. Create your first persona

On first sign-in, Percio opens an onboarding wizard that generates a persona tailored to the product you're building. Answer a few questions about your users and you'll end up with a persona ready to run tests against.

You can create more personas later on the **Personas** page. See [Creating personas](/personas/creating-personas) for the field-by-field walkthrough.

## 3. Start a test

Go to **Tests** and paste the URL you want to test. Percio will:

1. **Fetch context from the page** so it knows what it's looking at.
2. **Ask a few quick questions** about what you want to test — what the user should try to do, what success looks like, any constraints.
3. **Generate a scenario** from that conversation.
4. **Let you pick a persona** to run the test through.

When you hit **Run Test**, Percio launches a real browser on our servers and starts working.

<Tip>
  The quality of your scenario drives the quality of your report. See [Writing good scenarios](/tests/writing-scenarios) for the one-page guide that pays for itself.
</Tip>

## 4. Watch the test run

You'll be taken to the live execution page. While the test runs, you can watch:

* The **progress ring** showing how far along the agent thinks it is.
* The **step timeline** — each action the browser takes (click, type, scroll, navigate, wait).
* The **AI reasoning panel** — what the agent is thinking before each action, so you can see why it made every move.

Most tests finish in 1–3 minutes depending on the flow.

## 5. Read your report

When the run finishes, Percio drops you on the results page. You'll see:

* A **usability score** from 0–100.
* An **executive summary** with the biggest risk, drop-off patterns, and quick wins.
* **Issues**, each with severity, the Nielsen heuristic it violates, and a four-part breakdown: *What's happening*, *Why it matters*, *Who it affects most*, *Recommendation*.
* **Positive notes** — things the persona liked.
* A **flow timeline** with every step the browser took, screenshot by screenshot.

For each issue, you can mark it **Confirmed**, **False positive**, or **Dismissed** to keep your findings clean.

## What's next

<Columns cols={2}>
  <Card title="Write better scenarios" icon="pen-fancy" href="/tests/writing-scenarios">
    The single biggest lever for test quality.
  </Card>

  <Card title="Pick the right persona" icon="users" href="/personas/strategy">
    Which persona to use for a test and what makes a persona signal-rich.
  </Card>

  <Card title="Read results deeply" icon="chart-line" href="/results/overview">
    The full anatomy of the results page.
  </Card>

  <Card title="Test localhost" icon="terminal" href="/agent/install">
    Install the CLI and test unshipped work before it goes live.
  </Card>
</Columns>