refactor: run NodeCG from lib/scoreko-dev for Node 24 migration

This commit is contained in:
Pandipipas
2026-03-02 22:53:22 +01:00
parent 162b0685c6
commit eae612cb38
10 changed files with 126 additions and 140 deletions
+2 -2
View File
@@ -4,14 +4,14 @@
1. `src/main/main.ts` loads `appConfig` from `config/runtime-config.ts`.
2. Creates windows (`windows/window-factory.ts`).
3. Starts NodeCG with `nodecg/process-manager.ts`.
3. Starts NodeCG with `nodecg/process-manager.ts` by running `npx nodecg start` from `lib/scoreko-dev`.
4. Waits for HTTP readiness and shows loading -> main dashboard.
5. On shutdown, runs a single graceful-stop flow to avoid orphan processes.
## Main modules
- `config/runtime-config.ts`: read/validate env vars.
- `nodecg/process-manager.ts`: start, readiness, and stop for NodeCG; install/permission/port validation.
- `nodecg/process-manager.ts`: start, readiness, and stop for NodeCG; install/permission/port validation in `lib/scoreko-dev`.
- `windows/window-factory.ts`: window creation and navigation policy.
- `windows/navigation-security.ts`: internal navigation allowlist and safe external schemes.
- `errors/error-presenter.ts`: fatal error presentation.
+7 -7
View File
@@ -1,14 +1,14 @@
# Troubleshooting
## `NodeCG folder does not exist`
## `Scoreko app folder does not exist`
- Verify `lib/nodecg` exists.
- Make sure the project contains a full NodeCG installation.
- 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 NodeCG`
## `No read/write permissions on scoreko app folder`
- Adjust permissions on `lib/nodecg` for the user running Electron.
- On Linux/macOS: `chmod -R u+rw lib/nodecg` (according to your local policy).
- 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`
@@ -19,7 +19,7 @@
- Check NodeCG logs in standard output.
- Increase `NODECG_STARTUP_TIMEOUT_MS` if the environment is slow.
- Verify NodeCG dependencies (`cd lib/nodecg && npm install`).
- Verify scoreko-dev dependencies (`cd lib/scoreko-dev && npm install`).
## macOS build fails because of icon