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

# mobster fixtures

> List the app states your checks start from, and put a simulator in one.

List the app states your checks start from (.mobster/fixtures/: a reset, launch args, seed files, the keychain, the pasteboard, sign-in steps) and put a simulator's app in one now.

## Usage

```text theme={"theme":"css-variables"}
mobster fixtures <command>
```

```text theme={"theme":"css-variables"}
examples:
  mobster fixtures list
  mobster fixtures apply logged-in-cart --bundle com.example.shop
```

## Commands

| Command | What it does |
| - | - |
| [`mobster fixtures list`](#mobster-fixtures-list) | list the project's fixtures and what each one sets up |
| [`mobster fixtures apply`](#mobster-fixtures-apply) | put a simulator's app in a fixture's state now |

## `mobster fixtures list`

List the fixtures in .mobster/fixtures/, flattened with what they extend: the reset, the launch args and env, the seed files, the keychain, the pasteboard and the steps. Reads files only.

### Options

| Name | Default | Description |
| - | - | - |
| `--json` | off | print them as JSON |
| `--project DIR` | the one you are in | the project folder |

## `mobster fixtures apply`

Reset the app on a simulator and seed it as the fixtures say: the keychain, the files in its data container and the pasteboard. Several names compose in order. The app is not launched.

### Arguments and options

| Name | Default | Description |
| - | - | - |
| `NAME [NAME ...]` | required | fixtures to apply, in order |
| `--bundle ID` | required | the app's bundle ID |
| `--app PATH` | none | a built .app to install first (needed for a reinstall) |
| `--sim TYPE` | Mobster's own | a simulator, such as "iPhone 17 Pro" |
| `--device NAME` | none | an iPhone: refused when the fixtures change its state |
| `--project DIR` | the one you are in | the project folder |

```text theme={"theme":"css-variables"}
exit codes: 0 applied, 3 couldn't

examples:
  mobster fixtures apply logged-in-cart --bundle com.example.shop
  mobster fixtures apply clean empty-cart --bundle com.example.shop --sim "iPhone 17 Pro"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.