Litestar Routing

Use this skill for route handlers, Controllers, Routers, domain clustering, and endpoint module layout.

Code Style Rules

• Cluster Controllers by domain, not HTTP method.
• Keep handlers thin: parse request data, call a service, return a DTO or response object.
• Put shared path, dependencies, guards, and tags on the Controller class.
• Prefer the typed markers FromPath[T] / FromQuery[T] / FromHeader[T] / FromCookie[T] (Litestar ≥ 2.22) over Annotated[T, Parameter()]; never use the field = Parameter(...) default form (removed in 3.0).
• Use typed path parameters and explicit return annotations.

Quick Reference

• Controller and route patterns: routing.md
• Domain folder layout: domains.md
• End-to-end vertical slice: example.md