Skip to content

AsenaJs/Asena

Repository files navigation

Asena

Version License: MIT Bun Version

A high-performance IoC web framework for Bun runtime, bringing Spring Boot's automatic component discovery and field-based dependency injection to TypeScript.

Philosophy

Spring Boot and Quarkus have established proven patterns for enterprise application development, but developers transitioning to TypeScript often find themselves reimplementing familiar concepts or adapting to unfamiliar architectures. AsenaJS addresses this gap by bringing automatic component discovery, field-based dependency injection to the Bun ecosystem.

The framework eliminates boilerplate through automatic scanning of decorator-annotated classes, removing the need for explicit module declarations or manual wiring. Components marked with @Controller, @Service, or @Repository (via asena-drizzle package) are discovered and registered automatically, allowing developers to focus on business logic rather than configuration. This approach, combined with Bun's native performance characteristics, delivers both the familiar developer experience of Spring Boot and the speed expected from modern JavaScript runtimes.

AsenaJS is designed to make developers familiar with Spring Boot and Quarkus feel at home in the TypeScript ecosystem. As the framework evolves, we remain committed to this philosophy—bringing more proven patterns from the Java world while maintaining the performance advantages that Bun provides and flexiblity of Typescript.

Documentation

📚 Full documentation: asena.sh

For complete guides, API reference, and advanced topics, visit our documentation site.

Example Project: AsenaExample - See latest usage patterns and best practices.

Quick Start

# Create new project
bun add -g @asenajs/asena-cli
asena create my-project --adapter=hono --logger --eslint --prettier
cd my-project

# Start development
asena dev start

Visit asena.sh/docs/get-started for detailed setup instructions.

Performance

Built on Bun runtime for exceptional performance:

Framework Requests/sec Latency (avg)
Asena + Ergenecore 294,962.61 1.34ms
Hono 266,476.83 1.49ms
Asena + Hono-adapter 233,182.35 1.70ms
NestJS (Bun) 100,975.20 3.92ms
NestJS (Node) 88,083.22 5.33ms

Benchmark: 12 threads, 400 connections, 120s duration, Hello World endpoint

Contributing

Contributions are welcome! Submit a Pull Request on GitHub.

License

MIT License - see LICENSE file.

Support

Issues or questions? Open an issue on GitHub.