# app dev

> Run your app on a development store, through a tunnel to this machine.

Source: https://storeware.ai/docs/cli/commands/app-dev

```bash
npx @storeware/cli app dev [manifest] [flags] [-- <command>]
```

## Arguments

| Argument | Required | What it is |
| --- | --- | --- |
| `[manifest]` | No | The manifest. `storeware.app.toml` in this directory when not given. |
| `[-- <command>]` | No | The command that starts your server. It runs with your app's credentials and the tunnel's address in its environment. |

## Flags

| Flag | What it does |
| --- | --- |
| `--store <handle>` | Which development store, by handle or id. The one from last time, or your first, when not given. One is made if you have none. |
| `--tunnel <url>` | A tunnel you run yourself, instead of cloudflared. |
| `--run "<command>"` | The command that starts your server, for a script runner that drops what follows `--`. |

## Examples

```bash
npx @storeware/cli app dev -- npm run dev
npx @storeware/cli app dev --store my-dev-store --run "npm start"
```

More in [Quickstart](https://storeware.ai/docs/get-started/quickstart). Every command also takes the [flags on the reference page](https://storeware.ai/docs/cli/commands#flags-every-command-takes).
