Application

TanStack Start handles the React app, server functions, routing, and Nitro deployment target.

UI primitives are Tailwind-based and tokenized through CSS variables so your design system can replace them without changing feature logic.

Data model

Better Auth owns users, sessions, accounts, and verification records. Household-specific tables track profiles, todos, events, meal plans, recipes, grocery items, and future assistant conversations.

Deployment

Docker is the canonical runtime. The repo includes a production Dockerfile and a compose stack with the app and PostgreSQL containers for local use or self-managed VPS hosting.

Wishlist AI

The assistant UI is a placeholder for the next phase. The intended design is provider-backed chat with tool access to the same server functions used by the app.