Spur

https://docs.spurtest.com
Admin
Spur is an AI-powered QA engineer that enables teams to create, run, and analyze automated...
Tokens:92,487
Snippets:1,223
Trust Score:8.4
Update:1 month ago
Show doc for...
Tokens:
Raw
### Conditional step examples

Source: https://docs.spurtest.com/getting-started/mobile-prompting

Examples of conditional steps for common popups. These show how to decline email list and Bluetooth prompts.

```text
If "Join our email list" is displayed, tap "No, thank you". Otherwise, skip this step.
```

```text
If "Turn On Bluetooth" is displayed, tap "Not now". Otherwise, skip this step.
```

--------------------------------

### Navigation reliability example

Source: https://docs.spurtest.com/getting-started/mobile-prompting

Example of a navigate step that includes a wait for the target screen, ensuring screenshots are captured after transition.

```text
navigate to the Settings screen and wait for "Settings" to be displayed
```

--------------------------------

### Recommended test starting template

Source: https://docs.spurtest.com/getting-started/mobile-prompting

Starting steps for most mobile tests to establish a consistent app state: wait for load, handle login, and verify sign-in.

```text
Wait for the app to load
If already logged in, skip this step. Otherwise, enter "user@email.com" as email and "Password1" as password and tap Continue
Verify that the user is signed in
```

--------------------------------

### Example test steps output

Source: https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-in-sprint-testing

Example structured test steps generated by Claude for a search modal test case.

```text
Test: Search term clears on modal close
1. Navigate to the homepage
2. Click the search icon to open the search modal
3. Type "jacket" in the search field
4. Verify search results appear
5. Close the search modal
6. Reopen the search modal
7. Verify the search field is empty
```

--------------------------------

### Prompt: Create test in Checkout suite

Source: https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-in-sprint-testing

Example prompt to create a test in the Checkout suite using the staging URL key.

```text
"Create this test in the Checkout suite using the staging URL key"
```

--------------------------------

### Prompt: Run test on staging

Source: https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-in-sprint-testing

Example prompt to run a test on staging via the Spur MCP.

```text
"Run the search modal test on staging"
```

--------------------------------

### Example product_detail event payload

Source: https://docs.spurtest.com/additional-resources/spur-for-data-science-teams

Example JSON payload for a product view event, showing fields like event_name, product_id, product_name, price, currency, category, brand, color, size, and in_stock.

```json
{
  "event_name": "product_detail",
  "product_id": "ABC-12345",
  "product_name": "Classic Oxford Shirt",
  "price": 68.00,
  "currency": "USD",
  "category": "Men > Shirts",
  "brand": "Main Brand",
  "color": "Blue",
  "size": "M",
  "in_stock": true
}
```

--------------------------------

### Cursor MCP Install Deep Link

Source: https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-setup

Use this deep link to install the Spur MCP server in Cursor. Paste it into your browser address bar or click the install button.

```text
cursor://anysphere.cursor-deeplink/mcp/install?name=Spur&config=eyJ1cmwiOiJodHRwczovL2FwcC5zcHVydGVzdC5jb20vYXBpL21jcCIsImhlYWRlcnMiOnt9fQ%3D%3D
```

--------------------------------

### GET /me with saved token

Source: https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/api-call

Makes a GET request to /me, using the token from the saved response 'loginResponse' in the Authorization header. Expects a 200 status.

```text
Make an API Call
  Method: GET
  URL: https://api.example.com/me
  Headers: Authorization = Bearer {{loginResponse.token}}
  Expect Status: 200
```

--------------------------------

### Get a full overview of a run

Source: https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-test-plans

Prompt Claude for a detailed run breakdown. Claude calls `get_test_plan_run_overview`, listing failures first with reasons and including a `task_id` for each failure.

```text
"Give me a full breakdown of run 107272"
```

--------------------------------

### Expect Toast Example

Source: https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/mobile/expect-toast

Use this step to assert that a toast appears after a triggering action. The step passes if the toast appears and fails if it does not. The triggering action should be the step immediately before this one.

```text
Tap the "Save" button
Expect toast "Changes saved"
```

--------------------------------

### Prompt: Update test step

Source: https://docs.spurtest.com/analysing-tests/mcp/spur-mcp-in-sprint-testing

Example prompt to update an existing test step.

```text
"Update that test — change step 3 to click the 'Add to cart' button instead"
```

--------------------------------

### Expect No Toast Example

Source: https://docs.spurtest.com/authoring-tests/test-side-peek/step-types/mobile/expect-toast

Use this step to assert that a toast does not appear after a triggering action. The step passes if the toast does not appear and fails if it does. The triggering action should be the step immediately before this one.

```text
Submit the form with an invalid email
Expect no toast "Profile updated"
```

--------------------------------

### Deep Link Test Example

Source: https://docs.spurtest.com/additional-resources/deep-links

Example of a Spur test that uses a deep link to navigate directly to a product collection page. The deep link is triggered via a JavaScript injection step with the [Deeplink] label, using the URI scheme myapp:// and the path collections/womens-shop-all. Always add a wait or verify step after the deep link to allow the app to load the target screen.

```text
Wait for the app to load

If "Sign In" is displayed, tap Sign In and log in. Otherwise, skip this step.

Navigate to the home page

Cached Action: [Deeplink] {{ window.location = 'myapp://collections/womens-shop-all'; }}

Wait 2 seconds

Verify that "Women's Shop All" is displayed
```

--------------------------------

### Log step to validate product_detail event

Source: https://docs.spurtest.com/additional-resources/spur-for-data-science-teams

Plain-language Log step instructing the agent to confirm the product_detail event fired and contains product_id, product_name, and price as a number.

```text
Log Confirm the product_detail event fired and contains product_id, 
    product_name, and price as a number
```
Tokens:
Raw