Example: REST API with Rust + Axum

End-to-end pattern: plan → scaffold → implement in layers → test.

Prerequisites

Rust toolchain (see Installation)
PostgreSQL (local or Docker)
Provider API key or Ollama

Scaffold

cargo new blog-api && cd blog-api

Add dependencies (axum, tokio, sqlx, serde, thiserror, tower-http, tracing, auth crates, …) to Cargo.toml.

Plan

akmon --plan --task "blog REST API: register/login, JWT middleware,
CRUD posts, SQLx + Postgres pool, layered handlers,
custom ApiError as IntoResponse, GET /health"

Review .akmon/plans/*.md before implementation.

Implement incrementally

Typical sequence:

error.rs — error types + IntoResponse
state.rs — shared PgPool
Repositories / services
Routes + integration tests (sqlx::test)

akmon --yes --task "implement error + state modules from the plan"
akmon --task "implement repositories and handlers per plan"

Run

docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=postgres postgres:16
export DATABASE_URL=postgres://postgres:postgres@localhost/blog_api
sqlx database create && sqlx migrate run
cargo run

Follow-ups

add cursor-based pagination to GET /posts

add utoipa OpenAPI spec and Swagger UI

Akmon