"/home/yossef/notes/git/projects/maplibra/observability/Bootstrap Debug Imports.md"

path: maplibra/observability/Bootstrap Debug Imports.md

- **fileName**: Bootstrap Debug Imports
- **Created on**: 2026-06-16 00:48:42

Bootstrap Debug Imports

Migrated from: obs_vault

Parent: ./Runtime Flags and Observability.md

This note covers the lazy debug import path that keeps developer helpers out of the normal startup path.

Main Source File

• src/bootstrap/bootstrap-debug.js
• src/app/debug-layers.js
• src/app/debug-location.js

What It Does

• Lazily loads debug layers and debug-location helpers only when a debug path needs them.
• Keeps the production path from paying the import cost unless a user explicitly asks for it.
• The imported debug helpers load the actual layer data and location-inspection tooling.

Why It Matters

• This is the clean separation between normal app startup and developer tooling.

Risks

• A first import failure can stick if the promise is cached and not reset.
• Lazy debug paths are easy to forget during testing because they are not part of the normal experience.

See Also

• ./Observability Risks.md

• ../risks/Debug Layers and Node Overlays.md

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