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.
