Docker compose

.dockerignore

@@ -0,0 +1,15 @@
+node_modules
+Dockerfile*
+docker-compose*
+.dockerignore
+.git
+.gitignore
+README.md
+LICENSE
+.vscode
+Makefile
+helm-charts
+.env
+.editorconfig
+.idea
+coverage*

.gitignore

@@ -42,4 +42,7 @@ db/
 
 # Dist folders
 dist-static
-dist-server
+dist-server
+
+# Docker Compose environment file
+.env.docker

Dockerfile.dev

@@ -0,0 +1,8 @@
+FROM oven/bun:1.3-alpine
+
+WORKDIR /app
+
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile
+
+COPY . .

README.md

@@ -45,10 +45,19 @@ Configure your Infisical project or create a `.env` file with required variables
 bun dev
 ```
 
-This command starts:
-- PostgreSQL database (via Docker)
-- Vite dev server with HMR
-- Drizzle Studio for database management
+This command starts the following services:
+- **PostgreSQL**: Database service on port `5432`.
+- **Migrator**: Automatically runs pending migrations.
+- **Vite**: Development server with Hot Module Replacement at [localhost:5173](http://localhost:5173/).
+- **Drizzle Studio**: Database GUI at [local.drizzle.studio](https://local.drizzle.studio)
+
+The Vite server and Drizzle Studio run inside Docker containers. To ensure the stack remains fast, a custom development image is used. We bind the current directory to a Docker volume, so code changes are immediately reflected in the container.
+
+**Note on dependencies**: Since `node_modules` are cached, you must rebuild the containers if you add or change packages. You can do this by running:
+
+```bash
+bun dev --build
+```
 
 ## Scripts
 

docker-compose.dev.yml

@@ -16,3 +16,55 @@ services:
       interval: 10s
       timeout: 5s
       retries: 5
+
+  # One-time task to run migrations
+  migrator:
+    build: 
+      context: .
+      dockerfile: Dockerfile.dev
+    command: bun drizzle-kit migrate
+    depends_on:
+      postgres:
+        condition: service_healthy
+    env_file: .env.docker
+    environment:
+      - DATABASE_URL=postgresql://${POSTGRES_USER:-postgres}:${POSTGRES_PASSWORD:-postgres}@postgres:${POSTGRES_PORT:-5432}/${POSTGRES_DB:-postgres}
+
+  vite:
+    build: 
+      context: .
+      dockerfile: Dockerfile.dev
+    env_file: .env.docker
+    environment:
+      - WATCHPACK_POLLING=true
+      - DATABASE_URL=postgresql://${POSTGRES_USER:-postgres}:${POSTGRES_PASSWORD:-postgres}@postgres:${POSTGRES_PORT:-5432}/${POSTGRES_DB:-postgres}
+    command: bun run dev:app --host=0.0.0.0
+    ports:
+      - "5173:5173"
+    volumes:
+      - .:/app  # Edits on host are reflected in container
+      - /app/node_modules
+    depends_on:
+      postgres:
+        condition: service_healthy
+      migrator:
+        condition: service_completed_successfully
+
+  studio:
+    build: 
+      context: .
+      dockerfile: Dockerfile.dev
+    env_file: .env.docker
+    environment:
+      - DATABASE_URL=postgresql://${POSTGRES_USER:-postgres}:${POSTGRES_PASSWORD:-postgres}@postgres:${POSTGRES_PORT:-5432}/${POSTGRES_DB:-postgres}
+    command: bun run db:studio --port 4983 --host 0.0.0.0
+    ports:
+      - "4983:4983"
+    volumes:
+      - .:/app  # Edits on host are reflected in container
+      - /app/node_modules
+    depends_on:
+      postgres:
+        condition: service_healthy
+      migrator:
+        condition: service_completed_successfully

package.json

@@ -4,8 +4,8 @@
   "type": "module",
   "private": true,
   "scripts": {
-    "dev": "infisical run -- bun -b concurrently --names \"DOCKER,APP\" -c \"blue,magenta\" \"bun run db:start\" \"bun run db:wait && bun run dev:app\"",
-    "dev:app": "concurrently --names \"VITE,STUDIO\" -c \"cyan,yellow\" \"vite dev\" \"bun run db:studio\"",
+    "dev": "infisical export --format=dotenv > .env.docker && docker compose -f docker-compose.dev.yml up",
+    "dev:app": "vite dev",
     "db:studio": "drizzle-kit studio",
     "db:start": "docker compose -f docker-compose.dev.yml up",
     "db:wait": "bash -c 'until docker compose -f docker-compose.dev.yml exec -T postgres pg_isready -U ${POSTGRES_USER:-postgres} > /dev/null 2>&1; do sleep 1; done'",
@@ -36,7 +36,6 @@
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.2",
-    "concurrently": "^9.0.0",
     "react-router-dom": "^6.26.2",
     "tw-animate-css": "^1.4.0",
     "vite": "^7.3.0",
@@ -90,4 +89,4 @@
     "tailwindcss": "^4.1.18",
     "zod": "^4.3.5"
   }
-}
+}