Get started
Create or add AponiaJS to a Bun application using the implemented alpha API.
AponiaJS adds modules, decorated controllers, request parameter decorators, route validation, singleton dependency injection, and structured application bootstrap to Elysia applications running on Bun.
Experimental release
AponiaJS 0.6.0-alpha.18 is under active development and is not recommended
for production workloads. Check the current limitations before adopting it for
a long-lived application.
Choose a path
Create a project
Generate the standard AponiaJS application layout with the CLI.
Add to an existing project
Install the HTTP application packages and configure TypeScript manually.
Then
Prerequisites
Confirm the Bun, ESM, decorator, and package requirements.
Your first route
Add a controller, a service, and a validated route.
Project structure
Read the generated layout and where new features belong.
Troubleshooting
Resolve the common graph, decorator, CLI, and version errors.
What you will build
The starter request path is intentionally small:
main.ts
-> AponiaFactory.create(AppModule)
-> AppModule
-> AppController
-> AppServicemain.ts owns bootstrap and listening. Modules define application boundaries,
controllers own routes, and injectable services own application behavior.
Continue with your first route after creating or configuring a project.