Skip to main content
AdonisJS Hero Light

​
Welcome to AdonisJS

AdonisJS is a fullstack Web framework with focus on ergonomics and speed. It takes care of much of the Web development hassles, offering you a clean and stable API to build Web apps and micro services.

​
Why AdonisJS?

AdonisJS provides a complete ecosystem for building modern web applications with TypeScript. Built on top of Node.js, it offers first-class support for modern JavaScript features while maintaining backwards compatibility.

Type-Safe

Built with TypeScript from the ground up, providing excellent IDE support and compile-time type checking for safer code.

Modular Architecture

Clean separation of concerns with service providers, dependency injection, and a powerful IoC container.

Modern HTTP Server

High-performance HTTP server built on top of Node.js with routing, middleware, request validation, and more.

CLI First

Powerful Ace CLI for scaffolding, running commands, and managing your application lifecycle.

Developer Experience

Exceptional developer experience with hot module reloading, detailed error pages, and comprehensive documentation.

Production Ready

Battle-tested in production with built-in security features, logging, encryption, and health checks.

​
Core Features

AdonisJS Core provides the foundation for building web applications:

​
Application Lifecycle

The Ignitor class manages your application’s lifecycle, making it easy to bootstrap your app in different environments:
  • Web environment - Start an HTTP server for handling requests
  • Console environment - Run CLI commands with Ace
  • Test environment - Execute your test suite
  • REPL environment - Interactive Node.js shell

​
HTTP Server

Define routes with support for parameters, query strings, named routes, and route groups. Built-in support for RESTful resources.
Chain middleware functions to handle cross-cutting concerns like authentication, CORS, and request logging.
Rich APIs for working with HTTP requests and responses, including JSON, file uploads, cookies, and sessions.
First-class integration with VineJS for powerful, type-safe request validation.

​
Core Modules

AdonisJS Core bundles essential modules for common web development tasks:

Config

Centralized configuration management

Env

Environment variable validation

Events

Event-driven architecture

Logger

Structured logging with Pino

Hash

Password hashing with Argon2/Bcrypt

Encryption

Data encryption and decryption

​
Quick Example

Here’s a minimal example of creating an HTTP server with AdonisJS Core: 
import { Ignitor } from '@adonisjs/core'

const ignitor = new Ignitor(new URL('./', import.meta.url))

ignitor
  .tap((app) => {
    app.booting(async () => {
      const router = await app.container.make('router')
      router.get('/', () => {
        return { hello: 'world' }
      })
    })
  })

ignitor.httpServer().start()
The Ignitor class is the entry point for all AdonisJS applications. It handles bootstrapping your app in different environments (web, console, test, or REPL).

​
System Requirements

AdonisJS requires Node.js version 24.0.0 or higher. We recommend using the latest LTS version of Node.js.

​
Get Started

Ready to build your first AdonisJS application?

Installation

Install AdonisJS Core and set up your development environment

Quick Start

Build your first HTTP server in minutes

​
Architecture Overview

Understand the core concepts behind AdonisJS:

Ignitor

Application bootstrapper and lifecycle manager

Service Providers

Register and boot application services

IoC Container

Dependency injection and service resolution

Application Lifecycle

Understand the application boot process

​
Community & Support

Join the AdonisJS community:

GitHub

View the source code and contribute

Documentation

Complete guides and API reference