feat: add Dockerfile for Node.js backend #111

README.md

@@ -135,6 +135,27 @@ npm run dev:backend
 
 API: http://localhost:3001 (health: http://localhost:3001/health, v1: http://localhost:3001/api/v1).
 
+#### Run backend with Docker
+
+```bash
+# from repository root
+docker build -f backend/Dockerfile -t trivela-backend .
+
+docker run --rm -p 3001:3001 \
+  -e PORT=3001 \
+  -e STELLAR_NETWORK=testnet \
+  -e SOROBAN_RPC_URL=https://soroban-testnet.stellar.org \
+  -e CORS_ALLOWED_ORIGINS=http://localhost:5173 \
+  -e TRIVELA_API_KEY=dev-secret \
+  trivela-backend
+```
+
+or using an env file:
+
+```bash
+docker run --rm -p 3001:3001 --env-file backend/.env trivela-backend
+```
+
 ### 4. Run frontend
 
 ```bash

backend/.dockerignore

@@ -0,0 +1,8 @@
+node_modules
+npm-debug.log
+Dockerfile
+.dockerignore
+.git
+.gitignore
+*.md
+.vscode

backend/Dockerfile

@@ -1,15 +1,28 @@
-FROM node:20-alpine AS base
+# Backend Dockerfile
+# Build and run the Node.js Express API in a small, production-ready image
 
+FROM node:20-alpine AS builder
 WORKDIR /app
 
+# Copy package files and install dependencies (production only)
 COPY backend/package*.json ./
 RUN npm ci --omit=dev
 
-COPY backend/src ./src
+# Copy source and non-code assets
+COPY backend/ ./
+
+# Optional step if your code pipeline has a build step
+# RUN npm run build
+
+FROM node:20-alpine AS runtime
+WORKDIR /app
+
+COPY --from=builder /app ./
 
 ENV NODE_ENV=production
 ENV PORT=3001
 
 EXPOSE 3001
 
 CMD ["node", "src/server.js"]
+

backend/README.md

@@ -130,6 +130,12 @@ Build image from repo root:
 docker build -f backend/Dockerfile -t trivela-backend .
 ```
 
+Or build using backend as context (recommended for isolation):
+
+```bash
+docker build -f backend/Dockerfile -t trivela-backend backend/
+```
+
 Run container (example):
 
 ```bash
@@ -141,3 +147,11 @@ docker run --rm -p 3001:3001 \
   -e TRIVELA_API_KEY=dev-secret \
   trivela-backend
 ```
+
+You can also use an env file:
+
+```bash
+docker run --rm -p 3001:3001 --env-file backend/.env \
+  trivela-backend
+```
+