📖 Full Documentation → ui.koalarx.com

Installation

npm install -g @koalarx/ui

or with bun:

bun add -g @koalarx/ui

Commands

kl new

Creates a new Angular project with the Koala structure and dependencies already configured.

Interactive prompts (before scaffold): package manager → app/library → SSR (app only) → AI context (Cursor / GitHub Copilot).

Package managers: bun, npm, yarn, pnpm.

Skip prompts with --pm, --type app|library, --ssr / --no-ssr, --ai-context, and --silent (non-interactive defaults: bun + app + no SSR + AI context none).

kl new --name meu-projeto
kl new --name my-project --pm npm
kl new my-app --ssr
kl new my-lib --type library
kl new my-app --ai-context both
kl new my-app --silent

kl install

Adds one or more UI components to the project.

Use --silent to accept all external dependency installs without prompting (recommended for AI agents and CI).

kl install button
kl install button,loading,dropdown
kl install modal --project meu-projeto
kl install button,modal --silent

kl add

Adds project features. Currently supports AI context scaffolding:

kl add ai-context cursor
kl add ai-context github
kl add ai-context cursor github

kl init

Initializes an existing Angular project with the Koala structure and required tooling.

kl init
kl init --project meu-projeto
kl init --project meu-projeto --verbose
kl init --ai-context none
kl init --silent

kl version

Shows the installed CLI version.

kl version

Support lines (main + previous-release)

| Line | Branch | Docs | npm dist-tag | |------|--------|------|--------------| | Latest | main | ui.koalarx.com | latest | | Previous | previous-release | ui.koalarx.com/v{major}/ | configured in .github/release-lines.json (previousDistTag, e.g. angular-21) |

Archive branches (e.g. 22.3.0) keep frozen majors without CI. On a major bump: create the archive from previous-release, move current main into previous-release, then develop the new major on main. See .agents/documentation.md.

Library major tracks Angular major (22.x → Angular 21, 23.x → Angular 22).

Documentation

For detailed installation guides, usage instructions, patch notes, and examples for each component, visit the official documentation:

ui.koalarx.com · previous line under /v{major}/ · Patch notes · CHANGELOG.md