\n\n
![\"nestelia\"](\"./assets/logo.svg\")
\n\n
nestelia
\n\n
\n Production-grade modular framework for Elysia
\n Decorators · Dependency Injection · Modules · Lifecycle Hooks · GraphQL · Microservices\n
\n\n
\n ![\"npm](\"https://img.shields.io/npm/v/nestelia?style=flat-square&color=cb3837&logo=npm\")
\n ![\"npm](\"https://img.shields.io/npm/dm/nestelia?style=flat-square&color=cb3837&logo=npm\")
\n ![\"GitHub](\"https://img.shields.io/github/stars/nestelia/nestelia?style=flat-square&logo=github\")
\n ![\"License:](\"https://img.shields.io/badge/license-MIT-blue?style=flat-square\")
\n
\n ![\"Bun\"](\"https://img.shields.io/badge/runtime-Bun-000?style=flat-square&logo=bun&logoColor=fbf0df\")
\n ![\"TypeScript\"](\"https://img.shields.io/badge/lang-TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white\")
\n ![\"Tests\"](\"https://img.shields.io/badge/tests-864%2F864%20passing-brightgreen?style=flat-square\")
\n ![\"Documentation\"](\"https://img.shields.io/badge/docs-nestelia.dev-10b981?style=flat-square\")
\n
\n\n
\n 📖 Documentation ·\n 📦 npm ·\n 💻 GitHub ·\n 💬 Discussions\n
\n\n
\n\n| \n\n**🏗️ Decorators**\n\n`@Controller`, `@Get`, `@Post`, `@Body`, `@Param`, `@Query`, `@Headers`, and the full Express-style routing surface you expect.\n\n | \n\n\n**💉 Dependency Injection**\n\nConstructor-based DI with `singleton`, `transient`, and `request` scopes. Circular dependency detection and auto-wiring out of the box.\n\n | \n\n\n**📦 Modules**\n\nEncapsulate controllers, providers, and imports. Re-use logic across apps with clean boundaries and explicit exports.\n\n | \n
\n\n| \n\n**⚡ Lifecycle Hooks**\n\n`OnModuleInit`, `OnApplicationBootstrap`, `OnModuleDestroy`, and `BeforeApplicationShutdown` for deterministic startup & teardown.\n\n | \n\n\n**🛡️ Guards, Interceptors & Pipes**\n\nComposable request pipeline. Auth guards, logging interceptors, validation pipes — all via decorators.\n\n | \n\n\n**🌐 Exception Handling**\n\nBuilt-in HTTP exceptions (`BadRequestException`, `NotFoundException`, etc.) and custom `@Catch()` filters.\n\n | \n
\n\n| \n\n**📝 Swagger / OpenAPI**\n\nAutomatic OpenAPI documentation generated from decorators. Zero config for basic specs, full control when you need it.\n\n | \n\n\n**⏰ Task Scheduling**\n\nCron jobs, intervals, and timeouts via `@Cron()`, `@Interval()`, `@Timeout()` decorators.\n\n | \n\n\n**🚀 Microservices**\n\nRedis, RabbitMQ, and TCP transports with `@MessagePattern` and `@EventPattern` handlers.\n\n | \n
\n
\n\n---\n\n## 🚀 Quick Start\n\n```bash\n# 1. Create a new project\nbun init -y\n\n# 2. Install dependencies\nbun add nestelia elysia reflect-metadata\n\n# 3. Enable decorators in tsconfig.json\n# \"experimentalDecorators\": true\n# \"emitDecoratorMetadata\": true\n```\n\n**`src/main.ts`**\n\n```typescript\nimport \"reflect-metadata\";\nimport { Controller, Get, Module, createElysiaApplication } from \"nestelia\";\n\n@Controller()\nclass AppController {\n @Get()\n index() {\n return { message: \"Hello from nestelia!\" };\n }\n}\n\n@Module({\n controllers: [AppController],\n})\nclass AppModule {}\n\nconst app = await createElysiaApplication(AppModule);\napp.listen(3000);\n\nconsole.log(\"🦊 Server running at http://localhost:3000\");\n```\n\n```bash\nbun run src/main.ts\n# → 🦊 Server running at http://localhost:3000\n```\n\n---\n\n## 📦 Ecosystem\n\nAll packages are published under the single `nestelia` package with subpath exports.\n\n| Import | Description |\n|--------|-------------|\n| `nestelia` | Core framework — DI, decorators, modules, lifecycle |\n| `nestelia/scheduler` | Cron jobs, intervals, timeouts |\n| `nestelia/microservices` | Redis, RabbitMQ, TCP transports |\n| `nestelia/apollo` | Apollo GraphQL code-first |\n| `nestelia/passport` | Passport.js authentication integration |\n| `nestelia/testing` | Isolated test modules with provider overrides |\n| `nestelia/cache` | Response caching with `@CacheKey()`, `@CacheTTL()` |\n| `nestelia/rabbitmq` | Advanced RabbitMQ messaging patterns |\n| `nestelia/graphql-pubsub` | Redis-backed PubSub for GraphQL subscriptions |\n\n---\n\n## 📚 Examples\n\n### Guard\n\n```typescript\nimport { Injectable, CanActivate, ExecutionContext } from \"nestelia\";\n\n@Injectable()\nclass AuthGuard implements CanActivate {\n canActivate(ctx: ExecutionContext) {\n const request = ctx.switchToHttp().getRequest();\n return request.headers.authorization === \"Bearer secret\";\n }\n}\n\n@Controller()\nclass AppController {\n @Get(\"/protected\")\n @UseGuards(AuthGuard)\n protected() {\n return { secret: \"🎉 You passed!\" };\n }\n}\n```\n\n### Interceptor\n\n```typescript\nimport { Injectable, NestInterceptor, ExecutionContext, CallHandler } from \"nestelia\";\nimport { map } from \"rxjs/operators\";\n\n@Injectable()\nclass TransformInterceptor implements NestInterceptor {\n intercept(_ctx: ExecutionContext, next: CallHandler) {\n return next.handle().pipe(map(data => ({ data, timestamp: Date.now() })));\n }\n}\n```\n\n### GraphQL Subscription\n\n```typescript\nimport { Resolver, Query, Subscription } from \"@nestelia/apollo\";\nimport { PubSub } from \"@nestelia/graphql-pubsub\";\n\n@Resolver()\nclass NotificationResolver {\n constructor(private readonly pubsub: PubSub) {}\n\n @Query()\n notifications() {\n return [];\n }\n\n @Subscription(() => String, { topics: \"NEW_NOTIFICATION\" })\n newNotification() {\n return this.pubsub.asyncIterator(\"NEW_NOTIFICATION\");\n }\n}\n```\n\n---\n\n## 🧪 Testing\n\n```typescript\nimport { Test } from \"nestelia/testing\";\nimport { AppController } from \"./app.controller\";\nimport { AppService } from \"./app.service\";\n\ndescribe(\"AppController\", () => {\n let controller: AppController;\n\n beforeAll(async () => {\n const module = await Test.createTestingModule({\n controllers: [AppController],\n providers: [AppService],\n }).compile();\n\n controller = module.get(AppController);\n });\n\n it(\"should return hello\", () => {\n expect(controller.hello(\"World\")).toEqual(\"Hello, World!\");\n });\n});\n```\n\n---\n\n## 📖 Documentation\n\nFull guides, API references, and recipes are available at **[nestelia.dev](https://nestelia.dev)**.\n\nRun the docs locally:\n\n```bash\nbun install\nbun run docs:dev\n```\n\n---\n\n## 🤖 Claude Code Skill\n\nA first-party [Claude Code](https://claude.ai/claude-code) skill is available for nestelia. It provides scaffolding templates, decorator usage patterns, and framework best practices directly inside your AI assistant.\n\n```bash\nnpx skills add nestelia/nestelia\n```\n\n---\n\n## ⭐ Star History\n\n