test script and dynamic server with --scale on dockercompose

Author: matteosusca

README.md

@@ -28,14 +28,16 @@ Draw together on a shared canvas — like r/place, but for friends.
 ### Docker (Recommended)
 
 ```bash
-docker compose up
+docker compose up -d --scale server=3
 ```
 
 | Service | URL |
 |---------|-----|
 | App | http://localhost:5173 |
 | API Docs | http://localhost:3000/api-docs |
 
+> 💡 **Dynamic Scaling:** You can add more server instances at any time using `--scale server=N`. Nginx is configured with `least_conn` to balance active connections across all instances.
+
 ### Manual
 
 ```bash

docker-compose.yml

@@ -30,39 +30,18 @@ services:
     networks:
       - pixie-net
 
-  server-a:
+  server:
     build:
       context: ./server
       target: dev-stage
-    container_name: pixie-server-a
+    image: pixie-server:dev
+    deploy:
+      endpoint_mode: dnsrr
     environment:
       PORT: 3000
       MONGO_URI: mongodb://mongo:27017/pixie
       CLIENT_ORIGIN: http://localhost:5173
       JWT_SECRET: dev-secret-key
-      SERVER_ID: server-a
-      REDIS_URL: redis://redis:6379
-    volumes:
-      - ./server/src:/app/src
-      - ./server/pixie-api.yaml:/app/pixie-api.yaml
-    depends_on:
-      - mongo
-      - redis
-    networks:
-      - pixie-net
-    command: npm run dev
-
-  server-b:
-    build:
-      context: ./server
-      target: dev-stage
-    container_name: pixie-server-b
-    environment:
-      PORT: 3000
-      MONGO_URI: mongodb://mongo:27017/pixie
-      CLIENT_ORIGIN: http://localhost:5173
-      JWT_SECRET: dev-secret-key
-      SERVER_ID: server-b
       REDIS_URL: redis://redis:6379
     volumes:
       - ./server/src:/app/src
@@ -82,8 +61,7 @@ services:
     volumes:
       - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
     depends_on:
-      - server-a
-      - server-b
+      - server
     networks:
       - pixie-net
 

nginx/nginx.conf

@@ -4,8 +4,9 @@ events {
 
 http {
     upstream backend {
-        server server-a:3000;
-        server server-b:3000;
+        least_conn;
+        # Docker's internal DNS will resolve 'server' to all container IPs
+        server server:3000;
     }
 
     server {

package.json

@@ -0,0 +1,12 @@
+{
+  "name": "pixie",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Real-time collaborative pixel art editor",
+  "scripts": {
+    "test": "bash test.sh"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}