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.

GastosApp se distribuye como aplicación de escritorio nativa para Windows, macOS y Linux usando electron-builder. El proceso de build tiene dos etapas: primero Vite compila el código React al directorio dist/, luego electron-builder empaqueta ese directorio junto con el proceso principal de Electron y genera los instaladores finales en release/. Todo el proceso se ejecuta con un solo comando y la configuración completa vive en package.json.

Generar el build

1

Compilar React con Vite

Ejecuta npm run build, que invoca vite build. Genera el bundle optimizado del renderer en dist/ con base: './' para que las rutas de assets sean relativas (necesario para que Electron las sirva desde el sistema de archivos local).
npm run build
2

Empaquetar con electron-builder

Ejecuta npm run electron:build, que llama a npm run build && electron-builder. electron-builder toma el contenido de dist/, los archivos de electron/ y package.json, y genera el instalador nativo para la plataforma actual en el directorio release/.
npm run electron:build

Plataformas y formatos

PlataformaFormatoArquitectura
WindowsNSIS installer (.exe)x64
macOSDMGPlataforma actual
LinuxAppImagePlataforma actual

Configuración electron-builder

La configuración completa de empaquetado se declara en la clave "build" de package.json:
{
  "appId": "cl.gastosapp.app",
  "productName": "GastosApp",
  "directories": {
    "output": "release"
  },
  "files": [
    "dist/**/*",
    "electron/**/*",
    "package.json"
  ],
  "win": {
    "target": [
      { "target": "nsis", "arch": ["x64"] }
    ]
  },
  "mac": {
    "target": "dmg"
  },
  "linux": {
    "target": "AppImage"
  },
  "nsis": {
    "oneClick": false,
    "allowToChangeInstallationDirectory": true,
    "installerLanguages": ["es_ES"],
    "language": "3082"
  }
}

Instalador Windows (NSIS)

El instalador de Windows usa NSIS con las siguientes opciones configuradas:
OpciónValorEfecto
oneClickfalseEl instalador muestra un asistente paso a paso, no instala silenciosamente
allowToChangeInstallationDirectorytrueEl usuario puede elegir la carpeta de instalación en lugar de usar Program Files por defecto
installerLanguages["es_ES"]El asistente de instalación se muestra en español de España
language"3082"Código LCID de es_ES (español — España) para la localización de NSIS

Archivos incluidos en el paquete

El campo files define qué se incluye dentro del ejecutable final. La configuración actual incluye:
PatrónContenido
dist/**/*Bundle compilado de React (HTML, JS, CSS y assets de Vite)
electron/**/*main.js (proceso principal ESM) y preload.cjs (bridge IPC CommonJS)
package.jsonRequerido por Electron para resolver el punto de entrada ("main": "electron/main.js")
Para generar el instalador de Windows desde macOS o Linux se puede usar Docker con una imagen de Wine. El script npm run electron:build detecta automáticamente la plataforma y genera el formato correspondiente sin configuración adicional.

Build docs developers (and LLMs) love