| name | litestar-plugins |
| description | Auto-activate for plugins=, InitPlugin, CLIPluginProtocol, SerializationPluginProtocol, OpenAPISchemaPluginProtocol, AutowirePlugin, or app plugin lists. Not for package installation. |
Litestar Plugins
Use this skill for plugin composition, first-party plugin setup, plugin protocol authoring, and app startup wiring.
Code Style Rules
- Prefer first-party Litestar plugins where they exist.
- Keep plugin configuration near app setup or settings modules.
- Use
InitPlugin for reusable app initialization; keep protocol names for legacy code and non-init hooks.
- Keep domain routes and plugin lifecycle concerns separated.
Quick Reference
- Plugin patterns: plugins.md
- Pair with litestar-autowire for
domain-package controller and listener discovery.
- Pair with focused first-party plugin skills when available.
Workflow
- Identify whether the task is app composition or plugin authoring.
- Use existing first-party plugins before custom glue.
- Register plugins in app setup with settings-backed config.
- Test startup, shutdown, CLI, or schema behavior touched by the plugin.
Guardrails
- Do not hide route logic inside plugin setup.
- Do not add a custom plugin where a plain provider or middleware is enough.
- Do not scatter plugin config across unrelated modules.
- Do not bypass first-party plugins for common integrations.
Validation Checkpoint
Example
from litestar import Litestar
from litestar_autowire import AutowireConfig, AutowirePlugin
app = Litestar(
plugins=[
AutowirePlugin(
AutowireConfig(domain_packages=["app.domain"]),
)
],
)
References Index
Official References
Shared Styleguide Baseline