turbo-docker-monorepo

Init

git clone https://github.com/moofoo/turbo-docker-monorepo && cd turbo-docker-monorepo && yarn && yarn workspace shared-module build && yarn

Docker commands

Development

docker compose [OPTIONS] COMMAND

Production

docker compose -f docker-compose.prod.yml [OTHER OPTIONS] COMMAND

Re-build and Re-start project after changing dependencies (development)

docker compose stop && docker compose up -d -V --build --force-recreate

NextJS differences (from standard boilerplate)

• next.config.js

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: "standalone",
};

module.exports = nextConfig;

• package.json (added 'server' script)

{
  "name": "frontend",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "next lint",
    "server": "node server.js"
  },
  "dependencies": {
    "@types/node": "20.1.7",
    "@types/react": "18.2.6",
    "@types/react-dom": "18.2.4",
    "eslint": "8.40.0",
    "eslint-config-next": "13.4.2",
    "next": "13.4.2",
    "react": "18.2.0",
    "react-dom": "18.2.0",
    "typescript": "5.0.4"
  }
}

NestJS differences (from standard boilerplate)

• main.ts

import {NestFactory} from "@nestjs/core";
import {AppModule} from "./app.module";
import {exampleFunc} from "shared-module"; // from packages/shared-module

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  exampleFunc();

  await app.listen(process.env.PORT || 3333, process.env.IN_CONTAINER === "1" ? "0.0.0.0" : "127.0.0.1");
}
bootstrap();

Docker Notes

Follow these steps when adding app dependencies:

1 - Add the dependencies

yarn workspace add APP_NAME DEPENDENCY (or yarn workspace add -D ... for dev deps)

for example,

yarn workspace backend add bcrypt

2 - Run docker compose up -d --build --force-recreate for service

docker compose up -d -V --force-recreate --build backend

3 - Restart the project (so the nginx service doesn't lose the plot)

docker compose restart

References

• Turborepo - Deploying with Docker
• NextJS - With Docker Compose example