Kilio

Application personnelle mono-utilisateur (PWA, mobile d'abord) qui centralise nutrition, agenda, courses, tâches, habitudes, documents, notes, collection, pharmacie, musculation et le carnet « Vider ma tête ». La description produit complète est dans PRODUCT.md, le design system dans DESIGN.md.

Stack : Next.js 16 (App Router, Turbopack), React 19, TypeScript, Tailwind CSS v4, Supabase (Postgres, Storage, Edge Functions), TanStack Query, Dexie (cache et file hors ligne). Déployé sur Vercel, branche par défaut kiliomain.

Cette version de Next.js a des changements incompatibles : lire AGENTS.md et les guides de node_modules/next/dist/docs/ avant de coder.

Démarrer

npm ci
npm run dev        # http://localhost:3000

Il faut un fichier .env.local (jamais commité). Variables lues par le code :

Variable	Rôle
NEXT_PUBLIC_SUPABASE_URL	URL du projet Supabase
SUPABASE_SERVICE_ROLE_KEY	Clé de service, côté serveur uniquement : toutes les lectures et écritures passent par elle
NEXT_PUBLIC_VAPID_PUBLIC_KEY	Clé publique des notifications push
GEMINI_API_KEY	Transcription de « Vider ma tête » et Réveil
VIDAGE_SESSION_SECRET	Secret de session (32 caractères minimum) ; sans lui, « Vider ma tête » reste fermé
AGENDA_FEED_TOKEN	Jeton du flux ICS de l'agenda

Les Edge Functions lisent en plus VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY et VAPID_SUBJECT (secrets Supabase).

Commandes

Commande	Rôle
npm run lint	ESLint
npm run typecheck	Types de routes puis tsc --noEmit
npm test	Tests unitaires (Vitest, mode watch ; npx vitest run pour une passe unique)
npm run test:instant	Banc e2e de navigation instantanée, avec un faux Supabase (voir instant-nav.rig.md)
npm run analyze	Analyse du poids des bundles
npm run knip	Détection de code inutilisé

La CI (.github/workflows/ci.yml) lance lint, typecheck et Vitest (job verifier), puis le banc e2e (job e2e).

Structure

• src/app/(app)/<module>/ : pages et composants de chaque module (loading.tsx quand la page attend des données).
• src/app/actions/ : Server Actions par domaine, avec leurs tests.
• src/lib/<domaine>/ : logique métier (calculs purs dans compute.ts, hors ligne, Gemini, vidage…).
• src/lib/offline/ : cache Dexie et file des écritures hors ligne (voir flush-policy.ts pour les règles de rejeu et d'abandon).
• supabase/functions/ : Edge Functions (notifications push, nettoyage), appelées par pg_cron. Elles ne sont pas déployées par la CI : après une modification, les redéployer sur Supabase.
• scripts/ : migrations SQL datées, appliquées à la main (voir ci-dessous).
• reports/ : journaux d'audit et de décisions, datés ; le code fait foi.

Base de données

Le schéma initial n'est pas versionné dans ce dépôt : la base de production est la référence. Les fichiers scripts/migration-*.sql sont des changements datés, sans outil de suivi : vérifier l'état réel de la base avant d'en rejouer un. La sécurité par ligne (RLS) est activée sur toutes les tables de public sans règle d'accès : seule la clé de service lit et écrit. Les buckets de stockage sont publics (lecture par adresse), sauf vider-tete.