Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Davidmallega/Gastos-App/llms.txt

Use this file to discover all available pages before exploring further.

Esta guía te lleva desde cero hasta tener GastosApp funcionando con datos de ejemplo cargados. Solo necesitas Node.js, npm y una terminal. Todo el proceso toma menos de 5 minutos.
1

Requisitos previos

Antes de comenzar, verifica que tienes instaladas las versiones correctas de Node.js y npm. GastosApp requiere Node.js 18 o superior y npm 9 o superior.
node --version
# Debe mostrar v18.0.0 o superior

npm --version
# Debe mostrar 9.0.0 o superior
Si necesitas instalar o actualizar Node.js, descárgalo desde nodejs.org. npm se instala automáticamente junto con Node.js.
2

Clonar e instalar dependencias

Clona el repositorio e instala todas las dependencias con npm:
git clone https://github.com/Davidmallega/Gastos-App.git
cd Gastos-App
npm install
La instalación descarga Electron, React, Vite, Tailwind CSS y el resto de dependencias listadas en package.json. No se requiere ninguna configuración adicional.
3

Iniciar la aplicación

GastosApp se puede ejecutar en dos modos según lo que necesites:
npm run dev
# Servidor de desarrollo Vite → http://localhost:5173
Para desarrollo web rápido usa npm run dev. Para probar la integración Electron completa (controles de ventana, impresión PDF) usa npm run electron:dev.
4

Cargar datos de prueba

El repositorio incluye un archivo de demostración con tres meses de registros reales. Para cargarlo:
  1. Abre la aplicación y navega a Respaldo en el menú lateral izquierdo.
  2. Haz clic en el área de importación o arrastra el archivo documentacion/datos_prueba_3meses.json.
  3. Revisa el preview con el conteo de registros que se van a importar.
  4. Confirma la importación.
El archivo carga:
  • 14 categorías — con sus nombres configurados
  • 9 proveedores — con RUT, razón social y categoría asignada
  • ~39 documentos — facturas SII y gastos caja de abril a junio 2026
  • 6 compromisos recurrentes — en distintos estados (Vencido, Próximo, Registrado, Pendiente)
Después de importar, el Dashboard mostrará los KPIs del período, la grilla de tarjetas mensuales y los gráficos de evolución con datos reales.
5

Registrar el primer gasto

Para registrar un gasto por caja manualmente:
  1. En el menú lateral, haz clic en Gastos por Caja.
  2. Haz clic en el botón Nuevo gasto en la esquina superior derecha.
  3. Completa los campos requeridos:
    • Fecha — por defecto es el día de hoy
    • Proveedor — al escribir el nombre, se auto-completa la categoría si el proveedor ya existe
    • Categoría — selecciona o confirma la categoría sugerida
    • Monto total — ingresa el monto en pesos chilenos
    • Método de pago — Efectivo, Débito o Transferencia
  4. Activa el toggle Con Boleta si el gasto tiene documento de respaldo.
  5. Haz clic en Guardar.
El nuevo gasto aparece en la lista con el semáforo de salud en verde (0–3 días de antigüedad) y queda disponible en Pagos Pendientes para marcarlo como pagado cuando corresponda.
Con esto tienes GastosApp en funcionamiento. Para una configuración detallada del entorno de desarrollo, revisa la sección Instalación.

Build docs developers (and LLMs) love

Get started for freeTalk to us