feature: new dynamic version number control in code

Author: fxai

.github/workflows/release.yml

@@ -44,10 +44,16 @@ jobs:
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
+      - name: Get short SHA
+        id: vars
+        run: echo "sha_short=$(git rev-parse --short HEAD)" >> $GITHUB_ENV
+
       - name: Build and push Docker image
         uses: docker/build-push-action@v5
         with:
           context: .
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            APP_VERSION=${{ steps.meta.outputs.version == 'main' && format('latest-{0}', env.sha_short) || steps.meta.outputs.version }}

Dockerfile

@@ -3,6 +3,10 @@ FROM oven/bun:1 AS frontend-builder
 
 WORKDIR /app/frontend
 
+# Catch build argument and expose it to Vite
+ARG APP_VERSION=dev
+ENV VITE_APP_VERSION=$APP_VERSION
+
 # Copy package files
 COPY frontend/package.json frontend/bun.lock ./
 
@@ -22,6 +26,10 @@ FROM python:3.14-slim AS backend-runner
 
 WORKDIR /app
 
+# Catch build argument and expose it to the backend
+ARG APP_VERSION=dev
+ENV RAPTR_VERSION=$APP_VERSION
+
 # Install uv
 COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
 

backend/app/core/config.py

@@ -14,6 +14,7 @@ class Settings(BaseSettings):
     LOG_LEVEL: str = "INFO"
 
     # General settings
+    RAPTR_VERSION: str = "dev-local"
     APPLICATION_NAME: str = "RAPTR"
     ADMIN_EMAIL: str = "admin@raptr.app"
     ADMIN_PASSWORD: str | None = None

backend/app/main.py

@@ -35,7 +35,7 @@ async def lifespan(app: FastAPI):
 app = FastAPI(
     lifespan=lifespan,
     title="RAPTR Backend API",
-    version="0.1.0-beta.1",
+    version=settings.RAPTR_VERSION,
     openapi_url="/openapi.json" if settings.FASTAPI_DOCUMENTATION else None,
 )
 

backend/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "raptr-backend-api"
-version = "0.1.0-beta.1"
+version = "0.0.0.dev0"
 description = "The backend API for the RAPTR application"
 readme = "README.md"
 requires-python = ">=3.14"

backend/uv.lock

@@ -1,7 +1,7 @@
 {
     "name": "raptr",
     "private": true,
-    "version": "0.1.0-beta.1",
+    "version": "dev-local",
     "type": "module",
     "scripts": {
         "dev": "vite",

frontend/openapi.json

@@ -2,6 +2,7 @@ import path from 'node:path';
 import tailwindcss from '@tailwindcss/vite';
 import vue from '@vitejs/plugin-vue';
 import { defineConfig } from 'vite';
+import pkg from './package.json';
 
 export default defineConfig({
     plugins: [vue(), tailwindcss()],
@@ -11,6 +12,8 @@ export default defineConfig({
         },
     },
     define: {
-        __APP_VERSION__: JSON.stringify(process.env.npm_package_version),
+        __APP_VERSION__: JSON.stringify(
+            process.env.VITE_APP_VERSION || pkg.version,
+        ),
     },
 });