What is avvio?

Avvio is a JavaScript tool that helps Node.js applications start up in the right order. When a complex app launches, it often needs to initialize databases, load configuration files, and set up various plugins. If these pieces aren't ready in the correct sequence, the app can crash or behave unpredictably. This project manages that startup sequence for you, handling error management and load order so everything boots smoothly. At a high level, you tell the tool which components or plugins your app needs by adding them one by one. Each plugin can even load its own sub-plugins, and the tool builds a logical map of all these dependencies. It waits to launch your application until every plugin has finished its setup task. If something goes wrong during this process, it pauses and sends the error to a central handler so you can decide how to respond. It also provides a way to manage the shutdown process, letting you register cleanup tasks that run when the app is closing. This tool is primarily designed for developers building Node.js applications who need a reliable way to manage a complex startup sequence. For example, if you are building a web server that needs to connect to a database, load external services, and register user routes before accepting traffic, this tool ensures those steps happen in the correct order. It was originally built for the Fastify web framework, but it can be used to bring structure to the startup of any Node.js project. A notable feature is its flexibility in how you write your setup code. Developers can choose to write traditional callback-style functions, or they can use modern JavaScript features like async/await and Promises. The tool also lets you configure a timeout, so if a plugin gets stuck during startup, the app will eventually throw a specific error rather than hanging forever. Additionally, an override feature allows developers to create isolated instances of their app for different plugins, which can be useful for advanced inheritance structures.