"/home/yossef/notes/git/projects/maplibra/risks/Shell Bootstrap Risks.md"

path: maplibra/risks/Shell Bootstrap Risks.md

- **fileName**: Shell Bootstrap Risks
- **Created on**: 2026-06-16 00:48:42

Shell Bootstrap Risks

Migrated from: obs_vault

Parent: ../modules/Bootstrap System.md

This note collects the shell-level bugs and maintenance risks that matter most.

Risks Found

• script.js imports keyboard controls but the live startup path may never invoke them.
• bootstrap-routing.js caches a load promise, so one rejected initialization can make retries awkward.
• bootstrap-shell.js installs global error and storage listeners that need careful teardown if the shell is reinitialized.
• init-keyboard.js and init-joystick.js depend on exact cleanup references to avoid leaking listeners.
• The shell has many hard-coded DOM IDs and class names, so markup drift can break startup silently.

See Also

• ../flows/Startup Sequence.md

• ../modules/Bootstrap System.md

• ./Keyboard and Joystick Input.md

  continue:[[]]
  before:[[]]