adonisjs/core

AdonisJS is a TypeScript-first web framework for building web apps and API servers. It comes with support for testing, modern tooling, an ecosystem of official packages, and more.

Structural Verdict

How Data Flows Through the System

Application lifecycle flows from Ignitor bootstrapping through provider registration to service availability, with CLI commands providing development workflows.

1. Bootstrap — Ignitor creates application instance and loads environment configuration
2. Provider Registration — Core and user providers are registered with the IoC container
3. Application Init — Application initializes services and resolves configuration providers
4. Service Boot — Services are booted and made available for request handling or CLI execution
5. Runtime — HTTP requests processed or CLI commands executed using configured services

System Behavior

How the system actually operates at runtime — where data accumulates, what loops, what waits, and what controls what.

Data Pools

Feedback Loops

• Command Registration Loop (recursive, balancing) — Trigger: Ace kernel initialization. Action: Discovers and registers commands from file system. Exit: All commands loaded.
• Provider Boot Loop (recursive, balancing) — Trigger: Application boot. Action: Iterates through providers calling boot methods. Exit: All providers booted.

Delays & Async Processing

• Async Config Resolution (async-processing) — Configuration providers wait for application boot before resolving values
• Module Import (async-processing) — Dynamic imports of assembler and TypeScript during build commands

Control Points

• Environment Mode (env-var) — Controls: Application environment (development/production) affecting logging and error handling
• startApp Flag (feature-flag) — Controls: Whether CLI commands should start the full application or run standalone
• Force Configuration (runtime-toggle) — Controls: Whether to overwrite existing configuration files during package setup

Technology Stack

Key Components

• Ignitor (class) — Orchestrates application lifecycle including bootstrapping, provider loading, and environment setup src/ignitor/main.ts
• IgnitorFactory (class) — Factory for creating pre-configured Ignitor instances with core providers and config factories/core/ignitor.ts
• AceFactory (class) — Factory for creating Ace command kernels from Ignitor instances or app roots factories/core/ace.ts
• Add (cli-command) — Installs and configures AdonisJS packages by running npm install followed by configure hooks commands/add.ts
• Build (cli-command) — Creates production builds by compiling TypeScript and frontend assets commands/build.ts
• Configure (cli-command) — Runs package configuration hooks for already installed packages commands/configure.ts
• stringHelpers (utility) — Collection of string transformation utilities extending @poppinss/utils with AdonisJS-specific helpers src/helpers/string.ts
• prettyPrintError (function) — Pretty prints errors with colorful output using Youch terminal formatter index.ts
• app service (service) — Global application service instance accessor used by other services services/app.ts
• RequestValidator (class) — HTTP request validation integration with VineJS validator modules/http/request_validator.ts

Configuration

funding.json (json)

• version (string, unknown) — default: v1.0.0
• entity.type (string, unknown) — default: individual
• entity.role (string, unknown) — default: owner
• entity.name (string, unknown) — default: Harminder Virk
• entity.email (string, unknown) — default: virk@adonisjs.com
• entity.description (string, unknown) — default: Hi 👋 I'm Harminder Virk, the creator of a family of open-source tools loved by the Node.js community — including AdonisJS, VineJS, Japa, Edge, Lucid ORM, and Youch. I pour my heart into building tools that make developers' lives easier — from crafting elegant APIs to sweating the little details that improve your everyday workflow. My goal is to provide you with strong, reliable building blocks, so you can focus on shipping great products instead of fighting with your stack. By sponsoring my work, you're helping me keep these projects fast, stable, and well-maintained, while also making room for new ideas that could become your next favorite tool. ❤️ Current focus - AdonisJS v7 - Improving E2E type-safety in AdonisJS applications - Isomorphic VineJS (Validation library) - Lucid Rewrite (ORM) AdonisJS Plus (Sponsors can access Plus at a discounted rate)
• entity.webpageUrl.url (string, unknown) — default: https://adonisjs.com
• projects (array, unknown) — default: [object Object],[object Object],[object Object],[object Object],[object Object]
• +3 more parameters

typedoc.json (json)

• $schema (string, unknown) — default: https://typedoc.org/schema.json
• name (string, unknown) — default: @adonisjs/core
• includeVersion (boolean, unknown) — default: true
• excludeExternals (boolean, unknown) — default: true
• entryPoints (array, unknown) — default: ./index.ts,./commands/**/*.ts,./factories/**/*.ts,./modules/**/*.ts,./providers/**/*.ts,./services/**/*.ts,./src/types.ts,./src/helpers/main.ts,./src/exceptions.ts,./src/test_utils/main.ts,./src/vine.ts,./stubs/main.ts
• excludePrivate (boolean, unknown) — default: true
• excludeProtected (boolean, unknown) — default: true
• excludeInternal (boolean, unknown) — default: true
• +3 more parameters

Related Ml Training Repositories

Frequently Asked Questions

Analyzed on March 31, 2026 by CodeSea. Written by Karolina Sarna.