LeaderSmart Foundation Files

This is the foundation for the LeaderSmart Next.js app. Built in a previous Claude session with strategy, database design, and architecture decisions already made.

What's in this directory

File	Purpose
package.json	Next.js 15, React 19, Tailwind, Supabase SSR — all dependencies pinned
tsconfig.json	TypeScript config with @/* path alias
next.config.mjs	Next.js config with Supabase image domains
tailwind.config.ts	LeaderSmart brand tokens (brand-700 blue, flame-600 orange)
postcss.config.mjs	PostCSS for Tailwind
.env.example	Environment variable template
.gitignore	Standard Next.js gitignore
src/middleware.ts	Auth middleware on every request
src/lib/supabase/client.ts	Browser-side Supabase client
src/lib/supabase/server.ts	Server component Supabase client
src/lib/supabase/middleware.ts	Session refresh helper
src/lib/types.ts	TypeScript types matching the Supabase schema
src/lib/i18n.ts	Translation dictionary (English + French)
src/lib/cn.ts	Tailwind class merge helper
src/app/globals.css	Global Tailwind styles + utility classes
src/app/layout.tsx	Root layout with Inter font

Database migrations

The project is linked to the Supabase project oisrzurefglwiaeqedyp (leadersmart, EU West). supabase/config.toml is committed, but the remote ref lives in supabase/.temp/, which is machine-local and gitignored — so a fresh clone re-links once:

supabase login                                    # once per machine
supabase link --project-ref oisrzurefglwiaeqedyp
supabase migration list                           # local vs remote
supabase db push                                  # apply pending local files

Known gap: the remote has ~50 migrations recorded that have no local file, because everything before September 2026 was applied straight to the database rather than through this directory. supabase/migrations/ is therefore not yet a replayable history — supabase db reset would not reproduce the schema. Run supabase db pull to backfill the missing files before relying on it.

Quick start

# Install dependencies
npm install

# Copy environment template and fill in your Supabase credentials
cp .env.example .env.local
# Edit .env.local with your anon key

# Verify the foundation compiles
npm run typecheck

You will get errors when you run npm run dev because the app/page.tsx and other route files don't exist yet. That's expected — that's what Claude Code is going to build next.

Database

The Supabase database is already live and complete:

• Project: oisrzurefglwiaeqedyp
• Region: Paris (eu-west-3)
• Dashboard: https://supabase.com/dashboard/project/oisrzurefglwiaeqedyp
• 19 tables with full RLS, 16 WhatsApp templates seeded

Do not recreate the database. Use the existing one via the env vars in .env.local.

Next step

Open CLAUDE_CODE_PROMPT.md (in the parent handoff folder) and paste it as your first message in Claude Code. It will continue the build from here.