vespera

Generate OpenAPI specs and routes for Axum Rust applications.

27|4|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/dev-five-git/vespera --skill vespera-dev-five-git
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vespera
Source: https://github.com/dev-five-git/vespera/tree/main
Command: npx skills add https://github.com/dev-five-git/vespera --skill vespera-dev-five-git

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vespera eliminates the friction of building and documenting Rust Axum APIs by providing zero-config OpenAPI generation and automatic route discovery.

Core Features & Use Cases

  • File-based routing with automatic route discovery that maps code structure to API paths.
  • Compile-time OpenAPI generation and built-in Swagger/ReDoc endpoints.
  • Schema derivation for Rust types and seamless integration with Serde-annotated models.

Quick Start

Run vespera to auto-generate routes and OpenAPI specs during compile time without manual configuration.

Frequently Asked Questions about vespera

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate OpenAPI specs for Axum without manual boilerplate?

You can generate OpenAPI specs for Axum without boilerplate using zero-config compile-time route discovery. Vespera automates this by applying a macro during cargo build to output openapi.json automatically.

Does file-based routing work automatically with Axum applications?

Yes, file-based routing works automatically with Axum by mapping your code structure directly to API paths. Vespera discovers routes at compile time, eliminating the need to manually register each endpoint.

How do I derive OpenAPI schemas for Serde-annotated Rust models?

You derive OpenAPI schemas for Serde-annotated Rust models by applying the vespera macro. It automatically derives Schema on your API types to ensure compile-time OpenAPI generation.

Can I get built-in Swagger or ReDoc endpoints for my Rust API?

Yes, you can get built-in Swagger and ReDoc endpoints for your Rust API. Vespera provides these endpoints automatically alongside its compile-time OpenAPI generation.

What is the best way to achieve compile-time route discovery in Rust?

The best way to achieve compile-time route discovery in Rust is using a zero-config macro that maps file structure to paths. Vespera handles this automatically during cargo build.

Are there limitations to zero-config OpenAPI generation in Axum?

Zero-config OpenAPI generation in Axum requires the vespera macro and Serde-annotated models. It is limited to Rust projects seeking compile-time route discovery and openapi.json output without manual configuration.