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

# Flows Troubleshooting

> Troubleshoot common issues when authoring or running @qawolf/flows, including target configuration errors and missing launch context.

## `platform.target` Throws

Cause: The active target was read before it was configured.

Check:

* the runner is setting the target before flow code executes
* tests and local tooling call `configureTarget(...)` explicitly

## Callback Is Missing `page` Or `driver`

Cause: The flow uses the no-`launch` path, so launched runtime objects are not injected into the callback automatically.

Check:

* whether the flow should use `{ target, launch: true }`
* whether the flow should call `launch()` explicitly inside the callback

## Runtime API Called Outside The Flow Callback

Cause: `launch()`, `device`, or `platform.target` was called at the module level, outside the flow callback.

Check:

* that all runtime API calls are inside the flow callback, not at the top of the file
* that module-level code is limited to imports, constants, and pure helper functions