The CLI is published as @aponiajs/cli and exposes the aponia binary. create-aponia provides the matching bun create entrypoint.

Install

bun add --global @aponiajs/cli@alpha
aponia --version

Every public package is published to the npm alpha distribution tag; latest is reserved for the first stable release.

Commands

aponia new <name> [options]
aponia n <name> [options]
aponia generate <schematic> <name> [options]
aponia g <schematic> <name> [options]
aponia help
aponia version

New applications

Create the standard Bun-first project layout.

Generate files

Add components, modules, resources, applications, and libraries.

Schematic catalog

Review aliases, output shapes, and current runtime boundaries.

Configuration

Control source roots, projects, specs, and flat output.

Module registration

Understand when a generated file is imported automatically.

Safety and errors

Dry runs, overwrite rules, and the failure messages.

Generator support is not runtime support

The CLI can generate familiar Nest-style file shapes for capabilities the runtime does not execute yet. Guards, interceptors, middleware, filters, GraphQL, and microservices are scaffolds only. Modules, controllers, services, providers, gateways, and REST and WebSocket resources are runnable.

Aponia CLI