🚀 Quick Start

npx create-aagun-app my-app
cd my-app
npm run dev

🔥 Features

• ⚡ Express + TypeScript powered
• 💅 Decorator-based route & middleware definitions
• 🧱 File-based controller structure
• 🚦 Built-in middleware support
• 🧰 Powerful CLI (aagun dev, aagun build, aagun start, aagun generate)
• ♻️ Hot Reloading in dev mode
• 🔐 Default AuthMiddleware + cookie helpers
• 📆 Optimized for performance in production

📁 Project Structure

Type-Based (Default)

src/
├── controllers/
│   └── home.controller.ts
├── middleware/
│   └── auth.middleware.ts
├── models/
├── utils/
├── index.ts
aagun.config.ts

Module-Based (Optional)

src/
├── modules/
│   ├── auth/
│   │   ├── auth.controller.ts
│   │   ├── auth.middleware.ts
│   │   ├── auth.model.ts
│   │   └── auth.utils.ts
│   └── booking/
│       ├── booking.controller.ts
│       ├── booking.middleware.ts
│       ├── booking.model.ts
│       └── booking.utils.ts
├── index.ts
aagun.config.ts

Use aagun.config.ts to switch between structures or detect mismatches.

⚙️ CLI Commands

# Start development server with hot reload
aagun dev

# Build the project for production
aagun build

# Start production server
aagun start

# Doctor: Check for dependency or structure issues
aagun doctor

# Fix mismatches in dependency versions or structure
aagun fix

# Generate controller/model/service files
aagun generate -c Auth

# Example of full generate usage
aagun generate -c Auth --module

# Create new project (used internally by create-aagun-app)
aagun create my-app

🧪 Coming Soon

• ✅ API caching
• ✅ Job scheduling
• ✅ File upload module
• ✅ Mongo & SQL support
• ✅ GraphQL + WebSocket

📆 Packages

| Package | Description | |---------|-------------| | aagun | CLI tool & dev runner | | create-aagun-app | Scaffolds a new Aagun.js project | | @aagun/core | Core framework logic & runtime |

👨‍💼 Contributing

Contributions, feedback, and PRs are welcome!
Open an issue or submit a PR — we’d love to improve Aagun.js together 🔥

📄 License

MIT © Ayan Das

🌐 Links

• Website
• GitHub
• Documentation (coming soon)