Getting Started

Goal

This snapshot advances Redrock Wire by teaching you to create a minimal Axum app on port 8082.

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

Axum builds an async HTTP server with typed handlers on Tokio.

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

Walkthrough

Return JSON from the root path on port 8082.

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

async fn home() -> Json<Value> { Json(json!({"message": "Redrock Wire is live"})) }

Run and verify

Enter 01-Getting-Started, 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/01-Getting-Started
cp .env.example .env
cargo run

Troubleshooting

If the browser cannot connect, confirm cargo run is listening on 8082.

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 /health route that returns JSON ok: true.

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