scoreko-electron-dev

Wrapper de Electron para empaquetar una instalación de NodeCG que incluya el bundle scoreko-dev, inspirado en opeik/runback-electron pero actualizado a Electron + TypeScript moderno.

Requisitos clave

• Node >=22 (.nvmrc incluido).
• Electron fijado en 39.5.1.

Qué hace

• Arranca lib/nodecg/index.js como proceso hijo desde Electron.
• Muestra la ruta de dashboard de carga del bundle (/bundles/<bundle>/dashboard/loading.html) servida por NodeCG mientras inicia.
• Carga el dashboard del bundle en http://localhost:<puerto>/bundles/<bundle>/<ruta-dashboard>.
• Empaqueta NodeCG + assets dentro de la app final con electron-builder.

Estructura esperada

scoreko-electron-dev/
├─ lib/
│  └─ nodecg/
│     ├─ index.js
│     ├─ node_modules/
│     └─ bundles/
│        └─ scoreko-dev/
├─ src/main/main.ts
├─ static/icons/
└─ package.json

Scripts

• npm run dev: modo desarrollo.
• npm run build: compila TypeScript y copia assets.
• npm run start: build y ejecución local.
• npm run test: build + tests unitarios (node:test).
• npm run doctor: preflight de configuración y entorno (lib/nodecg, permisos, puerto y env vars).
• npm run lint: reglas mínimas de calidad con ESLint.
• npm run format: validación de formato con Prettier.
• npm run pack: genera app sin instalador.
• npm run dist: genera instalador.

Variables de entorno

La fuente única de defaults está en .env.example.

1. Copia .env.example a .env (o exporta variables en tu shell/CI).
2. Ajusta sólo lo necesario.
3. Ejecuta npm run doctor para validar configuración antes de arrancar.

Build multi-plataforma (iconos)

• build.win.icon: static/icons/icon.ico
• build.linux.icon: static/icons
• build.mac.icon: static/icons/icon.icns

El .icns se referencia en la configuración de build y debe existir localmente para empaquetar macOS.

Troubleshooting y arquitectura

• Guía de troubleshooting: docs/troubleshooting.md
• Mapa de arquitectura: docs/architecture.md
• Roadmap: docs/refactor-roadmap.md