Introduction

AmalaJS is a decorator-based API framework powered by Typescript and KoaJS v2+. Amala is fast, light, self-documenting and Docker-ready; Perfect for microservices.

• Define your REST API endpoints using ES8 classes and decorators.
• Inject arguments into your endpoint handlers, effectively turning your controller endpoints into standalone, testable service endpoints.
• Clean, light and FAST endpoints. Powered by Koa.
• No further magic past decorators. Full access to underlying Koa app.
• Project creator comes with fully configured Docker and Docker-compose settings for quick containerization.
• In-built OpenAPI spec generator and Swagger UI!

This leads to clean, self-documenting API endpoints, which also makes them easier to test.

When enabled, you can see your API JSON spec GET /api/docs and the Swagger UI at /api/swagger by default.

Supporting AmalaJS

AmalaJS is an MIT-licensed open source project with its ongoing development made possible entirely by community support. If AmalaJS is helping you build awesome APIs, please consider Becoming a Patron.

If you would like to contribute in other ways, Pull requests are also welcome!