Pandipipas/scoreko-electron-dev
1
0
Fork 0
mirror of https://github.com/Pandipipas/scoreko-electron-dev.git synced 2026-06-05 21:22:07 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
41e4e91c4b7caf35730ff968f294a582befd49d6
scoreko-electron-dev/docs/troubleshooting.md
T
Pandipipas 41e4e91c4b feat: enhance NodeCG runtime management and packaging 
- Update .gitignore and .prettierignore to exclude additional cache and configuration files.
- Revise README.md for clarity on build processes and runtime behavior.
- Improve architecture documentation to reflect changes in startup flow and module responsibilities.
- Modify troubleshooting guide to address common runtime issues and installation steps.
- Enhance ESLint configuration to ignore more directories.
- Update package.json scripts for better build and distribution processes.
- Introduce build-scoreko-bundle.mjs for building the Scoreko bundle.
- Implement prepare-nodecg-runtime.mjs for managing NodeCG runtime installation and updates.
- Add runtime-provisioner.ts to handle user-specific NodeCG runtime provisioning.
- Create tests for runtime provisioning to ensure correct behavior.
- Refactor process-manager.ts and main.ts to integrate new runtime management logic.
2026-05-09 17:45:36 +02:00

1.2 KiB
Raw Blame History

Troubleshooting

The packaged NodeCG runtime is incomplete

  • Run npm run prepare:runtime from scoreko-electron-dev.
  • If the parent bundle is not installed yet, run pnpm install from the repository root first.

NodeCG is present but internal dependencies are missing

  • Recreate the runtime with npm run prepare:runtime.
  • If native SQLite errors appear during launch, run npm run rebuild:native before packaging.

No read/write permissions on NodeCG

  • Installed builds run NodeCG from the user's app data folder, so this usually means the local development copy is locked.
  • Close any running Scoreko/NodeCG process and run npm run start again.

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 the Electron/NodeCG output in the terminal.
  • Increase NODECG_STARTUP_TIMEOUT_MS if the environment is slow.
  • Recreate the runtime with npm run prepare:runtime if the bundle changed.

macOS build fails because of icon

  • The configuration expects static/icons/icon.icns.
  • Create that file before running macOS packaging.
Reference in New Issue View Git Blame Copy Permalink