Nidus Documentation

Nidus is a modular Rust backend framework that keeps framework behavior explicit while providing typed dependency injection, module graphs, Axum routes, Tower middleware, validation, OpenAPI, observability, testing, and separately installable adapters. It uses Axum, Tower, Tokio, serde, garde, utoipa, and tracing directly instead of replacing the Rust web ecosystem.

Start

• Installation
• Getting Started
• CLI

Concepts

• Mental Model
• Modules
• Providers / DI
• Controllers / Routes
• Guards
• Validation / Pipes
• Interceptors / Tower Middleware

Runtime

• Config
• Error Handling
• OpenAPI
• Observability
• Events
• Jobs
• Testing

Production

• Production Defaults
• Deployment
• Security Notes
• Performance

Ecosystem

• Official Adapters
• SQLx
• Cache
• Examples

Reference

• Architecture
• API Reference
• Release 1.0.4
• Release 1.0.3

Current Status

Nidus 1.0.0 established the public crate set. The current release track is 1.0.4, with work focused on launch hygiene, documentation, starter project depth, example proof, and package verification across every publishable crate.

Use the README for the shortest quickstart, these guides for the deeper mental model, and website/ for the generated GitHub Pages portal.