Yunfei He
8209f8440b
- @vue-tui/runtime: rewrite with pitch, badges, SFC+shallowRef example, accurate component/composable tables, app lifecycle examples - @vue-tui/cli: new README documenting vue-tui dev, HMR, crash recovery - @vue-tui/testing: rewrite with @testing-library positioning, correct async render API, cleanup globals:true requirement - Add early-stage warning to all sub-packages (matching root README) - Fix CLI package.json: add license field, correct description Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
51 lines
1.6 KiB
Markdown
51 lines
1.6 KiB
Markdown
# @vue-tui/cli
|
|
|
|
> **Early stage** — under active development. Bug reports welcome, but not recommended for production use yet.
|
|
|
|
Development server for vue-tui — Vite-powered HMR for Vue 3 terminal apps.
|
|
|
|
[](https://www.npmjs.com/package/@vue-tui/cli)
|
|
[](https://www.npmjs.com/package/@vue-tui/cli)
|
|
|
|
## Why
|
|
|
|
- **Terminal HMR** — edit a `.vue` file, see the terminal update instantly
|
|
- **Works with your Vite config** — just run `vue-tui dev` in a project with `index.html` and your existing Vite plugins
|
|
- **Crash recovery** — auto-restarts the process after a crash
|
|
|
|
Built on Vite's `bundledDev` mode. Bundles your vue-tui app into a single Node.js process with hot module replacement — the same edit-save-see loop you get with Vite on the web, but for TUI development.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
npm install -D @vue-tui/cli
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
vue-tui dev
|
|
```
|
|
|
|
Starts a Vite dev server in `bundledDev` mode, builds your app, and runs it in a managed child process. Most file changes are applied via HMR; changes that require a full reload restart the process automatically.
|
|
|
|
### package.json script
|
|
|
|
```json
|
|
{
|
|
"scripts": {
|
|
"dev": "vue-tui dev"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Links
|
|
|
|
- [vue-tui](https://github.com/vuejs-ai/vue-tui) — monorepo root
|
|
- [`@vue-tui/runtime`](https://www.npmjs.com/package/@vue-tui/runtime) — the core framework
|
|
- [`@vue-tui/testing`](https://www.npmjs.com/package/@vue-tui/testing) — test harness for terminal components
|
|
|
|
## License
|
|
|
|
MIT
|