WallabyDesigns/Larust

A Laravel-shaped web framework for Rust. Larust gives Laravel developers a familiar application structure—routing, validation, templates, an ORM, and xr CLI commands, while keeping the underlying application ordinary, compiled, type-checked Rust built on Axum, sqlx, and tower-sessions.

Website · Documentation · First app guide

Larust is currently used directly from this repository rather than published to crates.io. Generated apps use local path dependencies back to this checkout.

v0.5.0 is the current development line. The framework includes the core web stack, authentication, migrations and relationships, queues and scheduling, named console commands, optional integrations, and a Laravel conversion tool. See MILESTONES.md for the development history and rust-laravel.md for the original design rationale and Laravel-to-Rust comparisons.

git clone https://github.com/wallabydesigns/Larust.git
cd Larust
./install.sh

git clone https://github.com/wallabydesigns/Larust.git
Set-Location Larust
.\install.ps1

The install scripts build Larust's xr CLI from this checkout and place it in Cargo's bin directory. If your shell cannot find xr afterward, follow the PATH guidance printed by the script.

xr new examples/myapp --auth
cd examples/myapp
xr migrate
xr dev

Open http://127.0.0.1:34187. --auth adds a User model, registration, login/logout, and auth/guest route protection; omit it for a smaller starting point.

From an app directory, xr handles framework tasks and forwards named commands you register in routes/console.rs to the application itself:

xr route:list
xr make:controller CommentController --resource
xr make:model Category --migration

The bundled reference app includes a real named command:

cd ../../examples/blog
xr command:list
xr report:posts

For the complete command reference—including deployment, background work, database utilities, and app-defined commands—see The xr CLI.

From the Larust checkout, run framework commands through Cargo instead:

cargo run -p larust-cli -- new examples/myapp --auth

Inside a generated app, its own binary accepts the same app-facing commands:

cargo run -- migrate
cargo run -- route:list
cargo run

examples/blog is the reference app. It demonstrates auth, a Post model that belongs to its author, CSRF-protected forms, session flash messages, route model binding, and a custom console command.

crates/
├── larust-core, larust-http, larust-orm, larust-validation, larust-view
│   Foundation: application bootstrap, routing, persistence, validation, views
├── larust-auth, larust-cache, larust-console, larust-db, larust-events
│   Application services: auth, cache, commands, key-value storage, events
├── larust-mail, larust-notifications, larust-queue, larust-scheduler
│   Background and communication services
├── larust-live, larust-spa, larust-reverb, larust-storage
│   Interactive UI, real-time, and file-storage capabilities
├── larust-permissions, larust-sanctum, larust-shield, larust-socialite
│   Optional security and identity integrations
├── larust-cli, larust-convert, larust-testing, larust-support
│   Tooling, Laravel conversion, testing, and generated-app facade
└── …additional focused crates for language support, repositories, sitemaps,
   SQL Server, and procedural macros
examples/
└── blog  Reference application exercising Larust end to end
demo/     Standalone demonstration application

Generated apps depend directly on larust-core, larust-http, larust-support, tokio, and sqlx. larust-support exposes the rest of Larust's application-facing API; the architecture guide explains why sqlx remains a direct dependency.

cargo build --workspace
cargo test --workspace
cargo clippy --workspace -- -D warnings
cargo fmt --check

Enable the repository's pre-push hook once to run the same fast compile gate used first in CI:

git config core.hooksPath .githooks

The hook runs cargo check --workspace --all-targets --locked. See CONTRIBUTING.md for contribution guidance, SECURITY.md for security reports, and CODE_OF_CONDUCT.md for community expectations.

AI models were used to assist documentation as they are far better at documentation than I am.

Licensed under the Apache License, Version 2.0.