MenuFamille
PWA mobile-first de planification de menus hebdomadaires pour familles béninoises et africaines francophones. L'application permet à une planificatrice de générer un menu de la semaine, de le partager avec sa famille pour recueillir des avis, de gérer un carnet de recettes communautaire et de générer automatiquement une liste de courses.
Conçue pour fonctionner sur réseau lent et hors connexion, avec une interface en français pensée pour le contexte ouest-africain.
Source de vérité
Toute la spécification fonctionnelle et technique est dans docs/MenuFamille_CDC_v3.docx. Les décisions de cadrage du Sprint 0 sont résumées dans docs/decisions.md.
Stack technique
- Front : Next.js 14 (App Router) · Tailwind CSS · shadcn/ui · Zustand
- Back : Supabase (PostgreSQL + Auth + Storage + Edge Functions)
- Infra : Vercel (CI/CD + hébergement) · extension PostgreSQL
pg_trgm
- PWA : Service Worker pour mode hors connexion
Installation locale
# 1. Cloner le repo
git clone <url-du-repo>
cd MenuFamille
# 2. Installer les dépendances
npm install
# 3. Configurer les variables d'environnement
cp .env.local.example .env.local
# Remplir les valeurs Supabase dans .env.local
# 4. Lancer le serveur de développement
npm run dev
L'application est disponible sur http://localhost:3000.
Structure du projet
app/ Next.js App Router (pages et API routes)
lib/ Utilitaires et clients Supabase
supabase/ Client typé, helpers auth
components/ Composants React partagés
ui/ Composants shadcn/ui
supabase/
migrations/ Migrations SQL (domain-split)
seed/ Scripts de données initiales
docs/ Spécifications et documentation
Conventions
Voir CLAUDE.md pour les conventions de commit, le garde-fou de périmètre et le format de session de travail.
