Axum Framework Guide

Applies to: Axum 0.7+, Rust Web APIs, Microservices Complements: .claude/skills/rust-guide/SKILL.md

Core Principles

1. Tower-First: Axum is built on Tower; embrace Service, Layer, and middleware composition
2. Type-Safe Extraction: Use compile-time extractors for request data -- no manual parsing
3. Async Throughout: All handlers are async; never block the Tokio runtime
4. Modular Routing: Compose routers with merge and nest; separate public from protected routes
5. Structured Errors: Implement IntoResponse for custom error types; return appropriate HTTP status codes

Project Structure

myproject/
├── Cargo.toml
├── src/