Project Structure

1my-api/
2├── src/
3│   └── server.ts          # the whole app
4├── moro.config.ts         # optional config
5├── package.json
6└── tsconfig.json

1import { createApp, z } from '@morojs/moro';
2
3// createApp() is async — it must be awaited.
4const app = await createApp();
5
6const CreateUser = z.object({
7  name: z.string().min(2).max(50),
8  email: z.string().email(),
9});
10
11app.get('/health', (req, res) => res.json({ status: 'ok' }));
12
13// Chainable, type-safe routes — validation runs before your handler
14app.post('/users')
15  .body(CreateUser)
16  .rateLimit({ requests: 10, window: 60000 })
17  .handler((req, res) => {
18    // req.body is fully typed from the schema
19    return res.json({ created: req.body });
20  });
21
22app.listen(3000);

1my-app/
2├── src/
3│   ├── server.ts              # bootstrap: createApp, loadRoutes, loadModule
4│   ├── modules/               # feature modules → /api/v{version}/{name}
5│   │   ├── users/
6│   │   │   ├── index.ts       # defineModule({ name, version, routes })
7│   │   │   ├── actions.ts     # handler functions (the logic)
8│   │   │   └── schemas.ts     # Zod validation schemas
9│   │   ├── products/
10│   │   └── orders/
11│   ├── routes/                # auto-loaded, literal-path endpoints
12│   │   ├── health.ts
13│   │   └── auth/
14│   │       ├── index.ts
15│   │       └── actions.ts
16│   ├── websockets/            # auto-loaded real-time namespaces
17│   │   └── chat.ts
18│   ├── middleware/            # shared middleware (auth, etc.)
19│   ├── services/              # shared services (database, logger)
20│   ├── jobs/                  # scheduled background jobs
21│   └── types/
22│       └── index.ts
23├── moro.config.ts
24├── package.json
25└── tsconfig.json

1platform-api/
2├── src/
3│   ├── index.ts               # bootstrap entry point
4│   ├── modules/               # one folder per business domain
5│   │   ├── auth/
6│   │   │   ├── index.ts       # defineModule({ name, version, config, routes })
7│   │   │   ├── routes.ts      # route definitions, imported into index.ts
8│   │   │   ├── actions.ts     # business logic
9│   │   │   ├── schemas.ts     # Zod schemas
10│   │   │   ├── middleware.ts  # module-scoped middleware
11│   │   │   ├── config.ts      # module settings
12│   │   │   └── types.ts
13│   │   ├── billing/
14│   │   ├── users/
15│   │   └── notifications/
16│   ├── routes/                # top-level + versioned literal routes
17│   │   └── v1/
18│   ├── websockets/            # real-time namespaces
19│   ├── middlewares/           # global middleware (request-id, csrf, ...)
20│   ├── database/              # ORM layer
21│   │   ├── index.ts
22│   │   ├── connection.ts
23│   │   ├── migrate.ts
24│   │   ├── migrations/
25│   │   ├── schema/
26│   │   └── seeds/
27│   ├── config/                # app & domain configuration
28│   ├── libs/                  # shared helpers, services, utils, types
29│   ├── services/              # cross-cutting services (queue, email, ...)
30│   ├── jobs/                  # background workers
31│   └── types/
32├── moro.config.ts             # full AppConfig
33├── drizzle.config.ts          # ORM config (optional)
34├── Dockerfile                 # container build (optional)
35├── manifests/                 # k8s manifests (optional)
36├── scripts/                   # migrate, seed, ops scripts
37├── package.json
38└── tsconfig.json

1import { defineModule } from '@morojs/moro';
2import { routes } from './routes.js';
3
4export default defineModule({
5  name: 'auth',
6  version: '1.0.0',
7  config: {
8    description: 'Authentication with role-based access control',
9    tags: ['auth', 'security'],
10  },
11  routes,
12});
13
14// Re-export the pieces other modules need
15export { authMiddleware, requireAuth, requireRole } from './middleware.js';
16export * as actions from './actions.js';
17export * from './types.js';