Typing And Static Analysis

Type hints, mypy/pyright, Pydantic v2 for runtime validation.

Why we need this / what value this brings

Localz's stack pairs Pydantic (backend) with Zod (frontend) for type parity across the FastAPI/Next.js boundary — getting this right end to end matters.

When to use this

Any new FastAPI endpoint or shared data contract — types should be the source of truth before code is written.

How to use or implement this

Start with Pydantic v2 models for I/O boundaries, add mypy/pyright in CI once the codebase has enough coverage to be useful.

Research questions

• (add as research surfaces open questions)

---

Empty folder — drop notes, links, and findings here as you research.