> For the complete documentation index, see [llms.txt](https://docs.rumi.systems/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rumi.systems/rumi-cli/commands/quickstart/app.md).

# app

Generate a complete quickstart application with multiple microservices.

## Syntax

```bash
rumi quickstart app [options]
```

## Options

| Option                 | Short | Description                           | Default                 |
| ---------------------- | ----- | ------------------------------------- | ----------------------- |
| `--encoding-type`      | `-e`  | Message encoding type                 | `quark`                 |
| `--messaging-provider` | `-m`  | Messaging provider                    | `activemq`              |
| `--target-dir`         | `-t`  | Target directory                      | `.` (current directory) |
| `--only-scaffolding`   | `-s`  | Create scaffolding only (no services) | `false`                 |

**Valid encoding types:** `quark`, `flatbuffer`, `protobuf`

**Valid messaging providers:** `activemq`, `solace`, `kafka`

## Generated Services

* **Processor** - Stateful, clustered microservice with state replication HA model
* **Driver** - Message generator service
* **Webservice** - HTTP front door onto the engine
* **Connector** - message-bus binding to an external system

## Examples

Generate with defaults (Quark encoding, ActiveMQ):

```bash
rumi quickstart app
```

Generate with Solace messaging:

```bash
rumi quickstart app --messaging-provider solace
```

Generate only scaffolding (no services):

```bash
rumi quickstart app --only-scaffolding
```

Generate to specific directory:

```bash
rumi quickstart app --target-dir ~/projects/my-rumi-app
```

## See Also

* [processor](/rumi-cli/commands/quickstart/processor.md) - Add a Processor service to an existing app
* [driver](/rumi-cli/commands/quickstart/driver.md) - Add a Driver service to an existing app
* [webservice](/rumi-cli/commands/quickstart/webservice.md) - Add a Webservice microservice to an existing app
* [connector](/rumi-cli/commands/quickstart/connector.md) - Add a Connector microservice to an existing app