From e0711dddb5fb85a4c691cd50b726a180dd7307eb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ionu=C8=9B=20Staicu?= <iamntz@users.noreply.github.com>
Date: Thu, 14 Aug 2025 07:42:24 +0300
Subject: [PATCH] feat: Add docker compose to quickly run a dev env (#891)

* feat: Add docker compose to quickly run a dev env
* removed packages
---
 CONTRIBUTING.md          |  3 ++
 booklore-ui/package.json |  2 +-
 dev.docker-compose.yml   | 61 ++++++++++++++++++++++++++++++++++++++++
 3 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 dev.docker-compose.yml

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 58ef1ae6e..965b9110c 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -41,6 +41,9 @@ cd booklore
 
 ## 🧱 Local Development Setup
 
+Either run  `docker compose -f dev.docker-compose.yml up` or install & run everything Locally (described below).
+
+
 ### 1. Prerequisites
 
 - **Java 21+**
diff --git a/booklore-ui/package.json b/booklore-ui/package.json
index a00ab1007..063fcf259 100644
--- a/booklore-ui/package.json
+++ b/booklore-ui/package.json
@@ -58,7 +58,7 @@
     "karma-jasmine": "^5.1.0",
     "karma-jasmine-html-reporter": "^2.1.0",
     "tailwindcss": "3.4.17",
-    "typescript": "^5.8.2",
+    "typescript": "~5.8.2",
     "typescript-eslint": "^8.39.0"
   }
 }
diff --git a/dev.docker-compose.yml b/dev.docker-compose.yml
new file mode 100644
index 000000000..4ac12b568
--- /dev/null
+++ b/dev.docker-compose.yml
@@ -0,0 +1,61 @@
+services:
+  backend:
+    image: gradle:8-jdk21-alpine
+    command: sh -c "cd /booklore-api && ./gradlew bootRun"
+    ports:
+      - "${BACKEND_PORT:-8080}:8080"
+    environment:
+      - DATABASE_URL=jdbc:mariadb://backend_db:3306/booklore
+      - DATABASE_USERNAME=booklore
+      - DATABASE_PASSWORD=booklore
+    stdin_open: true
+    tty: true
+    restart: unless-stopped
+    depends_on:
+      - backend_db
+    volumes:
+      - './booklore-api:/booklore-api'
+      - ./shared/data:/app/data
+      - ./shared/books:/books
+
+  backend_db:
+    image: mariadb:11.4
+    container_name: backend_db
+    volumes:
+      - backend_db:/var/lib/mysql
+    restart: unless-stopped
+    environment:
+      - MYSQL_ROOT_PASSWORD=booklore
+      - MYSQL_DATABASE=booklore
+      - MYSQL_USER=booklore
+      - MYSQL_PASSWORD=booklore
+    healthcheck:
+      test: [ "CMD", "mariadb-admin", "ping", "-h", "localhost", "-uroot", "-pbooklore" ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  ui:
+    image: node:22-alpine
+    command: sh -c "cd /angular-app && npm install -g @angular/cli --force && npm install --force && ng serve --host 0.0.0.0"
+    environment:
+      - NODE_ENV=development
+    stdin_open: true
+    tty: true
+    restart: unless-stopped
+    volumes:
+      - './booklore-ui:/angular-app'
+
+        # you can have node_modules in a volume. however, if you enable this, expect trouble in some IDEs, as the deps are not available anymore
+        # - node_modules:/angular-app/node_modules
+
+        # we ignore package-lock otherwise will throw
+        # An unhandled exception occurred: Cannot find module @rollup/rollup-linux-x64-musl. npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828).
+        # Please try `npm i` again after removing both package-lock.json and node_modules directory.
+      - '/dev/null:/angular-app/package-lock.json'
+    ports:
+      - "${FRONTEND_PORT:-4200}:4200"
+
+volumes:
+  node_modules:
+  backend_db:
\ No newline at end of file