axum-service-architecture

What problem does it solve?

This Skill provides a blueprint for organizing Axum services into clear layers (Router → Handler → Service → Repository) and wiring dependencies via AppState and FromRef, enabling maintainable, scalable Rust web services.

Core Features & Use Cases

• Layered Architecture: Separate routing, business logic, and data access to improve testability and maintainability.
• AppState Dependency Injection: Use FromRef to inject dependencies into handlers without global state.
• Middleware Composition: Build a deterministic middleware stack with Tower ServiceBuilder for observability, timeouts, and retries.
• Modular Router Organization: Compose routers by domain/module for scalable API design.

Quick Start

Create a new Axum service using the layered pattern described above: define AppState, implement Router → Handler → Service → Repository, and wire them together with a Tower middleware stack.