CLAUDE.md and an identical
AGENTS.md giving assistants the conventions to follow, and feather check enforces
the ones that can be enforced — so an assistant can verify its own work rather than
hoping.
Install Feather
One
pip install, then feather new from any directory.Build your first app
Scaffold, migrate and run a working app in about five minutes.
Why Feather exists
The gap between Django and the SPA world, and how Feather fills it.
Deploy it
Docker and Caddy on a single VPS, in eight files.
What’s included
Feather provides production-ready infrastructure so you can focus on your application. Every feature is optional and can be enabled during project creation or added later.The three-layer frontend
Feather builds UIs in three layers, each solving a different problem. The mental model: start with Components for everything static, reach for HTMX when you need server data without a page reload, and only use Islands when you genuinely need client-side state. In practice, 90% of features can be built with just Components and HTMX.Components
Server-rendered Jinja2 macros. No JavaScript, no hydration, just HTML and CSS.
HTMX
Server interactions without page reloads. Forms, search, pagination, like buttons.
Islands
Small JavaScript components for genuinely interactive UI with client-side state.
New to the framework? Read Why Feather for the reasoning behind the
stack, then go straight to the Quickstart.