scoreko-electron-dev/docs/troubleshooting.md

Troubleshooting

Scoreko app folder does not exist

• Verify lib/scoreko-dev exists.
• Make sure the project contains the scoreko-dev bundle root with its own package.json.

No read/write permissions on scoreko app folder

• Adjust permissions on lib/scoreko-dev for the user running Electron.
• On Linux/macOS: chmod -R u+rw lib/scoreko-dev (according to your local policy).

Port <PORT> is already in use

• Free the port or set NODECG_PORT in .env.
• Use npm run doctor to validate availability before startup.

Timeout while waiting for NodeCG

• Check NodeCG logs in standard output.
• Increase NODECG_STARTUP_TIMEOUT_MS if the environment is slow.
• Verify scoreko-dev dependencies (cd lib/scoreko-dev && npm install).

macOS build fails because of icon

• The configuration expects static/icons/icon.icns.
• Create that file before running macOS packaging.