This release adds targeted entry points for bootstrap code. Importing from @adonisjs/core loads the root entry point and its aggregated error namespaces, including modules that light Ace commands may not need.
| Import path | Exports |
|---|---|
@adonisjs/core/ignitor
| Ignitor, prettyPrintError
|
@adonisjs/core/generators
| indexEntities
|
@adonisjs/core/config
| configProvider, alongside the existing config exports
|
Existing root exports remain available. The change is opt-in: applications need to switch their bootstrap imports to these paths to get the measured startup gains.
The PR benchmarked a generated Hypermedia app with its bootstrap files, adonisrc.ts, Auth, and Session updated to use targeted imports:
| Runtime | Command | Before | After | Change | Peak RSS |
|---|---|---|---|---|---|
| Node 24.20 | node ace --help
| 359.47 ms | 285.68 ms | -73.79 ms (-20.5%) | -10.20 MiB |
| Node 26.5 | node ace --help
| 359.86 ms | 280.98 ms | -78.88 ms (-21.9%) | -10.49 MiB |
| Node 24.20 | node ace test --help
| 360.76 ms | 293.91 ms | -66.85 ms (-18.5%) | -10.46 MiB |
| Node 26.5 | node ace test --help
| 353.14 ms | 285.85 ms | -67.29 ms (-19.1%) | -10.21 MiB |
Each variant ran in 50 fresh processes after five warmups. The benchmark randomized execution order, pinned processes to one CPU, and reported median wall-clock time.
The gains apply mainly to light CLI startup. A full list:routes boot improved by 4.0% on Node 24 and 1.8% on Node 26, with overlapping timing distributions. The PR did not find conclusive evidence of faster test runs or production server startup.