Laterite

Get started

From nothing to a running admin.

Laterite ships a command-line tool that scaffolds a project, sets up the database, and creates the first administrator in one guided step.

Prerequisites

  • Rust (stable), installed with rustup.
  • One of PostgreSQL, MySQL/MariaDB, or SQLite. SQLite needs nothing extra; it is just a file.

1. Install the CLI

This installs the lat binary. It bundles every database driver, so one binary works with any supported database.

cargo install laterite-cli

2. Create an application

Run lat new and answer the prompts: the application name, a display timezone, a database and its connection details, and the first administrator.

lat new

It scaffolds the project, applies the framework migrations, and creates the administrator.

3. Run it

cd acme
cargo run

Open 127.0.0.1:8080/admin and sign in.

Check the setup

lat doctor, run from the application directory, verifies it is ready to serve: the configuration loads, the timezone is valid, storage/ is writable, the database is reachable, and the framework tables are present. It exits non-zero if anything fails, so it can gate a deploy.

cd acme
lat doctor

The full guide lives in the handbook, generated with the project. Browse the source and the crate docs on GitHub.