Welcome to AzuraJS ⚡

AzuraJS is a modern, high-performance web framework for Node.js and Bun that brings the power of TypeScript decorators to backend development. Build elegant, type-safe APIs with a clean and intuitive syntax.

✨ Why Choose AzuraJS?

🎨 Key Features

AzuraJS comes with everything you need to build professional APIs:

💉 Smart Parameter Injection

Powerful decorators like @Body, @Query, @Param, @Req, @Res, @Headers, @Cookies and more - access request data elegantly and type-safely.

✅ Built-in Validation

Complete DTO and schema validation system with type safety. Validate data automatically before processing requests.

🍪 Cookie Management

Native cookie parser and serializer - work with cookies simply and securely, without extra packages.

🌐 Configurable CORS

Production-ready CORS plugin with flexible configuration - protect your API and control access easily.

🛡️ Built-in Rate Limiting

Protect your application against abuse and DDoS with configurable per-route rate limiting.

⚡ Cluster Mode

Leverage all CPU cores with native cluster support - maximize production performance.

📊 Contextual Logging

Smart logging system that adapts to the environment - verbose in development, concise in production.

🚨 Robust Error Handling

HttpError class and error middleware for structured and consistent exception handling.

🚀 See How Simple It Is

Here's a complete CRUD API example in less than 30 lines:

import { AzuraClient } from "azurajs";
import { applyDecorators } from "azurajs/decorators";
import { Controller, Get, Post, Body, Param } from "azurajs/decorators";

@Controller("/api/users")
class UserController {
  // GET /api/users - List all users
  @Get()
  getAllUsers() {
    return { users: ["Alice", "Bob", "Charlie"] };
  }

  // GET /api/users/:id - Get user by ID
  @Get("/:id")
  getUser(@Param("id") id: string) {
    return { id, name: `User ${id}` };
  }

  // POST /api/users - Create new user
  @Post()
  createUser(@Body() data: any) {
    return { 
      id: Date.now(), 
      ...data,
      createdAt: new Date().toISOString()
    };
  }
}

// Initialize and register controllers
const app = new AzuraClient();
applyDecorators(app, [UserController]);

// Start the server
await app.listen(3000);
console.log("🚀 API running at http://localhost:3000");

📚 Next Steps

Start your journey with AzuraJS by following these guides:

💡 Key Differences

AzuraJS vs Express

AzuraJS vs NestJS

🌟 Community

AzuraJS is open source and welcomes contributions! Join our community:

• ⭐ GitHub Repository
• 📦 NPM Package
• 🐛 Report Issues
• 💬 Discussions

Ready to build something amazing? Let's get started! 🎉