NovaCash es una aplicación móvil financiera construida con React Native y Expo. Diseñada con una estética moderna de tema oscuro ("Rojo y Negro"), la aplicación permite a los usuarios llevar un registro rápido e intuitivo de sus ingresos y gastos diarios, inspirada en las mejores prácticas de UX de aplicaciones como Monefy.
- 📊 Dashboard Visual: Gráfico interactivo para visualizar el balance general y el porcentaje de gastos por categoría.
- 💸 Gestión de Transacciones: Calculadora integrada para ingresar montos rápidamente antes de elegir una categoría.
- 🗂️ Categorización Inteligente: Cuadrícula de 9 categorías de gastos (incluyendo Alimentación, Mascotas, Educación, etc.) y múltiples opciones de ingresos, completamente iconizadas.
- 🌍 Divisas Personalizables: Soporte global para cambiar la moneda de visualización (ej. USD, EUR, Soles).
- 💾 Persistencia Local: Todo el historial financiero y las configuraciones del usuario se guardan automáticamente en el dispositivo, incluso si se cierra la aplicación.
- 🛡️ Arquitectura Robusta: Manejo de errores globales y prevención de cierres inesperados (Error Boundaries) junto con pruebas unitarias estructurales.
- Framework: React Native & Expo (SDK 54)
- Lenguaje: TypeScript
- Navegación: Expo Router
- Gestor de Estado: Zustand (con persistencia a través de AsyncStorage)
- Visualización de Datos: React Native Gifted Charts
- Iconografía: Lucide React Native
- Pruebas: Jest & Jest Expo
- Asegúrate de tener Node.js instalado.
- Tener instalada la aplicación Expo Go en tu dispositivo iOS o Android, o un emulador configurado.
-
Clona el repositorio e ingresa al directorio del proyecto:
cd ExpenseTracker -
Instala las dependencias:
npm install
-
Inicia el servidor de desarrollo (Metro Bundler):
npm start
-
Escanea el código QR:
- Android: Abre la aplicación Expo Go y escanea el QR que aparece en la terminal.
- iOS: Abre la cámara de tu iPhone y escanea el QR para que se abra automáticamente en Expo Go.
Si agregas nuevas dependencias nativas o encuentras errores de sincronización, inicia el proyecto limpiando la caché:
npm start -- -cLa aplicación cuenta con pruebas unitarias para garantizar que la lógica matemática del estado y del balance siempre sea precisa. Para ejecutar las pruebas:
npm test/
├── app/ # Rutas de navegación (Expo Router)
│ ├── _layout.tsx # Layout principal y Error Boundary
│ ├── index.tsx # Dashboard principal (Gráficos y Balance)
│ └── add.tsx # Pantalla de creación (Calculadora y Categorías)
├── src/
│ ├── components/ # Componentes de UI reutilizables
│ ├── constants/ # Fuentes únicas de verdad (Categorías, Colores)
│ ├── store/ # Lógica de Zustand y persistencia
│ │ └── __tests__/ # Pruebas unitarias
│ ├── theme/ # Tokens de diseño y colores
│ └── types/ # Interfaces TypeScript
└── README.md