Add build metadata to Docker setup and create dynamic route for version info

Author: Nasrallah-AL

Dockerfile

@@ -6,6 +6,8 @@
 # This Dockerfile uses Node.js 24.13.0-slim, which was the latest LTS version at the time of writing.
 # To ensure security and compatibility, regularly update the NODE_VERSION ARG to the latest LTS version.
 ARG NODE_VERSION=24.13.0-slim
+ARG GIT_SHA=unknown
+ARG BUILD_TIMESTAMP=unknown
 
 FROM node:${NODE_VERSION} AS dependencies
 
@@ -73,13 +75,18 @@ RUN if [ -f package-lock.json ]; then \
 
 FROM node:${NODE_VERSION} AS runner
 
+ARG GIT_SHA
+ARG BUILD_TIMESTAMP
+
 # Set working directory
 WORKDIR /app
 
 # Set production environment variables
 ENV NODE_ENV=production
 ENV PORT=3000
 ENV HOSTNAME="0.0.0.0"
+ENV APP_GIT_SHA=${GIT_SHA}
+ENV APP_BUILD_TIMESTAMP=${BUILD_TIMESTAMP}
 
 # Advertise the internal application port for platforms that auto-detect it.
 EXPOSE 3000

Dockerfile.bun

@@ -48,13 +48,18 @@ RUN bun run build
 
 FROM oven/bun:1 AS runner
 
+ARG GIT_SHA=unknown
+ARG BUILD_TIMESTAMP=unknown
+
 # Set working directory
 WORKDIR /app
 
 # Set production environment variables
 ENV NODE_ENV=production
 ENV PORT=3000
 ENV HOSTNAME="0.0.0.0"
+ENV APP_GIT_SHA=${GIT_SHA}
+ENV APP_BUILD_TIMESTAMP=${BUILD_TIMESTAMP}
 
 # Advertise the internal application port for platforms that auto-detect it.
 EXPOSE 3000

docker-compose.yml

@@ -4,6 +4,9 @@ services:
     build:
       context: .
       dockerfile: Dockerfile.bun
+      args:
+        GIT_SHA: ${GIT_SHA:-unknown}
+        BUILD_TIMESTAMP: ${BUILD_TIMESTAMP:-unknown}
     pull_policy: build
     image: nextjs-standalone-bun-image
     container_name: nextjs-standalone-bun-container
@@ -19,6 +22,9 @@ services:
     build:
       context: .
       dockerfile: Dockerfile
+      args:
+        GIT_SHA: ${GIT_SHA:-unknown}
+        BUILD_TIMESTAMP: ${BUILD_TIMESTAMP:-unknown}
     pull_policy: build
     image: nextjs-standalone-image
     container_name: nextjs-standalone-container

src/app/api/version/route.ts

@@ -0,0 +1,13 @@
+import { NextResponse } from "next/server";
+import { CURRENT_VERSION } from "@/lib/changelog";
+
+export const dynamic = "force-dynamic";
+
+export async function GET() {
+  return NextResponse.json({
+    appVersion: CURRENT_VERSION,
+    gitSha: process.env.APP_GIT_SHA ?? "unknown",
+    buildTimestamp: process.env.APP_BUILD_TIMESTAMP ?? "unknown",
+    nodeEnv: process.env.NODE_ENV ?? "unknown",
+  });
+}