scoreko-electron-dev/docs/troubleshooting.md

Troubleshooting

No existe la carpeta NodeCG

• Verifica que exista lib/nodecg.
• Asegúrate de que el proyecto contiene una instalación completa de NodeCG.

Sin permisos de lectura/escritura sobre NodeCG

• Ajusta permisos de lib/nodecg para el usuario que ejecuta Electron.
• En Linux/macOS: chmod -R u+rw lib/nodecg (según tu política local).

El puerto <PORT> ya está en uso

• Libera el puerto o define NODECG_PORT en .env.
• Usa npm run doctor para validar disponibilidad antes de arrancar.

Timeout esperando NodeCG

• Revisa logs de NodeCG en la salida estándar.
• Incrementa NODECG_STARTUP_TIMEOUT_MS si el entorno es lento.
• Verifica dependencias de NodeCG (cd lib/nodecg && npm install).

Build macOS falla por icono

• La configuración espera static/icons/icon.icns.
• Crea ese archivo antes de ejecutar empaquetado para macOS.