What Is a Dynamic Import Boundary?
A dynamic import boundary is the place where code uses an asynchronous import call instead of a static import, signaling that the target module can be fetched later. Bundlers treat each such call as a seam and emit a separate chunk for the imported code. The module then downloads only when execution actually reaches that call.
Why it matters
These boundaries are where lazy loading happens, deferring code for rarely used screens until needed. Placing them well shrinks the initial payload without breaking the user flow.
Where this shows up in a real pipeline
A definition is only useful if you can recognise the thing in your own logs. In practice this concept surfaces when a job behaves differently between a local run and a runner, which is where most CI debugging starts.
- Compare a local run against a CI run of the same command before assuming a tool is at fault.
- Runner environments differ in shell, PATH, TTY availability, available memory, and disk. Most CI-only behaviour traces to one of those five.
- Pin tool versions so an environment difference cannot be introduced by an unrelated update.