app-setup

App Setup

Use this skill when the user needs to create a new Litestar app, structure an existing app, or configure core application settings.

Workflow

1. Define a minimal Litestar(...) app and register route handlers.
2. Move handlers into routers as complexity grows.
3. Add app-level configuration (debug, openapi_config, logging_config, dependencies, middleware).
4. Add lifespan hooks for startup/shutdown needs.

Minimal Pattern

from litestar import Litestar, get

@get("/health")
async def health() -> dict[str, str]:
    return {"status": "ok"}

app = Litestar(route_handlers=[health])

## Project Pattern

- Create a dedicated `app.py` entrypoint exporting `app`.
- Keep transport concerns (handlers/routers/controllers) separate from services.
- Register routers/controllers via `route_handlers=[...]` on the app.

## App-Level Config Checklist

- `debug` for local development only.
- `openapi_config` for API docs metadata.
- `logging_config` for structured logging.
- `dependencies` for cross-cutting service injection.
- `middleware` for request/response policies.
- lifespan hooks/events for startup resource initialization and cleanup.

## Litestar References

- https://docs.litestar.dev/latest/usage/applications.html
- https://docs.litestar.dev/latest/usage/routing/index.html
- https://docs.litestar.dev/latest/usage/events.html