litestar-openapi

What problem does it solve?

Configure Litestar applications to generate consistent OpenAPI documentation, including schema generation plugins, operation metadata, and multiple schema outputs, while ensuring the documentation UX matches runtime behavior.

Core Features & Use Cases

• Configure OpenAPI generation: set title, version, servers, tags, and docs endpoints for a Litestar app.
• Enhance operation metadata and security docs: annotate route operations with summaries, descriptions, responses, and security schemes.
• Customize UI and schema outputs: adjust UI behavior, plugins, and provide multiple OpenAPI schemas for different clients or environments.
• Use Case: teams migrating to OpenAPI-first development or maintaining contract-driven APIs across services.

Quick Start

Create an OpenAPIConfig with a title and version and attach it to your Litestar app to enable contract-driven API docs.