Project Structure

A Rejoice project follows a predictable structure that makes it easy to find and organize your code.

Directory Layout

The entry point for your application. It creates the app and starts the server:

src/main.rs

use rejoice::App;

rejoice::routes!();

#[tokio::main]
async fn main() {
    let app = App::new(8080, create_router());
    app.run().await;
}

The build script that generates routes at compile time:

build.rs

fn main() {
    rejoice::codegen::generate_routes();
}

This scans your src/routes/ directory and generates the router code.

This directory contains your route files. Each file becomes a route:

Client-side code lives here:

Static assets are served directly from this directory:

Built client assets are output here. This is auto-generated during build and should be in your .gitignore.

Some files are generated automatically and should not be edited:

These are regenerated when you run rejoice dev or rejoice build.