build(deps): replace ex_cldr with localize and localize_web

Migrate off ex_cldr before support ends in 2027 and drop compile-time locale downloads.

Author: swiffer

.github/actions/setup-elixir-and-cache-deps/action.yml

@@ -49,7 +49,6 @@ runs:
       with:
         path: |
           _build
-          priv/cldr/locales
         key: ${{ runner.os }}-${{ steps.beam.outputs.elixir-version }}-${{ steps.beam.outputs.otp-version }}-mix-build-${{ inputs.mix-env }}-${{ hashFiles('**/mix.lock') }}
         restore-keys: |
           ${{ runner.os }}-${{ steps.beam.outputs.elixir-version }}-${{ steps.beam.outputs.otp-version }}-mix-build-${{ inputs.mix-env }}-

CHANGELOG.md

@@ -16,6 +16,7 @@
 - ci: purge orphaned GHCR attestation referrers (#5622 - @swiffer)
 - test: stop the app in test_helper instead of relying on --no-start (#5615 - @swiffer)
 - build(deps): update flake.lock (#5613)
+- build(deps): replace `ex_cldr` / `ex_cldr_plugs` with `localize` and `localize_web` (ex_cldr support ends 2027-12-31). Drops compile-time locale download and the Nix `cldr` pin.
 
 #### Dashboards
 

Dockerfile

@@ -43,7 +43,7 @@ COPY VERSION VERSION
 RUN mix compile
 
 COPY config/runtime.exs config/runtime.exs
-RUN SKIP_LOCALE_DOWNLOAD=true mix release --path /opt/built
+RUN mix release --path /opt/built
 
 ########################################################################
 

config/config.exs

@@ -30,6 +30,35 @@ config :phoenix,
 
 config :gettext, :default_locale, "en"
 
+# Static list so compile-time Localize calls see the same set as runtime.
+# Use CLDR IDs (hyphens, :"zh-Hans") — expanding Gettext names like
+# "zh_Hans" collapses to :zh via likely subtags and loses zh-Hant.
+config :localize,
+  otp_app: :teslamate,
+  default_locale: :en,
+  allow_runtime_locale_download: false,
+  supported_locales: [
+    :ca,
+    :da,
+    :de,
+    :en,
+    :es,
+    :fi,
+    :fr,
+    :hu,
+    :it,
+    :ja,
+    :ko,
+    :nb,
+    :nl,
+    :sv,
+    :th,
+    :tr,
+    :uk,
+    :"zh-Hans",
+    :"zh-Hant"
+  ]
+
 config :elixir, :time_zone_database, Tzdata.TimeZoneDatabase
 
 import_config "#{config_env()}.exs"

lib/teslamate_web/cldr.ex

@@ -16,8 +16,7 @@ defmodule TeslaMateWeb.CarController do
   def index(conn, _) do
     live_render(conn, TeslaMateWeb.CarLive.Index,
       session: %{
-        "settings" => conn.assigns[:settings],
-        "locale" => get_session(conn, :locale)
+        "settings" => conn.assigns[:settings]
       }
     )
   end

lib/teslamate_web/controllers/car_controller.ex

@@ -5,8 +5,15 @@ defmodule TeslaMateWeb.InitAssigns do
 
   import Phoenix.Component
 
-  def on_mount(:locale, _params, %{"gettext_locale" => locale}, socket) do
-    Gettext.put_locale(locale)
-    {:cont, assign(socket, :locale, locale)}
+  def on_mount(:locale, _params, session, socket) do
+    case Localize.Plug.put_locale_from_session(session, gettext: TeslaMateWeb.Gettext) do
+      {:ok, _locale} ->
+        :ok
+
+      {:error, _reason} ->
+        Gettext.put_locale(TeslaMateWeb.Gettext, "en")
+    end
+
+    {:cont, assign(socket, :locale, Gettext.get_locale(TeslaMateWeb.Gettext))}
   end
 end

lib/teslamate_web/live/init_assigns.ex

@@ -134,9 +134,8 @@ defmodule TeslaMateWeb.SettingsLive.Index do
                  |> Enum.map(fn {key, val} -> {val, key} end)
                  |> Enum.into(%{})
 
-  @supported_ui_languages TeslaMateWeb.Cldr.known_locale_names()
-                          |> Enum.reject(&(&1 in [:zh]))
-                          |> Enum.map(&String.replace(to_string(&1), "-", "_"))
+  @supported_ui_languages TeslaMateWeb.Gettext
+                          |> Gettext.known_locales()
                           |> Enum.map(&{Map.get(@language_tags, &1, &1), &1})
                           |> Enum.sort_by(&elem(&1, 0))
 

lib/teslamate_web/live/settings_live/index.ex

@@ -8,17 +8,14 @@ defmodule TeslaMateWeb.Router do
     plug :fetch_session
     plug :fetch_live_flash
 
-    plug Cldr.Plug.AcceptLanguage,
-      cldr_backend: TeslaMateWeb.Cldr,
-      no_match_log_level: :debug
-
-    plug Cldr.Plug.PutLocale,
-      apps: [:cldr, :gettext],
+    # Query first so the settings UI language switcher (?locale=) beats session.
+    plug Localize.Plug.PutLocale,
       from: [:query, :session, :accept_language],
+      param: "locale",
       gettext: TeslaMateWeb.Gettext,
-      cldr: TeslaMateWeb.Cldr
+      default: :en
 
-    plug TeslaMateWeb.Plugs.PutSession
+    plug Localize.Plug.PutSession, as: :string
 
     plug :put_root_layout, {TeslaMateWeb.LayoutView, :root}
     plug :protect_from_forgery