Avi.jsStructure without the overhead.

A TypeScript framework for Node.js with modules, controllers and dependency injection. No reflect-metadata, no Express underneath.

Get started

Examples

GitHub

Two styles, one engine
Write controllers with decorators or with plain objects and functions. Both turn into the same definitions and behave identically.
Explicit by design
Each class lists its dependencies in code. No reflect-metadata, emitDecoratorMetadata or experimentalDecorators. What you read is what runs.
Catch configuration errors early
Missing providers, invalid exports, dependency cycles and conflicting routes are detected during initialization, before the server accepts requests.
Safe by default
Bounded request bodies, sanitized error responses, abort-aware handlers and graceful shutdown are built in, not plugins.
Small and modular
Runs on native node:http. DI, HTTP, validation, security and testing are separate packages you add when you need them.
Tools included
npm create avi, generators for modules, controllers and services, a test client, Standard Schema validation and OpenAPI documents.

Start in a minute

npm create avi@latest my-api
cd my-api
npm install
npm run dev

Pick your style

DecoratorsExplicit

import { AviFactory, Controller, Get, Injectable, Module } from '@avijs/core';

@Injectable()
class UsersService {
  findAll() {
    return [{ id: 1, name: 'Ada' }];
  }
}

@Controller('/users')
class UsersController {
  static inject = [UsersService] as const;
  constructor(private readonly users: UsersService) {}

  @Get()
  findAll() {
    return this.users.findAll();
  }
}

@Module({ controllers: [UsersController], providers: [UsersService] })
class AppModule {}

const app = await AviFactory.create(AppModule);
await app.listen(3000);

import { createAvi, defineController } from '@avijs/core';

class UsersService {
  findAll() {
    return [{ id: 1, name: 'Ada' }];
  }
}

const users = defineController({
  prefix: '/users',
  inject: [UsersService],
  routes: (service) => [{ method: 'GET', path: '/', handler: () => service.findAll() }],
});

const app = createAvi().register({ providers: [UsersService], controllers: [users] });
await app.listen(3000);

Avi.js is in early development (0.x): the API may still change between minor versions before 1.0.

Avi.jsStructure without the overhead.

Two styles, one engine

Explicit by design

Catch configuration errors early

Safe by default

Small and modular

Tools included

Start in a minute ​

Pick your style ​

Start in a minute

Pick your style