This document describes how to create shared packages and build/run services in the Cotrav monorepo. It is Confluence-ready and can be pasted directly.

cotrav-services/
│
├─ package.json (root – workspaces enabled)
│
├─ packages/ (shared libraries)
│ ├─ logger/
│ ├─ errors/
│ ├─ middlewares/
│ └─ tsconfig.json (base TS config for packages)
│
├─ workspace/ (runtime services)
│ ├─ auth-service/
│ ├─ booking-service/
│ └─ payment-service/
│
└─ node_modules/

Root package.json

The root enables npm workspaces so shared packages can be consumed without publishing.

cmd

npm install

package/logger

cmd

npm run build --workspace=packages/logger

package/errors

cmd

npm run build --workspace=packages/errors

Repeat the same steps for:

• @cotrav/errors
• @cotrav/middlewares

Only business logic differs, structure remains identical.

Example: auth-service

Folder Creation

cd workspace
mkdir auth-service
cd auth-service
npm init -y

Service package.json

{
"name": "auth-service",
"version": "1.0.0",
"private": true,
"type": "commonjs",
"scripts": {
"dev": "ts-node src/app.ts",
"build": "tsc",
"start": "node dist/app.js"
},
"dependencies": {
"express": "^5.0.0",
"dotenv": "^17.0.0",
"@cotrav/logger": "*",
"@cotrav/errors": "*",
"@cotrav/middlewares": "*"
 }
}