Installation

Install the Igniter.js CLI globally or per-project. Node.js 18.17+ required. Supports npm, pnpm, yarn, and bun.

Installation

The CLI can be installed globally (recommended) or run on-demand with your package manager's executor. It requires Node.js 18.17 or later.

The CLI uses commander for argument parsing, @clack/prompts for interactive prompts, and chokidar for file watching. These are bundled — no external system dependencies.


Global Installation

Install once, use everywhere:

npm install -g @igniter-js/cli
pnpm add -g @igniter-js/cli
yarn global add @igniter-js/cli
bun add -g @igniter-js/cli

Verify the installation:

igniter --help

You should see the top-level help output listing init, generate, and dev commands.


Run Without Installing

You can run the CLI on-demand without global installation:

npx @igniter-js/cli@latest --help
pnpm dlx @igniter-js/cli@latest --help
yarn dlx @igniter-js/cli@latest --help
bunx @igniter-js/cli@latest --help

Adding @latest ensures you always get the most recent version. For CI/CD pipelines, pin to a specific version: @igniter-js/cli@0.0.1.


Per-Project Installation

If you prefer to install the CLI as a dev dependency in a specific project:

npm install -D @igniter-js/cli

Then use it via npx:

npx igniter init my-app

Or add it to your package.json scripts:

{
  "scripts": {
    "igniter:init": "igniter init",
    "igniter:generate": "igniter generate",
    "igniter:dev": "igniter dev"
  }
}

Requirements

RequirementMinimum VersionNotes
Node.js18.17+Required for fetch, native fs/promises, and ESM support
TypeScript5.3+For generated code type inference (optional but recommended)

The CLI itself is built with TypeScript and compiled with tsup. Generated code uses TypeScript features available in 5.3+ — if your project uses an older version, update your tsconfig.json.


Next Steps