Introduction

Welcome to AdonisJS!

This is the official documentation website for the framework. We have divided the documentation into multiple groups, each trying to address a specific use case or audience.

Please read the AdonisJS at a glance document if you are unsure whether AdonisJS will fit your needs or match the programming style.

TypeScript usage

AdonisJS is a backend framework for Node.js. The framework is written in TypeScript, and the application you will create using AdonisJS is also going to be in TypeScript.

We are very particular about how we leverage TypeScript and maintain a good balance between the static type safety and the visual noise.

If you have never used TypeScript, we recommend learning the basics of the language first and then using AdonisJS.

Familiarity with Node.js

We also expect you to be familiar with the Node.js ecosystem and asynchronous programming in general. Suppose you are coming from a threaded language like PHP or Ruby. In that case, we recommend educating yourself with the Node.js event loop and understand how it is different from a threaded environment.

Documentation

Guides

The technical guides are the in-depth documentation of the framework and cover every single topic and feature of the framework.

The guides also have documentation for the official packages of AdonisJS, i.e., Lucid ORM, template engine, Redis, and so on.

Reference

Modules with larger API surfaces like Database and Validator are also documented inside the reference guides.

Fitting all the validation rules, the database query builder methods within guides will overcrowd them, and hence they are moved to the reference guides.

Cookbooks

Cookbooks are actionable guides to help you achieve a practical task. Also, feel free to contribute to cookbooks by sending a PR.

How to ask for help?

At AdonisJS we have a friendly and helpful community always eager to help each other. You can join our Discord channel , or use Github Discussions when seeking help.

We also encourage you to help others whenever possible 💗

Resources

• Newsletter - Receive framework and community updates directly in your Inbox. No spam. Max 1 email a month.
• Twitter - Stay upto date.
• VS Code extension - An official VS Code extension to sky rocket your development experience.
• Awesome AdonisJS - A collection of packages, tutorials and applications created by the community members.

Who maintains AdonisJS?

AdonisJS is primarly maintained by Harminder Virk (the creator and the lead maintainer of the framework) along with the help of the following core team members.

• Romain Lanz is a full-stack developer at the FIVB. He believes that knowledge should be free and accessible for anyone, and he is working towards it.
• Michaël Zasso is a scientific research software engineer and a member of the Node.js Technical Steering Committee.
• Julien Ripouteau is a french developer with a passion for Javascript and Open Source. He is also the creator of the AdonisJS VsCode extension , AdonisJS Sail and the packages.adonisjs.com website.

Platinum sponsors

Contributors (139 and growing)

AdonisJS is the outcome of the love and labour of its contributors.