FastAPI application skeleton with HTMX

[troyscott]

Description

Create the base FastAPI application with HTMX frontend, ready for deployment to App Service.

Structure

app/
├── main.py              # FastAPI app entry point
├── routers/             # API route modules
├── templates/           # Jinja2 + HTMX templates
│   ├── base.html        # Layout with HTMX + Tailwind/Pico CSS
│   └── pages/
├── static/              # CSS, JS, images
├── models/              # SQLAlchemy/SQLModel models
├── requirements.txt
└── startup.sh           # App Service startup script

Key decisions

• HTMX for interactive UI (no JS framework)
• Jinja2 for server-side templates
• Pico CSS or Tailwind for styling (lightweight)
• SQLModel for database ORM (FastAPI-native)

Acceptance criteria

• FastAPI app starts locally with uvicorn
• Base template with HTMX loaded
• Home page renders via Jinja2
• Health check endpoint at /healthz
• requirements.txt with pinned versions
• startup.sh for App Service