A Lean Framework for Enterprise Scalability.
"Complexity doesn't have to be heavy.
Built on Bun, designed for Logic, optimized for Scale."
- Zero Magic: All data flows are transparent (Logic-first).
- Native Speed: Maximizing Bun & Gaman Wire.
- Opt-in Complexity Go enterprise scale only when you need it.
GamanJS currently only supports Bun runtime.
bun create gaman@latestGamanJS embraces the Feature-Based Modularity philosophy. This structure is designed to keep applications clean, easy to test, and scalable as your business expands.
In a production scale or Enterprise project, the GamanJS folder structure will look like this:
src/
├── index.ts # The Orchestrator (Entry Point)
├── database/ # Database Configuration
└── modules/ # Powerhouse of your Application
├── app/ # Infrastructure Module (Global/Shared)
│ ├── controllers/ # Handlers for Global Requests (Health, Index)
│ │ └── AppController.ts
│ ├── services/ # Shared Utilities & System Services
│ │ └── AppService.ts
│ └── AppRouter.ts # Global Middleware & Base Routing
│
└── user/ # Feature Module (Example: User Management)
├── controllers/ # Request Handlers (Login, Register, Profile)
│ └── UserController.ts
├── services/ # Business Logic (Auth Logic, User CRUD)
│ └── UserService.ts
├── models/ # Data Access Layer (Powered by @gaman/orm)
│ └── UserModel.ts
└── UserRouter.ts # Scoped Routes & Feature Middleware
visit our https://gamanjs.github.io/
New Contributing welcome! Check out our Contributing Guide for help getting started.
