Koa2 + TypeScript + IOC = Koatty. Koatty is a progressive Node.js framework for building efficient and scalable server-side applications. It's perfect for crafting enterprise-level APIs, microservices, and full-stack applications with TypeScript excellence.
- π High Performance: Built on top of Koa2 with optimized architecture
- 𧩠Full-Featured: Supports gRPC, HTTP, WebSocket, scheduled tasks, and more
- π§ TypeScript First: Native TypeScript support with elegant OOP design
- π Spring-like IOC Container: Powerful dependency injection system with autowiring
- βοΈ AOP Support: Aspect-oriented programming with decorator-based interceptors
- π Extensible Architecture: Plugin system with dependency injection
- π¦ Modern Tooling: CLI scaffolding, testing utilities, and production-ready configurations
- π Protocol Agnostic: Write once, deploy as HTTP/gRPC/WebSocket services
- HTTP, HTTPS, HTTP2, gRPC, and WebSocket server support βοΈ
- Environment-based configuration loading, command-line argument parsing (process.argv), and environment variable parsing (process.env) βοΈ
@ExceptionHandler()for global exception handling βοΈ- Graceful shutdown and pre-exit events βοΈ
- Custom decorators bound to app events βοΈ
- GraphQL integration βοΈ
- Full-stack tracing through OpenTelemetry βοΈ
- Middleware binding to controllers and method routes βοΈ
- gRPC streaming support βοΈ
- Swagger OpenAPI 3.0 support πͺ
// config/config.ts
export default {
...
protocol: "grpc", // Server protocol 'http' | 'https' | 'http2' | 'grpc' | 'ws' | 'wss' | 'graphql'
...
}@Service()
export class UserService {
async findUser(id: number) {
return { id, name: 'Koatty User' };
}
}
@Controller()
export class IndexController {
app: App;
ctx: KoattyContext;
@Config("protocol")
conf: { protocol: string };
...
@Autowired()
private userService: UserService;
async test(id: number) {
const info = await this.userService.findUser(id);
...
}
}@Aspect()
export class LogAspect implements IAspect {
app: App;
run() {
console.log('LogAspect');
}
}
// Apply aspect to controller
@Controller()
@BeforeEach(LogAspect)
export class UserController {
...
@After(LogAspect)
test() {
...
}
}// plugin/logger.ts
export class LoggerPlugin implements IPlugin {
app: App;
run() {
// todo something or hook on app.event
Logger.Debug("LoggerPlugin");
return Promise.resolve();
}
}| Framework | Requests/sec | Latency | Memory Usage |
|---|---|---|---|
| Koatty | 13,321 | 1.43ms | 54MB |
| Express | 12,456 | 1.45ms | 52MB |
| NestJS | 11,892 | 1.51ms | 63MB |
Tested on AWS t3.micro with 100 concurrent connections
- Install CLI:
npm install -g koatty_cli- Create Project:
koatty new awesome-app- Run Development Server:
cd awesome-app
npm run devThanks to these amazing developers:
BSD-3 Β© Koatty Team