Skip to content

CamiloCuenca/PomoTimerFlow

Repository files navigation

PomoTimerFlow 🍅⏱️

Una aplicación móvil de Técnica Pomodoro moderna, elegante y personalizable construida con React Native, Expo y NativeWind.

T9FXiKTwLeQF_1024_500

📱 Características

⏲️ Timer Pomodoro Inteligente

  • Sesiones de trabajo configurable (por defecto 25 minutos)
  • Descansos cortos personalizables (por defecto 5 minutos)
  • Descansos largos personalizables (por defecto 15 minutos)
  • Pausar/Reanudar y reiniciar sesiones
  • Intercambio rápido entre sesiones de trabajo y descanso

🎨 Temas Dinámicos

Elige entre 5 temas hermosos que transforman toda la interfaz:

  • 🟢 Verde - Tema por defecto, fresco y natural
  • 🔵 Azul - Calmo y profesional
  • 🟣 Púrpura - Creativo y moderno
  • 🟠 Naranja - Energético y motivador
  • 🔴 Rojo - Intenso y llamativo

Cambiar tema afecta toda la app en tiempo real (header, navegación, botones, gráficos y más).

📊 Estadísticas Detalladas

  • Racha semanal visual (lunes a domingo)
  • Indicador de sesiones completadas con imagen de pomodoro
  • Gráficos de líneas para sesiones de trabajo y descanso
  • Seguimiento semanal de tu productividad

⚙️ Configuración Completa

  • Ajusta duraciones de sesiones de trabajo, descansos cortos y largos
  • Selector de temas personalizado
  • Configuración guardada automáticamente

🔔 Notificaciones

  • Alertas cuando termina cada sesión
  • Recordatorio de próxima sesión
  • Soporte para notificaciones push

💾 Persistencia de Datos

  • Sesiones guardadas automáticamente en AsyncStorage
  • Tema seleccionado se mantiene entre sesiones
  • Historial de sesiones completadas

🚀 Comenzar

Requisitos previos

  • Node.js (v14 o superior)
  • npm o yarn
  • Expo CLI instalado globalmente

Instalación

  1. Clona el repositorio:
git clone https://github.com/CamiloCuenca/PomoTimerFlow.git
cd PomoTimerFlow
  1. Instala las dependencias:
npm install
# o
yarn install
  1. Inicia la aplicación:
npm run start
# o
yarn start
  1. Escanea el código QR con tu dispositivo usando la app Expo Go (disponible en App Store y Google Play)

🛠️ Tecnologías Utilizadas

  • React Native - Framework para aplicaciones móviles
  • Expo - Plataforma de desarrollo para React Native
  • NativeWind - Tailwind CSS para React Native
  • Expo Router - Enrutamiento y navegación
  • React Navigation - Navegación bottom tabs
  • AsyncStorage - Almacenamiento local persistente
  • react-native-gifted-charts - Gráficos de líneas
  • react-native-svg - Gráficos SVG
  • lucide-react-native - Iconos modernos
  • expo-notifications - Sistema de notificaciones

📖 Cómo Usar

Timer Principal

  1. Abre la app en la pestaña Home 🏠
  2. Presiona "Iniciar" para comenzar una sesión
  3. Presiona "Pausar" para pausar la sesión
  4. Presiona "Reiniciar" para resetear el contador
  5. Presiona "Cambiar" para alternar entre trabajo y descanso

Configurar Duraciones

  1. Ve a la pestaña Settings ⚙️
  2. Toca cualquiera de los botones de duración (Pomodoro, Receso, Descanso)
  3. Usa + y - para ajustar los minutos
  4. Presiona "Guardar" para confirmar

Cambiar Tema

  1. Ve a la pestaña Settings ⚙️
  2. En la sección Tema, toca el color que prefieras
  3. La app se actualiza automáticamente 🎨

Ver Estadísticas

  1. Ve a la pestaña Stats 📊
  2. Visualiza tu racha semanal (con pomodoroitos 🍅)
  3. Observa los gráficos de sesiones completadas

🎯 Características Futuras

  • Integración con calendario
  • Análisis mensual y anual
  • Recordatorios diarios
  • Modo enfoque mejorado (bloqueo de apps)
  • Soporte para múltiples idiomas
  • Sonidos y vibraciones personalizables
  • Temas segun festividades (Navidad, halloween, Pascua, etc)

📄 Licencia

Este proyecto está bajo una Licencia Propietaria de Código Fuente Visible.

Esto significa:

  • ✅ Puedes ver y estudiar el código
  • ✅ Puedes hacer fork para aprender
  • ❌ NO puedes usar este código comercialmente
  • ❌ NO puedes redistribuir o crear apps derivadas

Ver el archivo LICENSE para más detalles.

Para solicitar permisos especiales o licencias comerciales, contacta al autor.

👨‍💻 Autor

Juan Camilo Cuenca Sepulveda

⭐ Si te gusta este proyecto, ¡no olvides darle una estrella en GitHub!

Sígueme en redes:

Hecho con ❤️ por Juan Camilo Cuenca Sepulveda

About

Pomodoro timer mobile app built with React Native and Expo.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages