> ## 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.

> ## Agent Instructions
> Spur is an AI-powered QA engineer that lets teams create and run automated end-to-end tests for web and mobile apps using natural language.
> When answering questions about Spur, cite the relevant page from docs.spurtest.com.

# Flip Device

> Emulate flipping the device face-up to face-down (Android emulators)

## Overview

**Flip Device** simulates turning the phone over — from lying face-up to face-down
(screen facing down), as if you flipped it on a table — and then back again. Use it to
test features that respond to that motion, such as **flip-to-mute** or
**flip-to-silence**.

<Warning>
  **Android emulators only.** Flip is delivered through the Android emulator's sensor
  console, so it works on **Android emulators** but not on physical devices. It is **not
  supported on iOS** — the iOS Simulator can't inject accelerometer data, and the
  fallback (rotating to upside-down) is rejected by most iPhone apps, so flip steps
  should not be used in iOS tests.
</Warning>

<Note>
  Flip has **no visible effect on its own** — it only changes the simulated accelerometer
  reading. It does **not** rotate the screen. You'll only observe a change if the app
  under test has a feature that explicitly listens for the flip gesture. There is no
  separate screen-rotation step.
</Note>

## How to use

Write a step in plain language:

* `Flip the device`
* `Turn the phone face-down to mute the ringer`

### Hold and return (optional)

By default the device flips face-down, holds for about 800 ms, then flips back. You can
optionally control this:

* `<ms>` — hold face-down for that many milliseconds before returning (e.g. `2000`)
* `no_return` — flip face-down and **stay** there (no return motion)

Leave it out to use the default (face-down, \~800 ms, then back).

## Example use cases

* **Flip-to-mute / flip-to-silence** — silence a call or alarm by turning the phone over
* **Flip-to-pause** media or similar gesture-driven features

<Warning>
  Sensor injection on emulators is approximate — the emulator's own sensor service can
  overwrite the injected values, so an app's flip detector may not always register the
  gesture. For reliable flip-detection testing, use a **physical device**.
</Warning>

## Platform support

**Android emulators only.** Not supported on physical devices or on iOS.