BT

Facilitating the Spread of Knowledge and Innovation in Professional Software Development

Write for InfoQ

Topics

Choose your language

InfoQ Homepage News AdonisJS v7 Ships End-to-End Type Safety, Reworked Starter Kits and Zero-Config OpenTelemetry

AdonisJS v7 Ships End-to-End Type Safety, Reworked Starter Kits and Zero-Config OpenTelemetry

Listen to this article -  0:00

AdonisJS, the ‘batteries-included Node.js framework’ maintained by Harminder Virk, has released version 7 with end-to-end type safety as its headline feature, alongside reworked starter kits, zero-configuration observability, and a completely rebuilt documentation site.

The release, which lands with 45+ updated packages and introduces three new ones: @adonisjs/otel for OpenTelemetry integration, @adonisjs/content for typed content collections, and edge-markdown for rendering Markdown with component syntax inside Edge templates.

The centrepiece of v7 is a type system that spans the full application stack through codegen. Route definitions generate TypeScript types consumed by a new urlFor helper, replacing the untyped router.makeUrl method from v6. Transformers provide a dedicated serialisation layer that generates .d.ts files at build time, giving frontend code typed access to API response shapes without manual duplication. For Inertia applications, the framework scans page components and enforces that inertia.render passes the correct props at compile time. A type-safe API client powered by Tuyau extends the same guarantees to separate frontend projects using TanStack Query or plain fetch.

v7 requires Node.js 24 as its minimum version, allowing the team to replace third-party dependencies with native platform APIs. The dotenv package has been swapped for Node's built-in util.parseEnv, and a new in-house JIT TypeScript compiler called ts-exec, built on the Rust-based SWC compiler at roughly 15 KB, replaces ts-node for development.

Starter kits have been completely reworked. Rather than prompting developers through a series of configuration questions, v7 ships four opinionated kits (Hypermedia, API, React, and Vue) that include authentication flows, session management, and frontend tooling out of the box. The framework also introduces barrel file generation for controllers, events, and policies, eliminating the wall of lazy imports that previously accumulated at the top of route files.

The community response has been notably positive. One developer on LinkedIn described v7:

The sweet spot for TypeScript-first backend work right now

Adding that:

If you're coming from Laravel or just tired of gluing 20+ packages together in Express/NestJS, AdonisJS gives you that batteries-included magic.

A first-time user on Reddit shared how fast it was to get up and running, and added they were a little worred about migration to v7.

Also realizing im starting this project possibly right before v7 comes out so hopefully migration isn't too crazy if i want to do that

Harminder Virk, the library author, responded directly:

Great to hear that you are enjoying AdonisJS. v6 to v7 will be super smooth as there are barely any breaking changes. Maybe 15-20 mins all it will take

AdonisJS occupies a similar space to frameworks like NestJS and Laravel, but differentiates itself through its opinionated, convention-over-configuration approach with first-class TypeScript support. Where NestJS leans on Angular-style dependency injection and decorators, AdonisJS draws more from the Laravel tradition of shipping a cohesive toolkit covering routing, ORM, authentication, validation, and mail under a single umbrella.

For teams upgrading from v6, the breaking changes are described as mostly mechanical, covering renamed imports, updated configuration files, and a new encryption module. The AdonisJS team expects most applications to complete the migration within 30 minutes to an hour, with a detailed upgrade guide and a dedicated GitHub discussion thread for reporting issues.

AdonisJS is an open-source, batteries-included Node.js web framework created and maintained by Harminder Virk. Drawing heavily from the Laravel tradition, it provides a cohesive, convention-over-configuration toolkit covering routing, an ORM (Lucid), authentication, validation, mail, and templating under a single umbrella, with first-class TypeScript support throughout.

About the Author

Rate this Article

Adoption
Style

BT