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

# App commands

> Build and package apps locally

The `app` group holds local, filesystem-based app actions. Today that is just
`package`. Cloud operations on a published app (versions, set-active, sharing,
publishers) live under the [entity commands](/docs/platform-docs/cli/entity).

<Note>
  Listing, creating, cloning, and configuring apps locally land with the
  filesystem command pass. Scaffolding a new app is available today via
  `synthetiq create app <name> --dir <path>`.
</Note>

## package

Build a self-contained production package:

```bash theme={null}
synthetiq app package <name> [options]
```

| Flag                   | Default  | Description                                       |
| ---------------------- | -------- | ------------------------------------------------- |
| `--db-adapter <type>`  | `sqlite` | Database adapter: `sqlite`, `postgresql`, `mysql` |
| `--target-arch <arch>` | —        | Target architecture (e.g., `linux-arm64`)         |

```bash theme={null}
synthetiq app package my-app --db-adapter postgresql --target-arch linux-arm64
```

### Running the package

```bash theme={null}
node .package/server.js    # Start the app server
node .package/worker.js    # Start the workflow worker
```