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

# app:create

> Create a new application with its app and shared modules, configuration files, dependencies, and optional CI/CD setup.

Scaffolds a complete Ooneex application at the destination path. It creates the `app` module (typed as an `api`) and the `shared` module, writes the entrypoint, the `SharedDatabase`, `roles.yml`, Docker files (`docker-compose.yml`, `Dockerfile`, `.dockerignore`), then runs `app:init` for the config and tooling, installs the runtime and dev dependencies (`@ooneex/app`, `@ooneex/auth`, `typeorm`, and others), and optionally generates CI/CD files for GitHub, GitLab, or Bitbucket.

## Usage

```bash theme={null}
ooneex app:create [options]
```

## Examples

Run with no flags to be prompted for the application name and destination path:

```bash theme={null}
ooneex app:create
```

Create an application non-interactively by passing the name and destination:

```bash theme={null}
ooneex app:create --name=Billing --destination=billing
```

```bash theme={null}
ooneex app:create --name=ShopApi --destination=./apps/shop-api
```

## Options

| Option          | Description                                     | Default                                               |
| --------------- | ----------------------------------------------- | ----------------------------------------------------- |
| `--name`        | Application name.                               | Prompted if omitted                                   |
| `--destination` | Destination path for the generated application. | Prompted if omitted (defaults to the kebab-case name) |