Skip to content
VMichael1999Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

NovaCash 📱💰

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.

✨ Características Principales

  • 📊 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.

🛠️ Tecnologías Utilizadas

  • 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

🚀 Cómo Empezar (Desarrollo Local)

Prerrequisitos

  • Asegúrate de tener Node.js instalado.
  • Tener instalada la aplicación Expo Go en tu dispositivo iOS o Android, o un emulador configurado.

Instalación

  1. Clona el repositorio e ingresa al directorio del proyecto:

    cd ExpenseTracker
  2. Instala las dependencias:

    npm install
  3. Inicia el servidor de desarrollo (Metro Bundler):

    npm start
  4. 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.

Limpieza de Caché

Si agregas nuevas dependencias nativas o encuentras errores de sincronización, inicia el proyecto limpiando la caché:

npm start -- -c

🧪 Pruebas Unitarias

La 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

📂 Estructura del Proyecto

/
├── 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

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages