Preserve desktop startup reliability and packaging invariants across development, installed single-architecture builds, and universal macOS builds.
Workflow
- Read
references/guide.mdbefore changing Electron startup, branding, packaging hooks, runtime resources, or desktop CI. - Test cold-start readiness independently from ingress readiness.
- Keep packaged dependency stripping and the explicit runtime package closure synchronized.
- Validate bundled Node and uv paths on every affected platform and architecture.
- Test installed artifacts outside the repository tree so local
node_modulescannot hide missing packaged dependencies.
Reference
references/guide.md— Cold-start coordination, loading feedback, node_modules stripping, universal runtime layout, macOS development branding, and bundled Node/npm/npx behavior.