axum-impl-openapi

What problem does it solve?

This Skill prevents OpenAPI documentation from drifting out of sync with your Axum routes and handler implementations, especially across Axum version differences and mismatched crate versions.

Core Features & Use Cases

• Generate OpenAPI 3 specs from Axum handlers using utoipa derive macros and handler annotations, ensuring operations and schemas reflect the actual Rust types and endpoints.
• Serve an interactive Swagger UI from the same generated spec using utoipa-swagger-ui with the required axum feature.
• Eliminate route/spec drift with OpenApiRouter (utoipa-axum) so each handler is registered once and derived consistently for both routing and documentation.

Quick Start

Ask the AI to produce an Axum service that uses utoipa + utoipa-axum OpenApiRouter to register annotated handlers once, then merges utoipa-swagger-ui SwaggerUi using the generated OpenAPI JSON endpoint.