Peppers
Tu coach diario de alimentación: un plan de comidas para el mes, pensado a partir de una
conversación con el coach, una guía para cada día y la lista de la compra que sale de ese plan.
Cuando comes distinto, picoteas o haces deporte, la app recoloca los próximos días para que el
conjunto siga cuadrando con tu objetivo, y te enseña qué ha movido y por qué.
Cómo se calculan las cifras. Las kcal y macros de cada plato se calculan en código a
partir de su receta: la IA solo propone la composición del plato (ingredientes y gramos en
crudo) y el código pone las cifras con una tabla de composición de alimentos, la grasa según el
método de cocción y la ración que te corresponde. El objetivo diario también se calcula en
código (Mifflin-St Jeor y tu actividad), no lo decide el modelo.
Peppers no sustituye el consejo de un profesional médico ni de la nutrición.
Desarrollo
Necesitas Bun (la versión está fijada en .bun-version).
bun install # dependencias
bun run dev # servidor de desarrollo, http://localhost:8080
bun run build # build de producción
bun run lint # ESLint
bun run typecheck # TypeScript
bun run test # tests de la lógica pura
bun run format # Prettier
Copia .env.example a .env y rellénalo con tus propias claves (Supabase, OPENROUTER_API_KEY
para el coach, VAPID y CRON_SECRET para las notificaciones). Cada variable lleva al lado un
comentario que dice para qué sirve y si es opcional.
App móvil
La app de iOS vive en mobile/: Expo / React Native, gestionada con npm (Metro no
corre sobre Bun). Llama a la misma API que la web (/api/v1/*). Antes de tocarla, lee
mobile/AGENTS.md.
cd mobile
npm install
npx expo run:ios
Base de datos
Supabase (Postgres con RLS y Auth). Las migraciones están en
supabase/migrations/ y se aplican con la CLI de Supabase
(supabase db push, siempre tras --dry-run); después, bun run db:types regenera los tipos de
las dos apps. El flujo completo está en docs/agents/verification.md.
Documentación
- CLAUDE.md: arquitectura y las reglas que un cambio no debe romper.
- AGENTS.md: el detalle, con el porqué de cada decisión.
- docs/: guía de diseño, cómo se verifica un cambio y cómo se prueban las cosas.
Construido con
- TanStack Start (React 19 con SSR) y TypeScript
- Tailwind CSS v4 y shadcn/ui
- Supabase
- OpenRouter (Gemini 2.5 Flash para el coach, Gemini 2.5 Pro para el plan
y GPT-5 para descomponer los platos)
- Desplegada en Vercel
