Architecture
Why authentication starts with a port
A provider should be replaceable without asking the rest of your application for permission.
8 min readRead article
Notes for building smaller, sharper software.
Architecture decisions, local workflows, and source-owned interface patterns from the public Starter repository.
Application code
Routes and UI
Server actions
depends on
AuthPort
The stable contract
getSession · signIn · signOut · requireUser
Better Auth
Descope
Developer experience
The local loop is part of the starter
Short, deterministic feedback loops are part of the product—especially when humans and coding agents share a repository.
6 min read
Interface
Own the components, not another package
A source-delivered registry gives each product a common vocabulary without turning its interface into a locked dependency.
7 min read