Skip to content

Una app web para registrar y analizar gastos e ingresos, que funciona totalmente de forma local y permite guardar y restaurar tus datos sin depender de terceros.

License

Notifications You must be signed in to change notification settings

tomas2305/platito

Repository files navigation

This project is open source and intended primarily as a personal portfolio and learning project.

platito1 platito2 platito3 platito4

💰 Platito

Platito es una aplicación web progresiva (PWA) de gestión financiera personal que te permite controlar tus ingresos, gastos y múltiples cuentas en diferentes monedas, todo desde tu navegador.

🌐 Acceso a la Aplicación

La aplicación está disponible en: https://platito-62961.web.app/

¿Qué es una PWA?

Una Progressive Web App (PWA) es una aplicación web que combina lo mejor de las páginas web tradicionales y las aplicaciones nativas. Platito puede:

  • Instalarse en tu dispositivo como una aplicación nativa (escritorio o móvil)
  • Funcionar offline - tus datos están almacenados localmente
  • Actualizarse automáticamente cuando haya nuevas versiones
  • Ser rápida y ligera sin necesidad de descargas desde tiendas de apps
  • Funcionar en cualquier dispositivo con un navegador moderno

📲 Cómo Instalar Platito

En Escritorio (Chrome, Edge):

  1. Visita https://platito-62961.web.app/
  2. Haz clic en el ícono de instalación (➕) en la barra de direcciones
  3. Confirma la instalación
  4. La app aparecerá como una aplicación independiente

En Móvil (Android):

  1. Abre https://platito-62961.web.app/ en Chrome
  2. Toca el menú (⋮) y selecciona "Agregar a pantalla de inicio"
  3. Confirma y la app se agregará como un ícono en tu dispositivo

En Móvil (iOS):

  1. Abre https://platito-62961.web.app/ en Safari
  2. Toca el botón de compartir (⬆️)
  3. Selecciona "Agregar a pantalla de inicio"
  4. Confirma y tendrás Platito como una app

📋 Características Principales

1. 🏠 Dashboard (Inicio)

El dashboard es tu centro de control financiero:

  • Resumen General:
    • Visualiza balance total con opción de ocultarlo (protección visual)
    • Selector rápido de moneda de visualización (ARS/MEP)
    • Selección de cuenta específica para análisis focalizado
  • Gráficos Interactivos:
    • Gráfico de Barras (Time Series): Evolución de tus finanzas en los últimos períodos con valores abreviados (k/M)
    • Gráfico de Pastel: Distribución de gastos por categoría con valores simplificados
    • Timeline de Transacciones: Cantidad de transacciones registradas por día del mes
    • Desglose por Categorías: Detalle de gastos e ingresos por categoría
    • Income vs Outcome: Comparación visual con indicadores de cambio vs período anterior
  • Filtros Personalizables:
    • Filtra por tipo (ingresos/gastos)
    • Ventana de tiempo (día, semana, mes, año) con navegación intuitiva
    • Navega entre diferentes períodos con botones Prev/Next
    • Selecciona cuentas específicas o visualiza todas
  • Análisis Comparativo:
    • Porcentaje de cambio vs período anterior
    • Indicadores visuales de tendencia (↑↓)
    • Balance neto del período

2. 💳 Cuentas

Administra múltiples cuentas bancarias o billeteras:

  • Crear Cuentas: Define nombre, moneda, balance inicial
  • Personalización: Elige color e ícono para cada cuenta
  • Múltiples Monedas: Soporta ARS, USD Blue, USD MEP y USDT
  • Balance en Tiempo Real: Calcula automáticamente según transacciones
  • Archivar Cuentas: Oculta cuentas que ya no uses sin perder datos

3. 📊 Transacciones

Registra y gestiona todos tus movimientos financieros:

  • Registro Rápido: Agrega ingresos o gastos en segundos
  • Detalles Completos:
    • Cuenta asociada
    • Categoría (personalizable)
    • Monto y moneda
    • Fecha
    • Descripción
    • Etiquetas múltiples
  • Búsqueda y Filtros: Encuentra transacciones por fecha, cuenta, categoría o tipo
  • Edición y Eliminación: Modifica o borra transacciones fácilmente
  • Lista Ordenada: Visualiza cronológicamente todos tus movimientos

4. 🏷️ Categorías

Organiza tus transacciones con categorías personalizadas:

  • Categorías por Defecto: Incluye categorías comunes pre-configuradas
  • Crear Categorías: Define categorías para ingresos o gastos
  • Personalización Visual: Asigna colores e íconos únicos
  • Tipos Separados: Categorías independientes para ingresos y gastos
  • Sin Límites: Crea tantas categorías como necesites

5. 🔖 Etiquetas

Añade contexto adicional a tus transacciones:

  • Etiquetado Flexible: Asigna múltiples etiquetas por transacción
  • Organización Avanzada: Agrupa transacciones por proyectos, eventos o conceptos
  • Gestión Simple: Crea, edita o elimina etiquetas según necesites
  • Filtrado Mejorado: Encuentra transacciones con etiquetas específicas

6. 🔄 Transferencias

Mueve dinero entre tus cuentas manteniendo el registro:

  • Transferencias Entre Cuentas: Registra movimientos de dinero entre tus cuentas
  • Conversión de Moneda: Maneja automáticamente transferencias entre diferentes monedas
  • Historial Completo: Visualiza todas las transferencias realizadas
  • Balance Actualizado: Las transferencias actualizan automáticamente el balance de ambas cuentas

7. ⚙️ Configuración

Personaliza la aplicación según tus necesidades:

  • Cuenta por Defecto: Define la cuenta que se pre-selecciona al crear transacciones
  • Ventana de Tiempo: Configura el período inicial del dashboard
  • Moneda de Visualización: Elige en qué moneda ver los totales consolidados
  • Tipos de Cambio:
    • Actualiza manualmente las cotizaciones
    • Configura actualizaciones automáticas (cada 6h, 12h, 24h o desactivado)
    • Consulta la última actualización
  • Importar/Exportar Datos:
    • Exportar: Descarga toda tu información como respaldo (JSON)
    • Importar: Restaura datos desde un archivo de respaldo
    • Datos de Prueba: Carga datos de ejemplo para explorar la app

🎯 Cómo Usar Platito

Primeros Pasos

  1. Accede a la App: Visita https://platito-62961.web.app/
  2. Crea tu Primera Cuenta:
    • Ve a la sección "Cuentas"
    • Haz clic en "Agregar Cuenta"
    • Ingresa nombre, moneda y balance inicial
    • Personaliza con color e ícono
  3. Registra una Transacción:
    • Ve a "Transacciones"
    • Haz clic en "Nueva Transacción"
    • Selecciona tipo (ingreso/gasto), cuenta, categoría
    • Ingresa monto, fecha y descripción
    • Guarda
  4. Visualiza tu Dashboard:
    • Vuelve a "Inicio"
    • Explora gráficos y resumen financiero
    • Ajusta filtros según necesites

Flujo de Trabajo Recomendado

  1. Configuración Inicial:

    • Crea todas tus cuentas (banco, efectivo, billeteras digitales)
    • Revisa y personaliza categorías
    • Configura tipos de cambio si usas múltiples monedas
  2. Uso Diario:

    • Registra cada transacción cuando ocurra
    • Usa etiquetas para proyectos o eventos especiales
    • Revisa el dashboard periódicamente
  3. Análisis Mensual:

    • Cambia la vista del dashboard a "mes"
    • Analiza gastos por categoría
    • Identifica áreas de mejora
    • Compara con meses anteriores
  4. Mantenimiento:

    • Exporta respaldos regularmente
    • Archiva cuentas obsoletas
    • Ajusta tipos de cambio según necesidad

🔐 Privacidad y Seguridad

  • Datos Locales: Toda tu información se almacena en tu navegador (IndexedDB)
  • Sin Servidor: No enviamos tus datos financieros a ningún servidor
  • Control Total: Solo tú tienes acceso a tu información
  • Respaldos: Exporta tus datos para mantener copias de seguridad

💡 Consejos y Trucos

  • Ocultar Balance: Usa el botón de ojo en el dashboard para proteger tu privacidad visual
  • Selector Rápido de Moneda: Cambia entre ARS y MEP sin ir a configuración
  • Timeline de Transacciones: Identifica patrones de gasto mirando qué días registras más movimientos
  • Análisis Comparativo: Observa los indicadores de tendencia (↑↓) para ver si gastas más o menos que antes
  • Usa Etiquetas: Perfectas para rastrear gastos de vacaciones, proyectos o eventos
  • Múltiples Monedas: Si manejas criptomonedas o moneda extranjera, crea cuentas separadas
  • Categorías Específicas: Mientras más detalladas, mejor análisis obtendrás
  • Revisión Regular: Dedica 5 minutos semanales a revisar tus finanzas
  • Colores Consistentes: Usa colores similares para categorías relacionadas
  • Transferencias: Usa la sección de transferencias en lugar de crear transacciones manuales cuando muevas dinero entre cuentas

🛠️ Tecnología

Platito está construido con tecnologías web modernas:

  • React 19 con TypeScript
  • Vite para desarrollo rápido
  • Dexie.js (IndexedDB) para almacenamiento local
  • Mantine UI para interfaz moderna
  • Recharts para visualizaciones
  • Firebase Hosting para despliegue

📞 Soporte

Si encuentras problemas o tienes sugerencias:

  • Reporta issues en el repositorio del proyecto
  • Todos tus datos están en tu dispositivo, nunca los perdemos nosotros

¡Disfruta controlando tus finanzas con Platito! 💰✨

📄 License

This project is licensed under the MIT License.

About

Una app web para registrar y analizar gastos e ingresos, que funciona totalmente de forma local y permite guardar y restaurar tus datos sin depender de terceros.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages