CodeVetter · Repo Unpack · System map
adonisjs/core
The repository packages the integration surface of AdonisJS rather than implementing every framework subsystem locally. Ignitor creates web, console, and test processes, while providers register the services those processes consume. Package exports separate public modules, service facades, providers, factories, helpers, and commands. Persistent outputs inspected here are generated application files and development artifacts; token persistence is delegated to consumers. Distribution and release are centered on an npm ESM package.
- The package is @adonisjs/core 7.5.2, requires Node >=24.0.0, uses ESM, and publishes build output while excluding built tests and bin files.
- index.ts exports Ignitor, prettyPrintError, inject, configProvider, indexEntities, and stubsRoot, and aggregates errors from the application, HTTP, encryption, Ace, and environment packages.
- Public subpath exports expose commands, factories, services, providers, helpers, lifecycle entrypoints, drivers, and framework modules through compiled build paths.
- Application and HTTP primitives are re-exported from @adonisjs/application and @adonisjs/http-server; the HTTP wrapper also loads bodyparser augmentation and exports the local RequestValidator.
- Ignitor creates Application with an environment and optional importer, sets the shared app service, runs tap callbacks, and constructs HttpServerProcess, AceProcess, or TestRunnerProcess.
- AppServiceProvider.register wires application, Ace, dumper, logger, config, events, encryption, test utilities, server, router, and bodyparser bindings; its boot hook assigns the emitter to BaseEvent.
- The framework Server singleton receives application, default Encryption, emitter, logger, and app.http configuration; Router resolves to that server's router.
- The inspected storage boundaries include generated route declarations and JSON, scaffold destinations, and REPL history under the user's home directory.
- npm run compile cleans build, runs tsdown and declaration-only tsc; postcompile copies stub templates and indexes commands. The test script invokes Japa through @poppinss/ts-exec.
- The package binary adonis-kit constructs an Ace kernel containing IndexCommand, which generates a lazy command index from a directory relative to cwd.
- Release CI waits for checks, uses the npm-publish environment with contents and OIDC write permissions, installs with npm ci --ignore-scripts, audits signatures, verifies generated command artifacts, and invokes release-it.