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.
Visual learner? - Checkout the Let's Learn AdonisJS free screencasts series from our friends at Adocasts.
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.
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.
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 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?
We also encourage you to help others whenever possible 💗
- Newsletter - Receive framework and community updates directly in your Inbox. No spam. Max 1 email a month.
- Twitter - Stay up to 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 primarily 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.