@koalarx/ui

<div align="center">
  <h1>@koalarx/ui</h1>
  <p>CLI for creating and managing Angular projects with ready-to-use UI components.</p>

[![npm version](https://img.shields.io/npm/v/@koalarx/ui)](https://www.npmjs.com/package/@koalarx/ui)
[![license](https://img.shields.io/npm/l/@koalarx/ui)](./LICENSE)

**[📖 Full Documentation → ui.koalarx.com](https://ui.koalarx.com)**

</div>

---

## Installation

```bash
npm install -g @koalarx/ui
```

or with bun:

```bash
bun add -g @koalarx/ui
```

---

## Commands

### `kl new`

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

During project creation, the CLI asks which package manager you want to use:

- `bun`
- `npm`
- `yarn`
- `pnpm`

You can also skip the interactive prompt by passing the `--pm` flag.

```bash
kl new --name meu-projeto
kl new --name my-project --pm npm
```

---

### `kl install`

Adds one or more UI components to the project.

```bash
kl install button
kl install button,loading,dropdown
kl install modal --project meu-projeto
```

---

### `kl init`

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

```bash
kl init
kl init --project meu-projeto
kl init --project meu-projeto --verbose
```

---

### `kl version`

Shows the installed CLI version.

```bash
kl version
```

---

## Documentation

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

**[ui.koalarx.com](https://ui.koalarx.com)**