Overview

Master the fundamental building blocks of Dwex applications. This section covers the core concepts you'll use every day when building with Dwex.

Core Concepts

Modules - Organize your application into cohesive, reusable units with clear dependencies.

Controllers - Handle HTTP requests and define your API routes using decorators.

Providers - Create injectable services that encapsulate business logic and data access.

Middleware - Process requests and responses with reusable middleware functions.

Architecture

Dwex follows a modular architecture inspired by NestJS but optimized for Bun:

Application
├── Modules (organize features)
│   ├── Controllers (handle HTTP)
│   ├── Providers (business logic)
│   └── Middleware (request processing)
└── DI Container (manages dependencies)

Key Principles

Separation of Concerns - Controllers handle HTTP, services handle logic
Dependency Injection - Automatic resolution of dependencies
Modularity - Self-contained, reusable modules
Type Safety - Full TypeScript support throughout

Example

// Module organizes related code
@Module({
	imports: [DatabaseModule],
	controllers: [UserController],
	providers: [UserService],
	exports: [UserService],
})
export class UserModule {}

// Controller handles HTTP requests
@Controller("users")
export class UserController {
	constructor(private readonly userService: UserService) {}

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

// Provider contains business logic
@Injectable()
export class UserService {
	constructor(private readonly db: DatabaseService) {}

	findAll() {
		return this.db.users.findMany();
	}
}