Repe

App de seguimiento de entrenamientos. Minimalista, offline-first, compartible.

Stack

• Frontend: React 18 + Vite + TypeScript
• Estilos: TailwindCSS + shadcn/ui
• Backend: Supabase (PostgreSQL + Auth + Storage)
• PWA: vite-plugin-pwa + Workbox
• Offline: Dexie.js (IndexedDB)
• Hosting: Vercel + Supabase Cloud

Correr en local

La app funciona en modo local sin backend: todos los datos viven en IndexedDB del navegador.

cd gym-tracker
npm install
npm run dev
# abrir http://localhost:5173

Supabase (auth + sync multi-dispositivo) es opcional y se configura recién en Fase 4 — ver docs/09-DESPLIEGUE.md.

Instalar en el teléfono

• Android (APK): descargá gymtracker.apk desde Releases y abrilo en el teléfono (hay que permitir "instalar apps de esta fuente"). Trae notificaciones nativas: el recordatorio de entrenar y el aviso de fin de descanso llegan con la app cerrada. El APK lo genera el workflow Build Android APK (Actions). Detalles y firma de release en docs/16-CAPACITOR.md.
• iOS: el proyecto nativo está en ios/ (Capacitor + Swift Package Manager). Todavía no hay build en la App Store: se compila con Xcode en una Mac y se instala por cable (npm run ios). Pasos en docs/16-CAPACITOR.md §iOS.
• PWA (cualquier dispositivo): abrí la app en el navegador y usá "Instalar" (aparece también en Ajustes → La app). En iOS: Compartir → Agregar a inicio.

Estado actual

• ✅ Fase 1 (MVP): sesión de entreno con series/timer de descanso/calentamiento, biblioteca de 103 ejercicios, historial, PRs automáticos con 1RM (Epley), perfil local, PWA instalable
• ✅ Fase 2: rutinas por días estilo playlist con "Entrenar" en un tap, dashboard de progreso con gráficos (mejor peso por entreno + volumen semanal)
• ✅ Fase 3: galería de fotos de progreso (comprimidas, 100% locales), estadísticas mensuales con distribución muscular, niveles de fuerza por edad/sexo/peso corporal
• ✅ Fase 4: compartir rutinas por QR sin servidor (generar, escanear con cámara, importar con preview)
• ✅ Fase 5 (parcial): RPE por serie, progresión automática +2.5kg, comparador de fotos lado a lado
• ⏳ Pendiente: sync Supabase opcional (requiere cuenta), supersets — ver docs/10-HOJA-DE-RUTA.md

El registro de decisiones y correcciones está en docs/BITACORA.md.

Documentación

Archivo	Descripción
Visión	Qué es, para quién, diferenciadores
Arquitectura	Stack, decisiones técnicas, estructura
Funcionalidades	Spec completa de cada módulo
Esquema DB	Tablas, relaciones, tipos
Sistema de Diseño	Colores, tipografía, componentes
Contratos API	Endpoints, RLS policies
Offline & Sync	Estrategia offline-first
Compartir QR	Sistema de QR para rutinas
Niveles de Fuerza	Estándares por edad/peso
Despliegue	Guía de deploy
Hoja de Ruta	Fases de desarrollo

Prompt de contexto

Ver PROMPT-CONTEXTO.md para usar con Claude/Cursor/Copilot.