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

# Quick Start - Test Your Lovable, Replit, V0, or Base44 App

> Find bugs in your Lovable, Replit, V0, or Base44 app in under 5 minutes. No setup required. Perfect for solo founders, vibe coders, and side projects.

## Two ways to start

Scout offers two paths to get quality feedback fast—pick the one that fits your workflow.

<CardGroup cols={2}>
  <Card title="Instant URL" icon="bolt" href="#option-1-instant-url-30-seconds">
    Transform your app URL and get results immediately. Zero setup.
  </Card>

  <Card title="Full Dashboard" icon="grid-2" href="#option-2-full-dashboard-5-minutes">
    Create a project for ongoing coverage, history, and team collaboration.
  </Card>
</CardGroup>

***

## Option 1: Instant URL (30 seconds)

The fastest way to see Scout in action. Perfect for quick checks during development.

<Steps>
  <Step title="Find your app URL">
    Locate your deployed application URL (works with Lovable, Replit, and more).
  </Step>

  <Step title="Transform the URL">
    Insert `.scoutqa` before `.app` in your domain:

    | Platform | Original URL        | Scout URL                   |
    | -------- | ------------------- | --------------------------- |
    | Lovable  | `myapp.lovable.app` | `myapp.lovable.scoutqa.app` |
    | Replit   | `myapp.replit.app`  | `myapp.replit.scoutqa.app`  |
  </Step>

  <Step title="Visit and explore">
    Open the Scout URL in your browser. Scout automatically begins exploring and reports findings within minutes.
  </Step>
</Steps>

<Tip>
  Bookmark your Scout URL for one-click quality checks anytime you push changes.
</Tip>

***

## Option 2: Full Dashboard (5 minutes)

Create a project to track explorations over time, collaborate with your team, and configure custom personas.

### Step 1: Sign in

<Frame>
  <img src="https://mintcdn.com/scoutqa/z_xsjNrYT2D9nadY/images/onboarding-sign-in.png?fit=max&auto=format&n=z_xsjNrYT2D9nadY&q=85&s=e450b5f8f042b6e39062c3d194a8611c" alt="Scout sign-in screen" width="1200" height="924" data-path="images/onboarding-sign-in.png" />
</Frame>

<AccordionGroup>
  <Accordion icon="google" title="Sign in with Google">
    One-click authentication with your Google account. No passwords to manage.
  </Accordion>

  <Accordion icon="envelope" title="Sign in with email">
    Enter your email to receive a magic link. Click it to sign in instantly—no password needed.
  </Accordion>
</AccordionGroup>

### Step 2: Create your first project

<Frame>
  <img src="https://mintcdn.com/scoutqa/z_xsjNrYT2D9nadY/images/project-create.png?fit=max&auto=format&n=z_xsjNrYT2D9nadY&q=85&s=65b86cd293369b44cac6c0d10212fb7c" alt="Create a new project in Scout" width="1" height="1" data-path="images/project-create.png" />
</Frame>

<Steps>
  <Step title="Paste your app URL">
    Enter the primary URL you want Scout to explore (e.g., `https://myapp.com` or `https://staging.myapp.com`).
  </Step>

  <Step title="Confirm project details">
    Scout automatically fetches your app's name, description, and favicon. Adjust if needed.
  </Step>

  <Step title="Create the project">
    Click **Create** and you'll land on your project dashboard, ready to launch.
  </Step>
</Steps>

### Step 3: Configure the mission

Before launching, tell Scout how to explore your app.

<AccordionGroup>
  <Accordion icon="user" title="Choose a persona">
    Select who Scout should emulate during exploration:

    | Persona                   | What Scout does                                   |
    | ------------------------- | ------------------------------------------------- |
    | **General User**          | Tests typical workflows like a first-time visitor |
    | **Power User**            | Exercises advanced features and edge cases        |
    | **Security Tester**       | Hunts for vulnerabilities and auth issues         |
    | **Accessibility Auditor** | Checks for a11y issues affecting all users        |
  </Accordion>

  <Accordion icon="bullseye-arrow" title="Set goals">
    Define what success looks like: completing onboarding, finishing checkout, exploring settings, etc.
  </Accordion>

  <Accordion icon="shield-halved" title="Add guardrails">
    Specify areas Scout should avoid: payment flows, admin actions, or any sensitive sections.
  </Accordion>
</AccordionGroup>

### Step 4: Launch the exploration

<Frame>
  <img src="https://mintcdn.com/scoutqa/z_xsjNrYT2D9nadY/images/project-dashboard.png?fit=max&auto=format&n=z_xsjNrYT2D9nadY&q=85&s=285b3c5066519fcdf0ce7934d0dbf1aa" alt="Project dashboard with launch button" width="2199" height="1243" data-path="images/project-dashboard.png" />
</Frame>

Click **Launch Scout** from your project dashboard. The exploration typically completes in 5-10 minutes.

<Info>
  Watch Scout work in real-time via the live transcript, or close the tab—results will be waiting when you return.
</Info>

### Step 5: Review findings

<Frame>
  <img src="https://mintcdn.com/scoutqa/z_xsjNrYT2D9nadY/images/project-list.png?fit=max&auto=format&n=z_xsjNrYT2D9nadY&q=85&s=2d16bf90a1ff36d318134609e8005654" alt="Scout findings report" width="1" height="1" data-path="images/project-list.png" />
</Frame>

Scout delivers a structured report with:

* **Issues organized by severity** — Critical, High, Medium, Low
* **Screenshots** — Visual proof of what Scout encountered
* **Reproduction steps** — Exact actions to recreate each issue
* **Suggested fixes** — Recommendations to resolve problems

<CardGroup cols={2}>
  <Card title="Share results" icon="share-nodes">
    Generate a public link (`/t/{executionId}`) to share findings with anyone—no login required.
  </Card>

  <Card title="Assign ownership" icon="user-plus">
    Tag team members on specific issues to track resolution.
  </Card>
</CardGroup>

***

## What Scout explores

During each exploration, Scout:

<Columns cols={2}>
  <div>
    **Functionality**

    * Navigates pages like a real user
    * Fills out and submits forms
    * Tests authentication flows
    * Clicks buttons and interactive elements
  </div>

  <div>
    **Quality checks**

    * Usability friction and confusing UI
    * Broken links and missing pages
    * Console errors and API failures
    * Performance bottlenecks
    * Accessibility violations
    * Security red flags
  </div>
</Columns>

***

## Scheduling recurring explorations

Set up automated runs to catch regressions before users do.

<Steps>
  <Step title="Open project settings">
    Navigate to your project and click the **Schedules** tab.
  </Step>

  <Step title="Create a schedule">
    Choose frequency (daily, weekly, or custom), select a persona, and save.
  </Step>

  <Step title="Get notified">
    Enable email notifications to receive a summary after each scheduled run.
  </Step>
</Steps>

<Note>
  Scheduling is available from your [project dashboard](/essentials/schedules). Perfect for staging environments before each deploy.
</Note>

***

## Next steps

<CardGroup cols={3}>
  <Card title="Projects" icon="folder" href="/essentials/projects">
    Organize explorations by product or environment.
  </Card>

  <Card title="Executions" icon="rocket" href="/essentials/projects-executions">
    View run history and relaunch past explorations.
  </Card>

  <Card title="Issues" icon="circle-exclamation" href="/essentials/issues">
    Track, triage, and resolve discovered issues.
  </Card>
</CardGroup>

***

## FAQ

<AccordionGroup>
  <Accordion title="How long does an exploration take?">
    Most explorations complete in 5-10 minutes, depending on your app's size and complexity.
  </Accordion>

  <Accordion title="Do I need an API key?">
    No. The Instant URL approach works immediately with no setup. The dashboard requires only a free account.
  </Accordion>

  <Accordion title="Can Scout test authenticated pages?">
    Yes. Use the [Credentials](/essentials/credentials) feature to provide login details, or share a pre-authenticated session.
  </Accordion>

  <Accordion title="Is my data secure?">
    Scout doesn't store sensitive data. Explorations are ephemeral, and you control what pages Scout can access.
  </Accordion>

  <Accordion title="What platforms are supported?">
    Scout works with any publicly accessible web app. The Instant URL pattern currently supports Lovable and Replit, with more platforms coming soon.
  </Accordion>

  <Accordion title="Can I integrate Scout with CI/CD?">
    Yes. Use the Instant URL in GitHub Actions, GitLab CI, or any automation tool. API access is coming soon.
  </Accordion>

  <Accordion title="How do I share results with my team?">
    Every exploration generates a shareable link (`/t/{executionId}`). Recipients can view findings without creating an account.
  </Accordion>
</AccordionGroup>

***

## Need help?

<Card title="Contact Support" icon="envelope" href="mailto:huy.tieu@scoutqa.ai">
  Stuck or have questions? Reach out and we'll get you unblocked fast.
</Card>