AponiaJSDocs
CLI

aponia new

Create an AponiaJS application with deterministic safety behavior.

Usage

aponia new <name> [options]
aponia n <name> [options]

Create and start an application:

aponia new my-api
cd my-api
bun run dev

The equivalent Bun create command delegates to the same generator:

bun create aponia my-api

Naming and destination

Names must use lowercase kebab-case:

users-api
commerce-service
internal-tools

The destination is resolved under the current working directory. The generator does not merge into an existing target directory.

Options

OptionAliasBehavior
--dry-run-dValidate and list output without creating the project.
--skip-install-sCreate files without running bun install.

Examples:

aponia new my-api --dry-run
aponia new my-api --skip-install

Version alignment

The generated manifest pins @aponiajs/common and @aponiajs/platform-elysia to the CLI version. It also installs the compatible Elysia dependency used by the current template.

Do not mix AponiaJS package versions inside the generated project.

On this page