Roadmap
OneBun is actively developed. This page outlines what is already shipped, what is coming next, and our longer-term vision.
Current Status (v0.4.x)
OneBun is at v0.4.x — a pre-1.0 release focused on API stabilization and production readiness. The core framework, DI system, and all listed packages are functional and tested. Most features needed for production HTTP services are already implemented.
Already Implemented
All features below are shipped, tested, and documented. If something looks missing, check the linked docs first.
Core Framework
| Feature | Package | Docs |
|---|---|---|
Module system (@Module, @Global) | @onebun/core | Core |
Controllers & routing (@Get, @Post, etc.) | @onebun/core | Controllers |
| Services & DI via Effect.Context + Layer | @onebun/core | Services |
Middleware (@UseMiddleware, @Middleware) | @onebun/core | Security |
Lifecycle hooks (OnModuleInit, OnApplicationDestroy, etc.) | @onebun/core | Core |
| Graceful shutdown (SIGTERM/SIGINT handling) | @onebun/core | Core |
| Static file serving with SPA fallback | @onebun/core | Core |
| Multi-service applications (unified entry point) | @onebun/core | Core, Multi-Service example |
| Optional leading slash in route decorators | @onebun/core | Controllers, Decorators |
HTTP Guards & Authentication
| Feature | Package | Docs |
|---|---|---|
CanActivate interface for HTTP | @onebun/core | Guards |
@UseGuards() decorator for controllers/routes | @onebun/core | Guards |
Built-in AuthGuard (Bearer header presence check) | @onebun/core | Guards |
Built-in RolesGuard (role comparison over a caller-supplied rolesExtractor) | @onebun/core | Guards |
createHttpGuard(fn) factory | @onebun/core | Guards |
Exception Filters
| Feature | Package | Docs |
|---|---|---|
ExceptionFilter interface | @onebun/core | Exception Filters |
@UseFilters() decorator | @onebun/core | Exception Filters |
Global exception filter via ApplicationOptions.filters | @onebun/core | Exception Filters |
HttpException with proper status codes | @onebun/core | Exception Filters |
Validation
| Feature | Package | Docs |
|---|---|---|
| ArkType validation (single-source-of-truth for types, runtime validation, OpenAPI schema) | @onebun/core | Validation |
Security Middleware
| Feature | Package | Docs |
|---|---|---|
| CORS middleware | @onebun/core | Security |
| Rate limiting (in-memory + Redis) | @onebun/core | Security |
| Security headers (helmet-like) | @onebun/core | Security |
WebSocket & Queues
| Feature | Package | Docs |
|---|---|---|
WebSocket gateway (@WebSocketGateway, @OnMessage) | @onebun/core | WebSocket |
| WebSocket guards (6 built-in) | @onebun/core | WebSocket |
Queue system (@Subscribe, @Cron, @Interval, @Timeout) | @onebun/core | Queue |
| Queue guards (4 built-in) | @onebun/core | Queue |
| Server-Sent Events (SSE) | @onebun/core | Controllers |
| NATS + JetStream | @onebun/nats | Queue |
Testing Utilities
| Feature | Package | Docs |
|---|---|---|
TestingModule.create() with mock providers | @onebun/core | Testing |
.overrideProvider().useValue() / .useClass() | @onebun/core | Testing |
| HTTP integration testing | @onebun/core | Testing |
| Mock logger, config | @onebun/core | Testing |
| Fake timers | @onebun/core | Testing |
Ecosystem Packages
| Feature | Package | Docs |
|---|---|---|
| Swagger UI + OpenAPI 3.1 generation | @onebun/docs | API Docs |
| Structured logging via Effect.ts | @onebun/logger | Logger |
| Typed environment variables with validation | @onebun/envs | Envs |
| Redis / in-memory caching | @onebun/cache | Cache |
| Prometheus metrics + system metrics | @onebun/metrics | Metrics |
| OpenTelemetry tracing | @onebun/trace | Tracing |
| HTTP client with auth schemes and retries | @onebun/requests | HTTP Client |
| Drizzle ORM integration | @onebun/drizzle | Drizzle |
Phase 1: Next Up
High-impact features that round out the request pipeline and developer experience.
HTTP Interceptors
Transform requests/responses in the pipeline (logging, mapping, caching).
| Feature | Status |
|---|---|
Interceptor interface | Done |
@UseInterceptors() decorator | Done |
| Built-in: Logging, Cache, Timeout interceptors | Done |
Health Checks
Kubernetes-ready health endpoints.
| Feature | Status |
|---|---|
HealthModule with /health and /ready | Planned |
| Database, Redis, NATS indicators | Planned |
| Status aggregation, liveness/readiness probes | Planned |
CLI & Scaffolding
| Feature | Status |
|---|---|
bun create @onebun my-app | Done |
bunx onebun generate module/controller/service | Planned |
Documentation
| Document | Status |
|---|---|
| Migration guide (NestJS to OneBun) | Done — Migration from NestJS |
| Deployment guide (Docker, k8s, CI/CD) | Planned |
| Testing guide | Done — Testing |
| Expanded Troubleshooting / FAQ | Planned |
Phase 2: Ecosystem
Post-1.0 features for broader adoption.
| Feature | Status |
|---|---|
| GraphQL integration | Planned |
| Plugin system | Planned |
| Performance benchmarks page | Done — Benchmarks |
| Build-time config validation | Planned |