Development

Guidance for developing and extending this Rust authentication project.

Development workflow

Start by ensuring your local environment is configured and migrations are applied.
Modify or add application code under src/.
If you add or change database models, update migrations and schema files.
Run the app locally and verify behavior.

Build the project:

cargo build

Run the main application:

cargo run

Run the project in release mode:

cargo run --release

Run tests:

cargo test

Run linting or formatting:

cargo fmt
cargo clippy

Apply migrations:

cargo run --bin migrate

Create a new migration manually:

cargo run --bin makemigrations <migration_name>

List migration status:

cargo run --bin showmigrations

Open the interactive SQL shell:

cargo run --bin shell

Open a native Postgres shell:

cargo run --bin dbshell

This repository includes a helper to scaffold app modules.

cargo run --bin startapp myapp

Then update the generated module with your models, handlers, and routes.

src/bin/startapp.rs scaffolds a new self-contained app in src/apps/<name>/ and registers it in src/apps/mod.rs.
Use cargo makemigrations after model changes to generate SQL migrations from src/apps/*/models.rs.