chore: add Railpack configs for api, dashboard, and discord-bot and create Dokploy deployment guide

Author: fazlulShanto

.nvmrc

@@ -1 +1 @@
-v22.16.0
+v24.14.0

DOKPLOY.md

@@ -0,0 +1,80 @@
+# Dokploy Deployment (Railway Config)
+
+This repo now includes a Railway-compatible `railpack.json` per deployable app:
+
+- `apps/api/railpack.json`
+- `apps/dashboard/railpack.json`
+- `apps/discord-bot/railpack.json`
+
+Each config is monorepo-safe and runs install/build/start from the repository root with pnpm filters.
+
+## 1) Create Services In Dokploy
+
+Create one Dokploy service per app from the same repository.
+
+### API service
+
+- Service type: Application
+- Build provider: Railway config (Railpack)
+- Root directory: `apps/api`
+- Config file: `railpack.json`
+
+### Dashboard service
+
+- Service type: Application
+- Build provider: Railway config (Railpack)
+- Root directory: `apps/dashboard`
+- Config file: `railpack.json`
+
+### Discord bot service
+
+- Service type: Application
+- Build provider: Railway config (Railpack)
+- Root directory: `apps/discord-bot`
+- Config file: `railpack.json`
+
+## 2) Environment Variables
+
+Set these variables in Dokploy per service.
+
+### API
+
+Required or strongly recommended:
+
+- `NODE_ENV=prod`
+- `HOST=0.0.0.0`
+- `PORT=5001` (or Dokploy-provided port)
+- `DATABASE_URL=<postgres-connection-string>`
+- `DATABASE_URL_NON_POOLING=<postgres-nonpooling-connection-string>`
+- `REDIS_URL=<redis-connection-string>`
+- `ALLOWED_ORIGINS=<comma-separated-frontend-origins>`
+
+Optional (feature dependent):
+
+- `SECRET`
+- `PRIVATE`
+- `PUBLIC`
+- `GITHUB_APP_NAME`
+- `GITHUB_WEBHOOK_SECRET`
+
+### Dashboard
+
+- `PORT=4173` (optional if Dokploy injects a port)
+- `VITE_PROD_API_URL=<public-api-url>`
+- `VITE_DEV_API_URL=<dev-api-url-if-needed>`
+
+### Discord bot
+
+- `NODE_ENV=prod`
+- `DATABASE_URL=<postgres-connection-string>`
+- `REDIS_URL=<redis-connection-string>`
+- `DISCORD_TOKEN=<bot-token>`
+- Any other bot-specific env variables used in `apps/discord-bot/src/config`
+
+## 3) Notes
+
+- Use pnpm-compatible Node runtime (Node 22+, as required by this repo).
+- Railpack commands invoke pnpm directly through Corepack (`corepack pnpm@10.12.1 ...`) to avoid PATH/shim issues in some builders.
+- The dashboard service runs `vite preview` and binds to `0.0.0.0`.
+- If Dokploy sets `PORT`, the dashboard config uses it. Otherwise it falls back to `4173`.
+- API and bot builds rely on workspace package `@taskcord/database`, which is why install/build commands are executed from monorepo root.

Dockerfile.api

@@ -1,6 +1,6 @@
 
 # syntax=docker/dockerfile:1.5
-FROM node:22-alpine AS builder
+FROM node:24-alpine
 WORKDIR /app
 
 # Install pnpm globally
@@ -14,31 +14,16 @@ COPY apps/discord-bot/package.json ./apps/discord-bot/
 COPY packages/ ./packages/
 
 # Use BuildKit cache mount for pnpm store to speed up repeated installs
-# Note: We don't mount node_modules as cache because turbo needs it for the build step
+# Note: We don't mount node_modules as cache because workspace linking relies on real installs
 RUN --mount=type=cache,id=pnpm-store,target=/root/.pnpm-store \
   pnpm install --frozen-lockfile
 
-# Copy rest of source and build in the builder stage
+# Copy rest of source for dev runtime
 COPY . .
-RUN pnpm run build:api
 
-
-# Runtime image: smaller, only copy build artifacts
-FROM node:22-alpine AS runtime
-WORKDIR /app
-
-# Optionally install pnpm or use node directly. If you need pnpm for starting, install it.
-RUN npm install -g pnpm
-RUN npm install -g tsdown
-
-
-# Copy built files and production node_modules from builder
-COPY --from=builder /app/apps/api/dist ./apps/api/dist
-COPY --from=builder /app/node_modules ./node_modules
-
-ENV NODE_ENV=production
+ENV NODE_ENV=local \
+  HOST=0.0.0.0 \
+  PORT=4005
 EXPOSE 4005
 
-# Replace with your production start command (adjust path/script)
-# CMD ["node", "apps/api/dist/index.js"]
 CMD ["pnpm", "--filter", "api", "dev"]

apps/api/railpack.json

@@ -2,14 +2,18 @@
   "$schema": "https://schema.railpack.com",
   "steps": {
     "install": {
-      "commands": ["pnpm install"]
+      "commands": [
+        "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[api][install] start pwd=$(pwd)\"; echo \"[api][install] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[api][install] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[api][install] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 install --frozen-lockfile"
+      ]
     },
     "build": {
       "inputs": [{ "step": "install" }],
-      "commands": ["pnpm run build"]
+      "commands": [
+        "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[api][build] start pwd=$(pwd)\"; echo \"[api][build] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[api][build] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[api][build] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 --filter api run build"
+      ]
     }
   },
   "deploy": {
-    "startCommand": "node dist/index.js"
+    "startCommand": "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[api][start] start pwd=$(pwd)\"; echo \"[api][start] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[api][start] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[api][start] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 --filter api run start"
   }
 }

apps/dashboard/railpack.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://schema.railpack.com",
+  "steps": {
+    "install": {
+      "commands": [
+        "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[dashboard][install] start pwd=$(pwd)\"; echo \"[dashboard][install] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[dashboard][install] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[dashboard][install] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 install --frozen-lockfile"
+      ]
+    },
+    "build": {
+      "inputs": [{ "step": "install" }],
+      "commands": [
+        "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[dashboard][build] start pwd=$(pwd)\"; echo \"[dashboard][build] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[dashboard][build] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[dashboard][build] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 --filter dashboard run build"
+      ]
+    }
+  },
+  "deploy": {
+    "startCommand": "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[dashboard][start] start pwd=$(pwd)\"; echo \"[dashboard][start] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[dashboard][start] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[dashboard][start] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 --filter dashboard run preview -- --host 0.0.0.0 --port ${PORT:-4173}"
+  }
+}

apps/discord-bot/railpack.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://schema.railpack.com",
+  "steps": {
+    "install": {
+      "commands": [
+        "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[bot][install] start pwd=$(pwd)\"; echo \"[bot][install] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[bot][install] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[bot][install] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 install --frozen-lockfile"
+      ]
+    },
+    "build": {
+      "inputs": [{ "step": "install" }],
+      "commands": [
+        "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[bot][build] start pwd=$(pwd)\"; echo \"[bot][build] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[bot][build] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[bot][build] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 --filter bot run build"
+      ]
+    }
+  },
+  "deploy": {
+    "startCommand": "ROOT=\"$PWD\"; while [ \"$ROOT\" != \"/\" ] && [ ! -f \"$ROOT/pnpm-workspace.yaml\" ]; do ROOT=\"$(dirname \"$ROOT\")\"; done; echo \"[bot][start] start pwd=$(pwd)\"; echo \"[bot][start] workspace root=$ROOT\"; [ -f \"$ROOT/pnpm-workspace.yaml\" ] || { echo \"[bot][start] workspace root not found\"; exit 1; }; cd \"$ROOT\" && echo \"[bot][start] run pwd=$(pwd)\" && corepack enable && corepack pnpm@10.12.1 --filter bot run start"
+  }
+}

package.json

@@ -30,7 +30,7 @@
   },
   "packageManager": "pnpm@10.12.1",
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
   },
   "name": "taskcord-bot-server",
   "workspaces": [