Case Study - A batteries-included Python web framework

Overview

Most Python web projects spend their first week re-implementing the same scaffolding: Google OAuth, a user table, admin pages, a job queue, file uploads, dark mode, a CSP. Feather treats that as solved. It's a full-stack framework on Flask, Tailwind, HTMX, and small vanilla-JS islands, with the boring-but-essential parts already wired up and well-documented.

We designed the conventions and built the framework itself. The CLI scaffolds new apps with optional auth, multi-tenancy, and background jobs. Routes stay thin, services hold business logic, and a three-layer UI model (server-rendered components, HTMX for server interactions, and islands for genuinely client-side state) keeps 90% of features out of the SPA complexity tax.

Feather is built to be productive with AI coding assistants. Every scaffolded project ships with a CLAUDE.md that teaches the assistant the framework's conventions, so an AI helper produces code that fits the codebase instead of fighting it. Alongside the framework, we built the marketing site, the docs, and the templates teams use to spin up new apps.

What we did