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

# Preview Editor

> The Preview Editor provides an interactive test authoring environment where you can write, execute and debug test steps in real-time.

## Overview

The **Preview Editor** combines test authoring with live execution feedback, allowing you to validate test steps as you write them.

The **Spursor (Spur Cursor) AI agent** executes your instructions in a live browser environment, providing immediate visibility into how your tests perform.

## Getting Started

<Steps>
  <Step title="Open Preview Editor">
    Navigate to the test you want to edit and click **Open in Preview Editor**.

    <Frame>
      <img src="https://mintcdn.com/spur/RaeB6Oz5SVRJ2dhu/images/openpe.gif?s=301aaeac6666a2b9d57465e562cede50" alt="Openpe" width="1976" height="1080" data-path="images/openpe.gif" />
    </Frame>
  </Step>

  <Step title="Configure Viewport">
    Select the viewport for your test session - either Desktop or Mobile. This determines the screen dimensions the Spursor agent will use during test execution.

    You can reference the [Viewports](/authoring-tests/test-side-peek/viewports) for detailed information on viewport configurations.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at12.56.28PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=f2d9412b588ea41aa639a62a2ad48a47" alt="Screenshot2026 02 04at12 56 28PM" width="1054" height="710" data-path="images/Screenshot2026-02-04at12.56.28PM.png" />
    </Frame>
  </Step>

  <Step title="Enter the Editing Environment">
    The Preview Editor launches an interactive test authoring environment with multiple capabilities accessible through different tabs and panels.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at12.57.20PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=2e46b1f92cb8b364bdde1a288f637488" alt="Screenshot2026 02 04at12 57 20PM" width="2560" height="1186" data-path="images/Screenshot2026-02-04at12.57.20PM.png" />
    </Frame>
  </Step>
</Steps>

## Navigating the Editing Environment

This section onsists of several key components that work together to provide comprehensive test authoring and debugging capabilities.

<Frame>
  <img src="https://mintcdn.com/spur/4nwpEE0-cgs18aCd/images/Screenshot2026-02-04at1.38.56PM.png?fit=max&auto=format&n=4nwpEE0-cgs18aCd&q=85&s=ec52f608bf2a790ba4ccc50f41022631" alt="Screenshot2026 02 04at1 38 56PM" width="1444" height="756" data-path="images/Screenshot2026-02-04at1.38.56PM.png" />
</Frame>

<AccordionGroup>
  <Accordion title="1. Test Steps">
    Write and execute test steps in the left panel. The editor supports adding, editing, and running individual steps or complete test sequences.

    <Frame>
      <img src="https://mintcdn.com/spur/4nwpEE0-cgs18aCd/images/Screenshot2026-02-04at1.44.12PM.png?fit=max&auto=format&n=4nwpEE0-cgs18aCd&q=85&s=ef6ecdeae78f524b6130776c5ec52bbb" alt="Screenshot2026 02 04at1 44 12PM" width="922" height="612" data-path="images/Screenshot2026-02-04at1.44.12PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="2. Dependencies">
    Configure test dependencies and tear down tests to control test execution order. The Dependencies panel allows you to establish relationships between tests.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.44.21PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=53e4b4f494e7ec7e911ccc0914cd9063" alt="Screenshot2026 02 04at3 44 21PM" width="920" height="1040" data-path="images/Screenshot2026-02-04at3.44.21PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="3. Details">
    Configure test metadata and expected outcomes in the Details panel. This section allows you to add descriptive information about your test.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.43.45PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=93d086967241449e8e6a4cf1213f0054" alt="Screenshot2026 02 04at3 43 45PM" width="920" height="598" data-path="images/Screenshot2026-02-04at3.43.45PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="4. Spursor Sandbox">
    Watch the Spursor AI agent execute your test steps in real-time within a live browser environment. The sandbox displays exactly what the agent sees and does during test execution.

    <Warning>
      User interactions in this sandbox are not recorded. Any changes made by the user in this sandbox browser will not be incorporated into testing.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at2.42.56PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=46c77788125bc743d7a3e90f6123b5aa" alt="Screenshot2026 02 04at2 42 56PM" width="1638" height="984" data-path="images/Screenshot2026-02-04at2.42.56PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="5. Preview Mode">
    Preview Mode allows you to review the Spursor agent's planned actions before execution.

    <Frame>
      <img src="https://mintcdn.com/spur/BvhWQtDOy3g9ZJZN/images/previewmode.gif?s=f66ccb7501b518fb3d95cb95c858792e" alt="Previewmode" width="1976" height="1080" data-path="images/previewmode.gif" />
    </Frame>
  </Accordion>

  <Accordion title="6. Agent Logs">
    View the Spursor agent's thought process when evaluating and executing test steps. Agent logs provide insight into how Spursor interprets your instructions and decides on actions.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.26.31PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=6b20142cfe41fd06deb135c1041a1663" alt="Screenshot2026 02 04at3 26 31PM" width="1302" height="326" data-path="images/Screenshot2026-02-04at3.26.31PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="7. Console Logs">
    View real-time console logs generated when running tests, including warnings, errors, and debug messages from the browser.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.28.52PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=3206f00fb1c0355239204780f7dd6f40" alt="Screenshot2026 02 04at3 28 52PM" width="1326" height="239" data-path="images/Screenshot2026-02-04at3.28.52PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="8. Network Logs">
    View real-time network activity during test execution, including API requests, response status codes, methods, and domains.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.34.07PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=f029b5eb248b17e8ad17c8d72b3e4e48" alt="Screenshot2026 02 04at3 34 07PM" width="1012" height="246" data-path="images/Screenshot2026-02-04at3.34.07PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="9. Environment">
    View extracted or generated values saved in the testing environment. These values can be accessed and used in subsequent test steps.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.37.48PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=705feb39c9b0128aed0bce69e7651e84" alt="Screenshot2026 02 04at3 37 48PM" width="852" height="170" data-path="images/Screenshot2026-02-04at3.37.48PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="10. Scroll Estimations">
    Access page and window dimensions to aid test step creation. View current scroll position, page dimensions, and window size. You can also scroll within the Spursor Sandbox and access the page position directly.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.20.08PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=a09edfa2cdc1d2d76a394c857b1433ee" alt="Screenshot2026 02 04at3 20 08PM" width="1366" height="1062" data-path="images/Screenshot2026-02-04at3.20.08PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="11. Admin Logs">
    View technical session information and connection status for the test execution environment. The Admin tab displays session initialization details, WebSocket connections, and other backend communications.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.20.39PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=f35288812cd24687c8bf2694edacbeaf" alt="Screenshot2026 02 04at3 20 39PM" width="772" height="256" data-path="images/Screenshot2026-02-04at3.20.39PM.png" />
    </Frame>
  </Accordion>

  <Accordion title="12. Actions Log">
    View the complete action history for your test session. The Actions tab displays all actions performed by the Spursor agent during test execution.

    <Frame>
      <img src="https://mintcdn.com/spur/H3xqe3VyV7YeO-e5/images/Screenshot2026-02-04at3.21.18PM.png?fit=max&auto=format&n=H3xqe3VyV7YeO-e5&q=85&s=b81dad61e1f3fcf488d2b08d3d4a0fc3" alt="Screenshot2026 02 04at3 21 18PM" width="772" height="152" data-path="images/Screenshot2026-02-04at3.21.18PM.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

## Key Benefits

<Columns cols={2}>
  <Card
    title="Resolving Test Step Issues
"
  >
    Preview Editor allows you to walk through the agent's exact execution process, identifying and resolving issues with test steps in real-time.
  </Card>

  <Card title="Transparency in AI Decision Making">
    Provides complete visibility into how Spursor interprets and executes your instructions, helping you understand the AI agent's decision-making process.
  </Card>

  <Card title="Prompting Practice & Learning">
    By observing how the AI responds to different instructions in real-time, you can improve your prompting skills and learn the most effective ways to communicate with the agent.
  </Card>

  <Card title="Quality Assurance">
    Preview Mode ensures that each step executes exactly as intended, reducing errors and improving test reliability. You maintain full control over the agent's actions before execution.
  </Card>
</Columns>
