Version CSS and JS URLs in production builds

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.3.1
+
+- Version `site.css` and `site.js` URLs in production builds (`?v=` plus the commit SHA, or the build time outside GitHub Actions) so visitors get new styles after a deploy without a hard refresh.
+
 ## 0.3.0
 
 - Redesign the home page with an editorial layout: display-size hero with a photo stage and floating countdown, photo-backed live preview, capabilities bento grid, workflow tabs with steps and copy commands, a proof section with stats, image-led journal cards, FAQ, and a closing waitlist band over photography.

config/prod.exs

@@ -16,7 +16,14 @@ public_path_prefix =
     p -> String.trim_trailing(p, "/")
   end
 
+asset_version =
+  case System.get_env("GITHUB_SHA") do
+    sha when is_binary(sha) and sha != "" -> String.slice(sha, 0, 12)
+    _ -> Integer.to_string(System.os_time(:second))
+  end
+
 config :soonex, :public_path_prefix, public_path_prefix
+config :soonex, :asset_version, asset_version
 config :tableau, :config, url: site_url
 config :tableau, Tableau.PostExtension, future: false, dir: ["_posts"]
 config :tableau, Tableau.PageExtension, dir: ["_pages"]

lib/layouts/root_layout.ex

@@ -146,8 +146,8 @@ defmodule Soonex.RootLayout do
           type="font/woff2"
           crossorigin
         />
-        <link rel="stylesheet" href={Soonex.Public.path("/css/site.css")} />
-        <script type="module" src={Soonex.Public.path("/js/site.js")} />
+        <link rel="stylesheet" href={Soonex.Public.asset("/css/site.css")} />
+        <script type="module" src={Soonex.Public.asset("/js/site.js")} />
       </head>
 
       <body class="layout typo flex min-h-dvh min-w-0 flex-col overflow-x-clip bg-root text-ink antialiased">

lib/soonex/public.ex

@@ -15,4 +15,11 @@ defmodule Soonex.Public do
       pfx -> pfx <> root
     end
   end
+
+  def asset(path) when is_binary(path) do
+    case Application.get_env(:soonex, :asset_version) do
+      version when is_binary(version) and version != "" -> path(path) <> "?v=" <> version
+      _ -> path(path)
+    end
+  end
 end

mix.exs

@@ -4,7 +4,7 @@ defmodule Soonex.MixProject do
   def project do
     [
       app: :soonex,
-      version: "0.3.0",
+      version: "0.3.1",
       elixir: "~> 1.17",
       start_permanent: Mix.env() == :prod,
       elixirc_paths: elixirc_paths(Mix.env()),