Tasas Cuba es una aplicación web progresiva (PWA) que permite a los usuarios consultar las tasas de cambio actualizadas del peso cubano (CUP) frente a diferentes monedas como USD, Euro, MLC, entre otras. La aplicación ofrece herramientas de análisis histórico, comparación entre fechas y visualización de tendencias mediante gráficos interactivos y diversos indicadores técnicos.

La aplicación está diseñada para ser intuitiva, rápida y accesible, funcionando tanto en línea como fuera de línea gracias a sus capacidades de PWA. Los datos son proporcionados por la API de elToque, ofreciendo información actualizada sobre el mercado informal de divisas en Cuba.

• Visualización de tasas de cambio actualizadas
• Comparación automática con el día anterior
• Indicadores visuales de tendencia (subida/bajada)
• Selección de fecha para consultar datos históricos
• Modo offline con datos almacenados localmente

• Análisis Gráfico:

  • Visualización de tendencias a lo largo del tiempo
  • Selección de rango de fechas personalizable
  • Múltiples tipos de gráficos (área, línea)
  • Exportación de gráficos en diferentes formatos (PNG, JPEG, PDF)
  • Resumen estadístico detallado

• Indicadores Técnicos:

  • Media Móvil Simple (SMA)
  • Media Móvil Exponencial (EMA)
  • Bandas de Bollinger
  • Índice de Fuerza Relativa (RSI)
  • MACD (Convergencia/Divergencia de Medias Móviles)
  • Oscilador Estocástico

• Comparación de Fechas:

  • Comparación detallada entre dos fechas específicas
  • Cálculo automático de diferencias y porcentajes
  • Exportación de datos comparativos en múltiples formatos

• Conversión entre pesos cubanos (CUP) y las divisas disponibles.
• Cambio de dirección de la conversión.

• Diseño responsive adaptado a dispositivos móviles y escritorio
• Tema oscuro/claro automático (basado en preferencias del sistema)
• Instalable como PWA (Progressive Web App)
• Funcionamiento offline
• Alertas de estado de conexión
• Optimización SEO

• Next.js 15: Framework React con renderizado híbrido (SSR/CSR)
• React 18: Biblioteca para interfaces de usuario
• Postgres: BD relacional Open-Source
• TypeScript: Tipado estático para JavaScript
• Tailwind CSS: Framework CSS utilitario
• Framer Motion: Biblioteca de animaciones
• Recharts: Biblioteca para visualización de datos
• shadcn/ui: Componentes UI reutilizables y personalizables
• date-fns: Manipulación de fechas
• html2canvas/jsPDF: Exportación de gráficos

• Next.js API Routes: Endpoints serverless
• Fetch API: Comunicación con servicios externos
• API de elToque: Fuente de datos de tasas de cambio
• Base de datos Postgres: BD en Postgres para persistir los datos históricos

• next-pwa: Soporte para Progressive Web App
• Vercel: Plataforma de despliegue y hosting
• LocalStorage: Almacenamiento local para funcionamiento offline

La aplicación está desplegada y disponible en: https://tasas-cuba.vercel.app/

Dashboard Principal
Comparación de Fechas	Análisis Histórico
Calculadora Monetaria

• Node.js 18.x o superior
• npm o yarn

1. Clonar el repositorio

git clone https://github.com/usuario/tasas-cuba.git
cd tasas-cuba

2. Instalar dependencias

npm install
# o
yarn install
# o
pnpm install

3. Configurar variables de entorno

Crea un archivo .env.local en la raíz del proyecto con las variables que aparecen en .env.example

4. Iniciar el servidor de desarrollo

npm run dev
# o
yarn dev
# o
pnpm run dev

5. Acceder a la aplicación

Abre http://localhost:3000 en tu navegador.

Las contribuciones son bienvenidas. Para contribuir:

1. Haz un fork del repositorio
2. Crea una rama para tu característica (git checkout -b feature/amazing-feature)
3. Realiza tus cambios y haz commit (git commit -m 'Add some amazing feature')
4. Push a la rama (git push origin feature/amazing-feature)
5. Abre un Pull Request

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

• elToque por proporcionar los datos de las tasas de cambio
• Vercel por el hosting gratuito