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": "*"

 }

}