MyWallet

Aplicación personal de control financiero para Android. Local-first: funciona completa sin internet y los datos viven en el dispositivo (SQLite). Con cuenta de Google (opcional) se respaldan en Firebase y se pueden compartir listas con otras personas — sin backend propio. Ver SYNC_ROADMAP.md.

🔗 Web oficial: https://usemywallet.vercel.app 🔒 Política de privacidad: https://usemywallet.vercel.app/es/privacy ⬇️ Descargar el APK: https://github.com/JhonnyXT/my-wallet-app/releases/latest/download/MyWallet.apk 🗑️ Eliminar cuenta: https://usemywallet.vercel.app/es/delete-account

Features

• Dashboard con balance, gráfica de gastos por categoría y lista de transacciones.
• Categorías dinámicas, personalizables por el usuario (emoji + nombre + color).
• Detección automática de transacciones: lee las notificaciones de tus apps bancarias (Bancolombia, Nequi, Davivienda, DaviPlata, BBVA, Nubank, y otras más) y arma un borrador de transacción para que lo confirmes — nunca guarda nada sin tu aprobación.
• Entrada por voz: dicta un gasto o ingreso y la app lo interpreta.
• Chat NLP experimental: escribe en lenguaje natural ("almuerzo 15000") y la app extrae monto, categoría y fecha.
• Presupuestos por categoría con alertas push al acercarte o superar el límite.
• Metas de ahorro con abonos que se registran como gasto en el balance, y deudas con recordatorio mensual.
• Listas (un viaje, la casa, el negocio…) con sus propias categorías, presupuestos y período; quién pagó cada gasto y quién le debe a quién; exportar/importar CSV por lista.
• Cuenta de Google opcional: respaldo automático en la nube y listas compartidas con otras personas (cada una desde su teléfono, uniéndose con un código).
• Modo oscuro (sistema / claro / oscuro) en toda la app.

Stack técnico

Capa	Tecnología
Lenguaje	TypeScript (strict)
Framework	React Native + Expo (SDK 55)
Routing	Expo Router (file-based)
Estado	Zustand
Base de datos	expo-sqlite (WAL mode), sin ORM
Estilos	NativeWind (Tailwind) + StyleSheet
Notificaciones	expo-notifications + react-native-android-notification-listener (HeadlessJS)
Cuenta y sync	Firebase (Auth con Google + Firestore) vía @react-native-firebase, solo en src/sync/

Instalación y arranque

Requisitos: Node.js ≥ 20, Android SDK, Java 17.

npm install   # .npmrc ya fija legacy-peer-deps=true (React 19 vs librerías con peer React 18)

Desarrollo:

npx expo start          # Metro bundler
npx expo run:android    # build + ejecución directa en dispositivo/emulador

Build de producción (APK release):

cd android
./gradlew assembleRelease

El APK queda en android/app/build/outputs/apk/release/app-release.apk. Instalar con adb install -r <ruta-al-apk>.

Estructura del proyecto

my-wallet-app/
├── app/            # Rutas (Expo Router): dashboard, chat, modales de gasto/ingreso/voz/ajustes
├── src/
│   ├── components/ # Componentes UI reutilizables
│   ├── db/         # SQLite: esquema, CRUD, queries agregadas
│   ├── services/   # Notificaciones (push + detección bancaria en background)
│   ├── store/      # Stores Zustand
│   ├── sync/       # Única capa con red: sesión con Google, respaldo y listas compartidas (Firebase)
│   ├── theme/       # Tokens de diseño (light/dark)
│   └── utils/       # Formateo de moneda, parser de notificaciones, NLP de voz/texto
├── android/        # Proyecto Android nativo
├── landing/        # Web oficial (Next.js en Vercel): portada, política, eliminar cuenta
└── docs/           # GitHub Pages: solo redirige a la web oficial

Estado del proyecto

Versión actual: 1.0.0 (lanzamiento; descarga en GitHub Releases, Google Play pendiente). El build prod se firma con la keystore de producción que guarda EAS (npm run eas:prod para el AAB de Play, npm run eas:prod:apk para el APK). Deuda técnica conocida: Jest cubre utilidades puras y notificationParser, pero componentes/stores/src/db/ (SQLite) todavía no tienen estrategia de testing. Detalle completo en AGENTS.md.

Documentación

Este README es la puerta de entrada rápida. Para profundizar:

• AGENTS.md — guía maestra del repo: arquitectura, convenciones, reglas inmutables, sistema de agentes IA (Cursor/Claude Code), gotchas técnicos.
• CONTEXT.md — contexto técnico exhaustivo: interfaces, flujos, pantallas.
• DOCUMENTATION.md — manual de usuario final.
• PRODUCT_REQUIREMENTS.md — historias de usuario y requisitos.

Licencia

Proyecto personal, sin licencia pública de uso/distribución.