CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Tia is a baby tracking app built with Next.js 15/16, designed for a Mama to track her baby's feeds, sleep, diapers, vaccinations, growth, and memories. The app features offline-first logging, AI-powered Q&A, and a Telegram alert system.

Common Commands

# Development
pnpm dev              # Start local dev server
pnpm build             # Production build
npm ci                # Clean install for Docker

# Database (Drizzle)
npx drizzle-kit generate  # Generate migration from schema
npx drizzle-kit push    # Push schema to DB

Environment Variables

Required in .env.local:

DATABASE_URL=postgresql://tia:tia_local_dev@localhost:5433/tia_dev
AUTH_SECRET=
AUTH_URL=http://localhost:3000
RESEND_API_KEY=

Hits & Learned Lessons

Build Issues Fixed

pnpm 11 + Node 20 incompatibility: pnpm 11 requires Node 22+. Fixed by using Node 22 in Dockerfile.
pnpm ignored builds in Docker: Had to switch from pnpm to npm in Dockerfile (npm ci instead of pnpm install).
Drizzle adapter type errors: Using simplified DrizzleAdapter without passing table configs directly fixes type errors.
nodemailer missing: NextAuth email provider requires nodemailer as a dependency.
Middleware warning: Next.js 16 shows deprecation warning for middleware file convention.

Database Setup

Local: Docker Compose with pgvector on port 5433, Redis on 6380
Schema: 8 tables (users, accounts, sessions, verification_tokens, families, family_members, children, family_invites)
Migrations: Run via npx drizzle-kit push or docker exec with SQL files

Docker Build

Use npm ci instead of pnpm in Docker for reliability
Node 22 alpine image
Multi-stage build (deps → builder → runner)
Need to install nodemailer separately for email auth

Architecture

Framework: Next.js 16 (App Router) with TypeScript
Database: PostgreSQL 16 with pgvector (Drizzle ORM)
Auth: NextAuth v5 beta
Deployment: Dokploy (Docker)

Sprint Plan

Current: Sprint 1 (Database + Auth)

Sprint 0: Dev environment, Docker, Dokploy deploy ✅
Sprint 1: Auth + Database with RLS (in progress)
Sprint 2: Fast-log engine
Sprint 3: Medical vault
Sprint 4: Media pipeline
Sprint 5: AI Brain
Sprint 6: UI/UX polish
Sprint 7: Telegram alerts + launch

Key Files

src/auth.ts - NextAuth configuration
src/db/schema/auth.ts - Auth tables (users, sessions, accounts)
src/db/schema/family.ts - Family, members, children tables
src/app/login/page.tsx - Login page
Dockerfile - Production build (uses npm, not pnpm)

2.7 KiB Raw Blame History