Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

EnergyLoop Logo

⚡ EnergyLoop

Plataforma Inteligente de Nutrición, Balance Energético y Fitness de Alto Rendimiento

Acerca de • Galería • Características • Tecnología • Experiencia • Instalación

React 19 TypeScript Vite Gemini AI Supabase Porsche Design


🌟 Acerca de EnergyLoop

EnergyLoop transforma la gestión de la nutrición y el entrenamiento físico mediante una interfaz vanguardista y asistencia de Inteligencia Artificial. Diseñada bajo los estándares visuales de Porsche Design System, la plataforma ofrece una visión completa, precisa y elegante del ciclo de energía corporal diario.

Permite a los usuarios tomar control total sobre sus objetivos metabólicos, registrar comidas mediante visión computacional, monitorear la hidratación y analizar la evolución de sus entrenamientos en tiempo real.


📱 Capturas de Pantalla

Inicio & Autenticación
Inicio & Bienvenida
Dashboard Principal
Dashboard & Balance Calórico
Historial y Métricas
Historial & Métricas Semanales
Ajustes de Perfil
Ajustes & Metas Nutricionales
Asistente TMB - Wizard
Asistente TMB (Wizard)
Cálculo del Plan Metabólico
Cálculo del Plan Metabólico
Registro de Comidas
Registro de Comidas (Selección)
Detalles de Comida y Porciones
Porciones y Macronutrientes
Registro de Ejercicios e Intensidad
Registro de Ejercicios & Quema Calórica

🔥 Características Principales

📸 Escáner de Nutrición Inteligente con IA

  • Reconocimiento Visual: Analiza fotos de platillos e identifica automáticamente ingredientes, porciones y desglose nutricional gracias a Google Gemini AI.
  • Lectura Instantánea: Clasificación automática de calorías y macronutrientes sin necesidad de búsqueda manual constante.

⚖️ Balance Energético Dinámico

  • Análisis Ingerido vs. Quemado: Cálculo automatizado del déficit o superávit calórico diario.
  • Calorie Ring: Indicador circular interactivo con microanimaciones para un progreso visual inmediato.

🥩 Control de Macronutrientes e Hidratación

  • Objetivos Personalizados: Barras de progreso en tiempo real para Proteínas, Carbohidratos y Grasas.
  • Seguimiento de Hidratación: Registro rápido de consumo de agua diario con metas personalizables según el perfil biológico.

🏋️ Registro de Entrenamientos y Actividad

  • Gastos Calóricos: Seguimiento de sesiones de ejercicio, calorías quemadas y minutos activos.
  • Biblioteca Integrada: Clasificación por intensidad y tipo de ejercicio con cálculo automático de impacto energético.

📈 Analítica e Historial Avanzado

  • Métricas Semanales: Gráficos intuitivos para evaluar consistencia, promedios calóricos y hábitos de consumo a lo largo del tiempo.
  • Filtros Históricos: Navegación por fechas y registros detallados día por día.

🛠️ Stack Tecnológico

Capa Tecnología Descripción
Frontend UI React 19 + TypeScript Arquitectura modular, moderna y con tipado estricto.
Diseño & Estilos Porsche Design System + TailwindCSS v4 Componentes de nivel enterprise con estética minimalista y deportiva.
Animaciones GSAP (GreenSock) Transiciones fluidas entre pantallas y animaciones de contador en tiempo real.
Inteligencia Artificial Google Gemini AI (@google/generative-ai) Procesamiento multimodal para análisis automático de alimentos.
Backend & Base de Datos Supabase Persistencia en la nube, sincronización en tiempo real y autenticación.
Build Tool Vite 8 Entorno de desarrollo ultra rápido y bundling optimizado.

💎 Pilares de Experiencia

  • Diseño Premium & Moderno: Interfaz pulida con soporte nativo para Modo Oscuro y Modo Claro, cuidando cada detalle tipográfico y espacial.
  • Feedback Háptico Visual: Respuestas dinámicas ante cada interacción mediante componentes interactivos y animaciones fluidas.
  • Precisión Biométrica: Ajustes personalizados basados en TMB (Tasa Metabólica Basal) y nivel de actividad física del usuario.

🚀 Instalación y Configuración

Sigue estos pasos para ejecutar el proyecto en tu entorno local:

📋 Prerrequisitos

  • Node.js (versión 18.0 o superior recomendada)
  • pnpm (npm install -g pnpm)

1. Clonar el Repositorio

git clone https://github.com/tu-usuario/EnergyLoop-FitApp.git
cd EnergyLoop-FitApp

2. Instalar Dependencias

pnpm install

3. Configurar Variables de Entorno

Copia el archivo de plantilla .env.example para crear tu .env local:

cp .env.example .env

(En Windows PowerShell puedes usar Copy-Item .env.example .env)

Luego, abre el archivo .env y completa tus credenciales:

# Conexión con Supabase
VITE_SUPABASE_URL=https://tu-proyecto.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=tu-supabase-publishable-key

# API de Google Gemini (Visión y Reconocimiento de Alimentos con IA)
VITE_GEMINI_API_KEY=tu-gemini-api-key

Nota:

  • Puedes obtener las credenciales de Supabase creando un proyecto en Supabase.
  • La clave de Google Gemini se obtiene en Google AI Studio.

4. Ejecutar la Aplicación

Inicia el entorno de desarrollo local con Vite:

pnpm dev

Abre tu navegador en la URL indicada en consola (usualmente http://localhost:5173).


📜 Scripts Disponibles

Comando Descripción
pnpm dev Inicia el servidor de desarrollo en tiempo real.
pnpm build Chequea tipos TypeScript y compila la app optimizada para producción.
pnpm preview Previsualiza el build de producción en un servidor local.
pnpm lint Ejecuta ESLint para verificar buenas prácticas y estilo de código.

Diseñado con pasión por la salud, la tecnología de vanguardia y el diseño de alto rendimiento.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages