feat: display app version in UI footer

- Add version package with build-time variables - Inject version via ldflags in Dockerfile using git describe - Show version in footer on every page - Log version and commit on server startup
2026-03-03 09:37:24 -10:00
4 changed files with 24 additions and 4 deletions
--- a/7
+++ b/7
@@ -1,6 +1,6 @@
 FROM docker.io/golang:1.25.4-alpine AS build

-RUN apk add --no-cache upx
+RUN apk add --no-cache upx git

 WORKDIR /src
 COPY go.mod go.sum ./
@@ -10,7 +10,10 @@ COPY . .
 RUN go tool templ generate
 RUN go tool gotailwind -i assets/css/input.css -o assets/css/output.css --minify
 RUN --mount=type=cache,target=/root/.cache/go-build \
-    CGO_ENABLED=0 go build -ldflags="-s" -o /bin/games .
+    MODULE=$(head -1 go.mod | awk '{print $2}') && \
+    VERSION=$(git describe --tags --always) && \
+    COMMIT=$(git rev-parse --short HEAD) && \
+    CGO_ENABLED=0 go build -ldflags="-s -X $MODULE/version.Version=$VERSION -X $MODULE/version.Commit=$COMMIT" -o /bin/games .
 RUN upx -9 -k /bin/games

 FROM scratch
--- a/features/common/layouts/base.templ
+++ b/features/common/layouts/base.templ
@@ -1,6 +1,9 @@
 package layouts

-import "github.com/ryanhamamura/games/config"
+import (
+	"github.com/ryanhamamura/games/config"
+	"github.com/ryanhamamura/games/version"
+)

 templ Base(title string) {
 	<!DOCTYPE html>
@@ -16,6 +19,9 @@ templ Base(title string) {
 				<div data-init="@get('/reload', {retryMaxCount: 1000, retryInterval:20, retryMaxWaitMs:200})"></div>
 			}
 			{ children... }
+			<footer class="fixed bottom-1 right-2 text-xs text-gray-500">
+				{ version.Version }
+			</footer>
 		</body>
 	</html>
 }
--- a/main.go
+++ b/main.go
@@ -20,6 +20,7 @@ import (
 	"github.com/ryanhamamura/games/router"
 	"github.com/ryanhamamura/games/sessions"
 	"github.com/ryanhamamura/games/snake"
+	"github.com/ryanhamamura/games/version"

 	"github.com/go-chi/chi/v5"
 	"github.com/go-chi/chi/v5/middleware"
@@ -45,7 +46,7 @@ func main() {
 func run(ctx context.Context) error {
 	cfg := config.Global
 	addr := fmt.Sprintf("%s:%s", cfg.Host, cfg.Port)
-	slog.Info("server starting", "addr", addr)
+	slog.Info("server starting", "addr", addr, "version", version.Version, "commit", version.Commit)
 	defer slog.Info("server shutdown complete")

 	eg, egctx := errgroup.WithContext(ctx)
--- a/version/version.go
+++ b/version/version.go
@@ -0,0 +1,10 @@
+// Package version holds build-time version information injected via ldflags.
+package version
+
+// Version and Commit are set at build time via:
+//
+//	-ldflags "-X github.com/ryanhamamura/games/version.Version=... -X github.com/ryanhamamura/games/version.Commit=..."
+var (
+	Version = "dev"
+	Commit  = "unknown"
+)