fasthtml-starter — a FastHTML + UserHarbor starter for apps with user accounts

[SpaceShaman]

Hi everyone! I’d like to share fasthtml-starter, a GitHub template for building FastHTML apps with user accounts already wired up.

I built it to show how UserHarbor, my Python library for authentication, authorization, and user management, fits into a FastHTML app. FastHTML renders the pages on the server, and HTMX handles partial page updates.

presentation.mp4

What’s included

• Registration, email verification, and login
• Password recovery, password changes, and account deletion
• User profiles and a paginated user list
• A UI built with fasthtml-basecoatui, fasthtml-tailwindcss, and fasthtml-lucide

Run it locally

Click Use this template on GitHub, clone your copy, and run the following commands.

uv sync
cp .env.default .env

Set your secret key and email settings in .env, then start the app.

cd app
uv run --env-file ../.env uvicorn main:app --reload

Open http://localhost:8000.

Build it step by step

I also wrote a tutorial that walks through building the same app from scratch and shows how the UserHarbor account flows connect to FastHTML routes and pages.

• Starter repository
• FastHTML + UserHarbor tutorial

If you try the template or follow the tutorial, I’d love to hear what you think!