Routing

Goal

This snapshot advances Redrock Wire by teaching you to organize page routes with the Axum Router.

Every numbered folder is a complete app. Run this stage independently, then compare it with the previous folder.

Prerequisites

Use Rust 1.75+, Cargo, and a terminal. No Docker is required for SQLite stages.

Port 8082 must be free. Copy .env.example before starting database stages.

• Rust and Cargo
• A code editor and terminal
• Optional Docker only if you prefer another database later

Concepts

Router::new maps methods and paths to handlers.

Keep handlers thin: extractors accept input, sqlx queries enforce rules, and Askama escapes output by default.

Walkthrough

Add home, about, and health routes.

Read the example, then open the matching snapshot. The repository includes the surrounding setup and error handling.

Router::new().route("/", get(home)).route("/about", get(about))

Run and verify

Enter 02-Routing, copy .env.example, run cargo run, and start on port 8082.

Open http://127.0.0.1:8082. Watch the terminal for validation and database errors.

git clone https://github.com/michaeldunga1/fcc-axum-blog.git
cd fcc-axum-blog/02-Routing
cp .env.example .env
cargo run

Troubleshooting

A missing route leaves the path undefined.

For database failures, confirm Docker and the *.db name when applicable. Never commit .env or *.db.

• Read the first error first
• Restart after environment changes
• Never commit secrets

Try this

Add a /contact plain-text route.

Test a happy path and one invalid or unauthorized request.

• Make one small change
• Test it in the browser
• Compare with the next snapshot only after it works