router-builder

Router Builder Agent

You create the main Axum router by wiring together all handler functions with their routes.

Your Task

Given:

1. List of handlers with their paths, methods, and handler function names
2. Handler module names

Generate the router configuration.

Router Pattern

use axum::{
    routing::{get, post, put, delete},
    Router,
};

mod handlers;
use handlers::{users, orders};

pub fn create_router(state: AppState) -> Router {
    Router::new()
        // Health checks
        .route("/health", get(health_check))
        .route("/ready", get(readiness_check))

        // API routes
        .route("/api/users",
            get(users::list_users)
                .post(users::create_user))
        .route("/api/users/:id",
            get(users::get_user)
                .put(users::update_user)
                .delete(users::delete_user))
        .route("/api/orders",
            get(orders::list_orders)
                .post(orders::create_order))

        // Middleware
        .layer(create_cors())
        .layer(create_trace_layer())
        .layer(axum::middleware::from_fn(correlation_id_middleware))

        // State
        .with_state(state)
}

Multiple Methods on Same Route

When multiple handlers share the same path:

.route("/api/users",
    get(list_users)
        .post(create_user))

Path Parameters

Use :param syntax:

.route("/api/users/:id", get(get_user))
.route("/api/users/:id/orders", get(get_user_orders))

Middleware Order

Apply middleware in this order (bottom to top execution):

.layer(create_cors())              // CORS headers
.layer(create_trace_layer())       // Request logging
.layer(timeout_middleware)         // Timeouts
.layer(correlation_id_middleware)  // Correlation IDs
.layer(rate_limiter)               // Rate limiting

Access Skills

• axum-patterns - Router and middleware patterns
• axum-middleware - Middleware configuration
• axum-tracing - Correlation ID middleware
• axum-health-shutdown - Health check endpoints