CLI Reference

The resuma command scaffolds projects, runs dev servers, builds releases, and generates route registries.

Install

cargo install resuma

# From monorepo source:
cargo install --path crates/resuma --features cli

resuma new / resuma create

Run resuma new without arguments in a terminal to pick the project name and template interactively.

resuma new                              # interactive prompts
resuma new my-app
resuma new my-app --template basic          # static SSR (default)
resuma new my-app --template todo           # full showcase
resuma new my-app --template flow           # file-based pages
resuma new my-app --template flow-fullstack # Flow + SQLx sample

resuma add

resuma add              # interactive menu
resuma add sqlx    # src/db.rs, migrations/, deps
resuma add turso  # src/turso.rs, .env.example

resuma update

Bump resuma and resuma-macros in the current project, or reinstall the global CLI.

resuma update              # align project deps with CLI version
resuma update --check      # show versions, no changes
resuma update --cli          # cargo install resuma --force
resuma update --version 0.3.3  # pin a specific release

resuma doctor

Quick check for Rust toolchain, cargo-watch, CLI version, and project Cargo.toml setup.

resuma doctor

resuma dev

Starts the app with hot reload. Installs cargo-watch automatically if missing. Saves to src/ or Cargo.toml trigger a rebuild; the browser refreshes when the dev server comes back.

resuma dev
resuma dev --open
resuma dev --addr 0.0.0.0:8080
resuma dev --skip-runtime

resuma build

resuma build

resuma routes

resuma routes --path src/pages
    resuma routes --generate --path src/pages