nodejs-project-structure

Node.js Project Structure

NestJS

yourorg-order-service/
├── src/
│   ├── main.ts                          # Bootstrap
│   ├── app.module.ts                    # Root module
│   ├── order/
│   │   ├── order.module.ts              # Feature module
│   │   ├── order.controller.ts
│   │   ├── order.controller.spec.ts
│   │   ├── order.service.ts
│   │   ├── order.service.spec.ts
│   │   ├── order.repository.ts
│   │   ├── dto/
│   │   │   ├── create-order.dto.ts
│   │   │   └── order-response.dto.ts
│   │   └── entities/
│   │       └── order.entity.ts
│   └── common/
│       ├── filters/
│       │   └── http-exception.filter.ts
│       └── pipes/
│           └── zod-validation.pipe.ts
├── test/
│   └── order.e2e-spec.ts
├── package.json
├── tsconfig.json
├── tsconfig.build.json
├── nest-cli.json
└── README.md

Express

yourorg-order-service/
├── src/
│   ├── index.ts                         # Entry point
│   ├── app.ts                           # Express app setup
│   ├── routes/
│   │   └── order.routes.ts
│   ├── controllers/
│   │   └── order.controller.ts
│   ├── services/
│   │   └── order.service.ts
│   ├── middleware/
│   │   ├── error-handler.ts
│   │   └── validate.ts
│   └── types/
│       └── order.types.ts
├── tests/
│   ├── order.controller.test.ts
│   └── order.service.test.ts
├── package.json
├── tsconfig.json
└── README.md

Monorepo (npm workspaces)

yourorg-platform/
├── packages/
│   ├── api/           # NestJS API
│   ├── gateway/       # Express BFF
│   └── shared/        # Shared types/utils
├── package.json       # workspaces: ["packages/*"]
├── tsconfig.base.json # Shared TS config
└── turbo.json         # Turborepo config (optional)

TypeScript Config

• "strict": true always
• "module": "NodeNext", "moduleResolution": "NodeNext"
• "target": "ES2022" minimum
• Use tsconfig.base.json for shared settings in monorepos
• Use path aliases sparingly — prefer relative imports