CLAUDE.md and an identical
AGENTS.md setting out the conventions, and feather check enforces the ones that can be
enforced. That combination is what lets an assistant check its own work instead of
guessing.
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.
Build a real app, step by step
Six parts, from a static page to a deployed multi-tenant SaaS. Includes the prompts to
hand Claude at each step.
Why Feather exists
The gap between Django and the SPA world, and how Feather fills it.
What’s included
All of this is optional. Turn a feature on when you create the project, or add it later.The three-layer frontend
Start with components for anything static. Reach for HTMX when you need server data without a page reload. Use islands only when state has to live in the browser. Most features never get past the first two.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 UI that needs client-side state.
Learning the framework
The Kanban tutorial is the fastest way in. It’s one application built across six parts, starting with a hardcoded HTML page and ending with a multi-tenant SaaS on your own domain. Each part introduces one layer, carries the full code, and gives you the prompt to hand a coding assistant if you’d rather not type it.1 to 3: the basics
Templates, a database, HTMX, then drag-and-drop.
4 to 5: a real app
Google sign-in, roles, file storage, then tenant isolation.
6: ship it
Docker, Caddy, backups and CI on one VPS.
Prefer the reference route? Read Why Feather for the reasoning behind the
stack, then go to the Quickstart.