kael-cli 0.4.1

Scaffold and build release-aligned Kael applications for desktop and the web
# `kael-cli`

The project scaffolder and browser builder for the
[Kael application framework](https://github.com/Augani/kael).

```bash
cargo install kael-cli
kael new my_app
cd my_app
cargo run
```

The generated `main.rs` is shared by the native and browser targets. Run it in
a browser with:

```bash
cargo install wasm-bindgen-cli --version 0.2.122 --locked
npm install --global binaryen@132.0.0
kael web serve
```

For deployment, `kael web build` emits `index.html`, `app.js`, and
`app_bg.wasm` under `dist/web`. Use `--package` or `--bin` in a larger Cargo
workspace, and `--debug` when iteration speed matters more than output size.
Release builds use the pinned Binaryen optimizer; `--debug` skips it.

The generated project uses the matching `kael` and `kael_ui` release and can
be created offline after the CLI is installed. Its `rust-toolchain.toml` and
`rust-version` use the same stable Rust release as that Kael release, so local
development and CI agree automatically.

On macOS, generated apps enable runtime Metal shader compilation so `cargo run`
works with either Command Line Tools or full Xcode. Release builds can remove
that feature to precompile shaders when full Xcode is available.

`kael new` reserves the destination atomically and never overwrites an existing
path. Project names follow Cargo and crates.io rules: 1–64 ASCII characters,
starting with a letter or underscore, with Rust keywords and cross-platform
reserved names rejected up front.

The generated app starts with Kael primitives, `kael_ui` components, a branded
theme entry point, and a fallible cross-platform window startup path. See the
[Kael guide](https://augani.github.io/kael/) for architecture and component
usage, or the [`kael-cli` documentation](https://docs.rs/kael-cli) for the
embedded scaffolder contract.

## License

Licensed under the [Apache License, Version 2.0](https://github.com/Augani/kael/blob/main/LICENSE-APACHE).