CLI

@miiajs/cli provides commands for developing, building, and running MiiaJS applications across Bun, Deno, and Node.js.

Installation

npm install -D @miiajs/cli

Commands

miia dev

Start the development server with hot reload and type checking:

miia dev
miia dev --runtime bun
miia dev --entry src/server.ts --env-file .env.local

Runs two parallel processes:

1. TypeScript compiler in watch mode (tsc --noEmit --watch)
2. Development server with file watching

miia build

Build the project for production:

miia build
miia build --runtime node

miia start

Start the production server:

miia start
miia start --runtime node --dist dist/app.js
miia start --env-file .env.production

Sets NODE_ENV=production for Bun and Node.js.

miia check

Type-check the project:

miia check

Runs tsc --noEmit. No flags.

miia new

Scaffold a new MiiaJS project:

miia new my-app
miia new  # interactive prompt

Prompts for:

1. Project name (if not provided)
2. Runtime — Bun (recommended), Deno, or Node.js

Generates:

my-app/
├── package.json
├── tsconfig.json
├── .gitignore
└── src/
    ├── main.ts
    └── app/
        ├── app.module.ts
        ├── app.controller.ts
        └── app.service.ts

Then installs dependencies automatically.

Runtime detection

The CLI automatically detects your runtime by checking lockfiles:

If no lockfile is found, it checks for bun or deno in PATH. Falls back to Node.js.

Override with --runtime:

miia dev --runtime bun

Package.json scripts

The generated project includes these scripts:

{
  "scripts": {
    "dev": "miia dev",
    "build": "miia build",
    "start": "miia start",
    "check": "miia check"
  }
}

Prerequisites