chore: add docker-compose configuration and update deployment docs

Author: DemoMacro

README.md

@@ -25,7 +25,8 @@ Complete API documentation is available at **https://js.gs/api/reference**
 
 ### Prerequisites
 
-- **Bun** runtime
+- **Node.js** 24+ (with TypeScript support)
+- **pnpm** package manager
 - **PostgreSQL** 14+ database
 - **ClickHouse** server for analytics storage
 - **Redis** (optional, for caching)
@@ -34,17 +35,17 @@ Complete API documentation is available at **https://js.gs/api/reference**
 
 ```bash
 # Install dependencies
-bun install
+pnpm install
 
 # Build the application
-bun run build
+pnpm run build
 ```
 
 ### Development
 
 ```bash
 # Start development server
-bun run dev
+pnpm run dev
 ```
 
 The application will be available at `http://localhost:3000`
@@ -53,21 +54,69 @@ The application will be available at `http://localhost:3000`
 
 ```bash
 # Build the application
-bun run build
+pnpm run build
 
 # Start production server
-bun run preview
+pnpm run preview
 ```
 
 #### Docker Deployment
 
+##### Option 1: Using Docker Compose (Recommended)
+
+```bash
+# Copy environment variables
+cp .env.example .env
+
+# Edit .env file to configure your database and services
+# nano .env
+
+# Start the application
+docker-compose up -d
+
+# View logs
+docker-compose logs -f app
+
+# Stop the application
+docker-compose down
+```
+
+The application will be available at `http://localhost:3000`
+
+##### Option 2: Using Docker Run
+
+```bash
+# Pull the official image
+docker pull demomacro/js.gs:latest
+
+# Run container
+docker run -d \
+  --name js-gs \
+  -p 3000:3000 \
+  --env-file .env \
+  --restart unless-stopped \
+  demomacro/js.gs:latest
+
+# View logs
+docker logs -f js-gs
+
+# Stop the container
+docker stop js-gs
+docker rm js-gs
+```
+
+##### Option 3: Build from Source
+
 ```bash
 # Build Docker image
 docker build -t js.gs .
 
 # Run container
-docker run -p 3000:3000 \
+docker run -d \
+  --name js-gs \
+  -p 3000:3000 \
   --env-file .env \
+  --restart unless-stopped \
   js.gs
 ```
 

docker-compose.yml

@@ -0,0 +1,53 @@
+services:
+  app:
+    image: demomacro/js.gs:latest
+    container_name: js-gs-app
+    restart: unless-stopped
+    ports:
+      - "3000:3000"
+    environment:
+      # Better Auth Configuration
+      BETTER_AUTH_URL: ${BETTER_AUTH_URL}
+      BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET}
+
+      # Database Configuration
+      DATABASE_URL: ${DATABASE_URL}
+
+      # ClickHouse Configuration
+      CLICKHOUSE_URL: ${CLICKHOUSE_URL}
+      CLICKHOUSE_USERNAME: ${CLICKHOUSE_USERNAME}
+      CLICKHOUSE_PASSWORD: ${CLICKHOUSE_PASSWORD}
+      CLICKHOUSE_DATABASE: ${CLICKHOUSE_DATABASE}
+
+      # Redis Configuration
+      REDIS_URL: ${REDIS_URL}
+
+      # Admin User Configuration
+      ADMIN_EMAIL: ${ADMIN_EMAIL}
+      ADMIN_NAME: ${ADMIN_NAME}
+      ADMIN_USERNAME: ${ADMIN_USERNAME}
+      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
+
+      # Resend Email Service
+      RESEND_API_KEY: ${RESEND_API_KEY}
+      RESEND_FROM_EMAIL: ${RESEND_FROM_EMAIL}
+
+      # Build Configuration
+      SKIP_MIGRATE: ${SKIP_MIGRATE:-false}
+
+      # Node Environment
+      NODE_ENV: production
+    networks:
+      - js-gs-network
+    healthcheck:
+      test:
+        ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3000/api/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+networks:
+  js-gs-network:
+    driver: bridge
+    name: js-gs-network

pm2.config.mjs

@@ -1,7 +1,7 @@
 export const apps = [
   {
     name: "JS.GS",
-    script: "bun",
-    args: ".output/server/index.mjs",
+    script: "node",
+    args: "--env-file=.env .output/server/index.mjs",
   },
 ];