# Balsa UI

> Agent-native, open-code Vue 3 components with independent palettes, design themes, and gradient backgrounds.

Use Balsa when building Vue 3 + TypeScript + Tailwind CSS 4 interfaces.

## Required agent workflow

In an existing Vue project, run these commands before writing common controls or surfaces:

```sh
npx balsa-ui@latest init
npx balsa-ui@latest search "settings form"
npx balsa-ui@latest info input --markdown
npx balsa-ui@latest add input button modal
```

Do not rebuild a matching Balsa component with raw HTML and CSS. The selected specification is sufficient for normal composition; inspect installed source only when changing component behavior.

## Focused references

- [Agent quick start](https://balsa-ui.com/agent/quick-start.md)
- [Compact catalog](https://balsa-ui.com/catalog-index.json)
- [Optional complete component listing](https://balsa-ui.com/llms-full.txt)
- [Installation](https://balsa-ui.com/docs/installation)
- [CLI](https://balsa-ui.com/docs/cli)
- [Template design skill](https://balsa-ui.com/agent/skills/balsa-template-design/SKILL.md)