# How Leilani works

Leilani builds and hosts Rust applications. Push your source code with Git, and use the browser console to inspect builds, read logs, and manage configuration.

A Leilani **workspace** runs your Rust application in a VM. Push one Git repository containing a single Cargo package or a Cargo workspace. Leilani builds every workspace member and starts the executables you list in `leilani.json`. An API and a background worker can run together and share a library from the same repository.

Your workspace ID identifies the workspace in Leilani; it is separate from the package names in Cargo.toml. The `leilani.json` file also tells Leilani where to send HTTP requests.

Bring a Rust HTTP application that runs locally, or [deploy the small Axum app below](https://leilani.dev/docs/quickstart.md). Keep the Cargo workspace’s root `Cargo.toml` at the root of your Git project. A single-package project works too.
