solid_stack_web 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f03b011e27e9dfeb227c490906e1fd6c985e9cf6f9f5538fb07b5f24c3a1fcbc
-  data.tar.gz: 4c97b7832de0a0073e156eb411de5b07d449684a84f9a77025d3bcdb500c31e7
+  metadata.gz: db27129d1f850266817f633ff0109fdd3708c7105fdea6d0bcf3035ec1734769
+  data.tar.gz: 1549319d21ac55da226b2ce4487a8a8a1340531b13c838643fb2754843620518
 SHA512:
-  metadata.gz: cffad880c519141a308b856ea4cb582a14e128f900477d3860de3f1962616a50ea33b4da1c4c5a25f22e452c3dc132dc3881131bcb38cd2cac96b4324eed02ab
-  data.tar.gz: 455c1bd6a67c02ed6daed933e17c1f903cfdee45d2b57dfc17da255f58fd7b9ed1c1a9bd16900fbf96df70691bedc4014cdb2978bec3fabfd099f968716604cb
+  metadata.gz: '02499cb54b94ad58e62204d18f60780cc88e22c62706248f5fb60a4905f36eb822e8243de0351df15a915f740501bde0b973fa9e6a17754ba2741b64f4b6b695'
+  data.tar.gz: 627aae0342fa4f93ef0a6e25b89e56764ff6bda2e2c75d7b0315675ee2daacdc2e57ed428698485302b2a6950725bf5d63bb5c5c51a6e566d55f141cbf820c08

data/README.md

@@ -1,12 +1,48 @@
 # SolidStackWeb
 
 [![CI](https://github.com/eclectic-coding/solid_stack_web/actions/workflows/ci.yml/badge.svg)](https://github.com/eclectic-coding/solid_stack_web/actions/workflows/ci.yml)
-[![Gem Version](https://badge.fury.io/rb/solid_stack_web.svg)](https://badge.fury.io/rb/solid_stack_web)
+[![Gem Version](https://img.shields.io/gem/v/solid_stack_web.svg)](https://rubygems.org/gems/solid_stack_web)
 [![Downloads](https://img.shields.io/gem/dt/solid_stack_web.svg)](https://rubygems.org/gems/solid_stack_web)
 [![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.3-ruby)](https://www.ruby-lang.org)
 [![codecov](https://codecov.io/gh/eclectic-coding/solid_stack_web/branch/main/graph/badge.svg)](https://codecov.io/gh/eclectic-coding/solid_stack_web)
 
-A production-ready operations dashboard for the full Rails Solid Stack. Mount one engine to get deep visibility into **Solid Queue** (job browser, failed job retry, queue controls, recurring tasks, performance stats), **Solid Cache** (entry browser, size distribution, write timeline), and **Solid Cable** (channel browser, message list, purge controls) — with dark mode, CSV export, alert webhooks, and a JSON metrics endpoint, all with no asset pipeline dependency.
+A production-ready operations dashboard for the full Rails Solid Stack. Mount one engine to get deep visibility into **Solid Queue** (job browser, failed job retry, queue controls, recurring tasks, performance stats), **Solid Cache** (entry browser, size distribution, write timeline), and **Solid Cable** (channel browser, message list, purge controls) — with dark mode, i18n locale switching, custom nav links, custom dashboard cards, CSV export, alert webhooks, and a JSON metrics endpoint, all with no asset pipeline dependency.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Screenshots](#screenshots)
+- [Metrics endpoint](#metrics-endpoint)
+- [General configuration](#general-configuration)
+  - [Authentication](#authentication)
+  - [Linking to the dashboard](#linking-to-the-dashboard)
+- [i18n](#i18n)
+  - [Adding a custom locale](#adding-a-custom-locale)
+- [Extensibility](#extensibility)
+  - [Custom nav links](#custom-nav-links)
+  - [Custom dashboard cards](#custom-dashboard-cards)
+- [Security](#security)
+  - [Authentication](#authentication-1)
+  - [Sensitive cache values](#sensitive-cache-values)
+  - [CSRF protection](#csrf-protection)
+  - [Rate limiting and network exposure](#rate-limiting-and-network-exposure)
+- [Solid Queue](#solid-queue)
+  - [Features](#features)
+  - [Configuration](#configuration)
+    - [Job Filtering](#job-filtering)
+- [Solid Cache](#solid-cache)
+  - [Features](#features-1)
+- [Solid Cable](#solid-cable)
+  - [Features](#features-2)
+- [Requirements](#requirements)
+- [Versioning](#versioning)
+  - [Public API](#public-api)
+  - [Not part of the public API](#not-part-of-the-public-api)
+  - [Deprecation policy](#deprecation-policy)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
 
 ## Installation
 
@@ -30,12 +66,16 @@ rails generate solid_stack_web:install
 
 This creates `config/initializers/solid_stack_web.rb` with every configuration option commented inline, and injects `mount SolidStackWeb::Engine, at: "/solid_stack"` into `config/routes.rb`. The dashboard will then be available at `/solid_stack` (or whatever path you choose).
 
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## Screenshots
 
 ![SolidStackWeb dashboard](docs/screenshots/demo.gif)
 
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## Metrics endpoint
@@ -64,6 +104,8 @@ This creates `config/initializers/solid_stack_web.rb` with every configuration o
 
 `slow_jobs` is only present when `slow_job_threshold` is configured. The endpoint is protected by the same authentication as the rest of the dashboard.
 
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## General configuration
@@ -84,6 +126,12 @@ SolidStackWeb.configure do |config|
   # Multi-database — pass a connects_to hash when Solid Queue / Cache / Cable
   # live on a separate database from your primary (default: nil, uses primary).
   config.connects_to = { database: { writing: :queue, reading: :queue } }
+
+  # Custom nav links — appended to the main navigation bar (default: []).
+  config.nav_links = [{ label: "Admin", url: "/admin" }]
+
+  # Custom dashboard cards — rendered after the built-in cards (default: []).
+  config.dashboard_cards = [{ title: "My App", stats: -> { { "Users" => User.count } } }]
 end
 ```
 
@@ -99,6 +147,85 @@ The `authenticate` block is evaluated in the context of each request's controlle
 link_to "Queue Dashboard", SolidStackWeb.mount_path
 ```
 
+[↑ Back to top](#table-of-contents)
+
+---
+
+## i18n
+
+All dashboard UI strings — page titles, table headers, button labels, empty states, flash messages, and sparkline tooltips — are backed by locale YAML files. The engine ships with **English (`en`)** and **Spanish (`es`)** built in.
+
+A language selector appears in the dashboard header and lets users switch locales at runtime. The selected locale is stored in the session and applied via `I18n.with_locale`, so it persists across requests without touching the host application's locale. The `?locale=` query param takes precedence over the session value, making it easy to deep-link to a specific language.
+
+The switcher is automatically hidden when `config.available_locales` contains only one entry.
+
+```ruby
+SolidStackWeb.configure do |config|
+  # Locales shown in the language switcher (default: [:en, :es]).
+  # Set to [:en] to hide the switcher entirely.
+  config.available_locales = [:en, :es]
+end
+```
+
+### Adding a custom locale
+
+1. Create a locale file in your host application under `config/locales/`, e.g. `config/locales/solid_stack_web.fr.yml`.
+2. Nest all keys under `fr > solid_stack_web:` — use `config/locales/en.yml` in the gem as a reference for the full key list.
+3. Add the locale symbol to `config.available_locales`:
+
+```ruby
+config.available_locales = [:en, :es, :fr]
+```
+
+Rails will pick up the file automatically via its standard `config.i18n.load_path`; no additional configuration is needed.
+
+[↑ Back to top](#table-of-contents)
+
+---
+
+## Extensibility
+
+### Custom nav links
+
+`config.nav_links` appends extra links to the main navigation bar after the built-in Queue / Cache / Cable links. Use it to link back to your host application's admin pages or related tools without modifying the engine layout.
+
+```ruby
+SolidStackWeb.configure do |config|
+  config.nav_links = [
+    { label: "Back to App", url: "/" },
+    { label: "Admin",       url: "/admin" }
+  ]
+end
+```
+
+Defaults to `[]` — no extra links appear when unconfigured.
+
+### Custom dashboard cards
+
+`config.dashboard_cards` adds custom stat cards to the overview dashboard after the built-in Queue, Cache, and Cable cards. Each card accepts three keys:
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `title` | String | Card heading (required) |
+| `link` | `{ label:, url: }` | Optional header link rendered top-right |
+| `stats` | Lambda | Optional — called at render time; must return a `{ label => value }` hash |
+
+```ruby
+SolidStackWeb.configure do |config|
+  config.dashboard_cards = [
+    {
+      title: "My App",
+      link:  { label: "View Admin", url: "/admin" },
+      stats: -> { { "Users" => User.count, "Premium" => User.premium.count } }
+    }
+  ]
+end
+```
+
+The `stats` lambda runs on every dashboard render, so keep it fast. Defaults to `[]` — no custom cards appear when unconfigured.
+
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## Security
@@ -137,6 +264,8 @@ The dashboard is designed to be mounted behind your application's existing authe
 - Restricting access by IP at the reverse-proxy level
 - Applying [Rack::Attack](https://github.com/rack/rack-attack) rules to the mount path
 
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## Solid Queue
@@ -159,6 +288,7 @@ The dashboard is designed to be mounted behind your application's existing authe
 - **Turbo Stream** job discard — removes the row inline without a full page reload
 - **Sticky filter preferences** — last-used status, period, and queue filter saved to `localStorage`; a fresh visit to the jobs or history list with no URL params automatically restores the previous selection
 - **Dark mode** — toggle button in the header switches between light and dark palettes; preference persisted in `localStorage`; respects `prefers-color-scheme` on first visit
+- **i18n / locale switching** — all UI strings backed by locale YAML files; ships with English (`en`) and Spanish (`es`); a language selector in the header lets users switch at runtime; locale is stored in the session and persists across requests; configure which locales appear via `config.available_locales`
 - **Responsive layout** — stats cards, tables, and two-column grids adapt to narrow viewports; tables scroll horizontally rather than overflow; split page headers stack on small screens
 - **Empty-state improvements** — all list views show a contextual title and an actionable hint; search empty states include a "Clear search" link; filters-active history view offers "Clear filters"; processes and recurring tasks explain the next step
 - **Inline notifications** — bulk and single-job actions surface a flash notice; Turbo Stream discard responses inject the message inline without a full page reload; bulk actions report the affected count ("3 jobs discarded")
@@ -192,6 +322,12 @@ SolidStackWeb.configure do |config|
   # Show the raw serialized value on the cache entry detail page (default: false).
   # Disable for stores that contain sensitive data.
   config.allow_value_preview = true
+
+  # Locales shown in the language switcher (default: [:en, :es]).
+  # The switcher is hidden when only one locale is configured.
+  # To add a locale, provide a locale YAML file under your app's config/locales/
+  # with keys nested under solid_stack_web:, then add the locale symbol here.
+  config.available_locales = [:en, :es]
 end
 ```
 
@@ -208,6 +344,8 @@ The jobs list supports four independent filters, all driven by query params:
 
 Filters are preserved when switching between status tabs (Ready / Scheduled / Running / Blocked) and when discarding a job. They can be combined freely.
 
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## Solid Cache
@@ -224,6 +362,8 @@ Filters are preserved when switching between status tabs (Ready / Scheduled / Ru
 - **Delete entry** — per-row delete button or detail-page button removes a single cache entry
 - **Flush All** — header button deletes every cache entry with a confirmation prompt
 
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## Solid Cable
@@ -236,6 +376,8 @@ Filters are preserved when switching between status tabs (Ready / Scheduled / Ru
 - **Per-channel message list** — `GET /cable/channels/:channel_hash` shows a paginated, reverse-chronological list of that channel's `SolidCable::Message` records; each row shows the message ID, a truncated payload preview (120 chars) with the full payload on hover, and a relative sent time with the exact timestamp on hover; supports `?q=` filtering by payload substring; **Purge Channel** button deletes all messages for the channel
 - **Message purge** — "Purge Old" form on the channel browser deletes all messages older than 1, 7, or 30 days; confirmation prompt before any destructive action
 
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## Requirements
@@ -248,6 +390,10 @@ Filters are preserved when switching between status tabs (Ready / Scheduled / Ru
 - [turbo-rails](https://github.com/hotwired/turbo-rails) >= 2.0
 - [importmap-rails](https://github.com/rails/importmap-rails) >= 1.2
 
+[↑ Back to top](#table-of-contents)
+
+---
+
 ## Versioning
 
 SolidStackWeb follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
@@ -276,6 +422,8 @@ The following are internal and may change in any release without notice:
 
 When a public API item is renamed or removed, the old interface is deprecated in a **minor** release — it continues to work but issues an `ActiveSupport::Deprecation` warning pointing to the replacement. The old interface is removed in the next **major** release. The [UPGRADING.md](UPGRADING.md) file documents every breaking change and the migration steps.
 
+[↑ Back to top](#table-of-contents)
+
 ---
 
 ## Contributing
@@ -287,6 +435,12 @@ When a public API item is renamed or removed, the old interface is deprecated in
 
 Bug reports and feature requests are welcome on [GitHub Issues](https://github.com/eclectic-coding/solid_stack_web/issues).
 
+[↑ Back to top](#table-of-contents)
+
+---
+
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+[↑ Back to top](#table-of-contents)

data/app/assets/stylesheets/solid_stack_web/_02_layout.css

@@ -117,3 +117,15 @@
 }
 .sqw-flash--notice { background: #d1e7dd; color: #0a3622; border: 1px solid #a3cfbb; }
 .sqw-flash--alert  { background: #f8d7da; color: #58151c; border: 1px solid #f1aeb5; }
+
+.sqw-locale-form { display: flex; align-items: center; flex-shrink: 0; }
+.sqw-locale-select {
+  font-size: 12px;
+  padding: 0.2rem 0.4rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--surface);
+  color: var(--muted);
+  cursor: pointer;
+  height: 28px;
+}

data/app/assets/stylesheets/solid_stack_web/_07_dashboard.css

@@ -16,9 +16,10 @@
 }
 .sqw-gem-card:hover { box-shadow: 0 3px 8px rgba(0,0,0,.12); }
 
-.sqw-gem-card--queue { border-top-color: var(--primary); }
-.sqw-gem-card--cache { border-top-color: var(--purple); }
-.sqw-gem-card--cable { border-top-color: var(--info); }
+.sqw-gem-card--queue   { border-top-color: var(--primary); }
+.sqw-gem-card--cache   { border-top-color: var(--purple); }
+.sqw-gem-card--cable   { border-top-color: var(--info); }
+.sqw-gem-card--custom  { border-top-color: var(--muted); }
 
 .sqw-gem-card__header {
   display: flex;

data/app/controllers/solid_stack_web/application_controller.rb

@@ -7,6 +7,7 @@ module SolidStackWeb
     PERIOD_DURATIONS = { "1h" => 1.hour, "24h" => 24.hours, "7d" => 7.days }.freeze
 
     before_action :authenticate!
+    around_action :with_locale
     around_action :with_database_connection
 
     rescue_from StandardError do |exception|
@@ -29,6 +30,15 @@ module SolidStackWeb
       end
     end
 
+    def with_locale
+      available = SolidStackWeb.available_locales.map(&:to_s)
+      locale = params[:locale].presence_in(available) ||
+               session[:solid_stack_web_locale].presence_in(available) ||
+               I18n.default_locale.to_s
+      session[:solid_stack_web_locale] = locale
+      I18n.with_locale(locale) { yield }
+    end
+
     def with_database_connection
       config = SolidStackWeb.connects_to
       return yield unless config

data/app/controllers/solid_stack_web/audit_controller.rb

@@ -3,7 +3,7 @@ module SolidStackWeb
     def index
       unless AuditEvent.table_exists?
         redirect_to root_path,
-                    alert: "Audit log requires running `rails solid_stack_web:install:migrations && rails db:migrate`."
+                    alert: t("solid_stack_web.flash.audit_migration_required")
         return
       end
 

data/app/controllers/solid_stack_web/cable/channel_purges_controller.rb

@@ -2,7 +2,7 @@ module SolidStackWeb
   class Cable::ChannelPurgesController < ApplicationController
     def destroy
       ::SolidCable::Message.where(channel_hash: params[:channel_hash]).delete_all
-      redirect_to cable_path, notice: "All messages for this channel have been purged."
+      redirect_to cable_path, notice: t("solid_stack_web.flash.channel_purged")
     end
   end
 end

data/app/controllers/solid_stack_web/cable/purges_controller.rb

@@ -3,7 +3,7 @@ module SolidStackWeb
     def destroy
       days = [params[:older_than].to_i, 1].max
       ::SolidCable::Message.where("created_at < ?", days.days.ago).delete_all
-      redirect_to cable_path, notice: "Messages older than #{days} #{days == 1 ? "day" : "days"} purged."
+      redirect_to cable_path, notice: t("solid_stack_web.flash.messages_purged", count: days)
     end
   end
 end

data/app/controllers/solid_stack_web/cache/flushes_controller.rb

@@ -2,7 +2,7 @@ module SolidStackWeb
   class Cache::FlushesController < ApplicationController
     def destroy
       ::SolidCache::Entry.delete_all
-      redirect_to cache_entries_path, notice: "All cache entries flushed."
+      redirect_to cache_entries_path, notice: t("solid_stack_web.flash.cache_flushed")
     end
   end
 end

data/app/controllers/solid_stack_web/cache_entries_controller.rb

@@ -18,7 +18,7 @@ module SolidStackWeb
     def destroy
       ::SolidCache::Entry.find(params[:id]).destroy
       redirect_to cache_entries_path(q: params[:q], column: params[:column], direction: params[:direction]),
-                  notice: "Cache entry deleted."
+                  notice: t("solid_stack_web.flash.cache_entry_deleted")
     end
 
     private

data/app/controllers/solid_stack_web/failed_jobs/arguments_controller.rb

@@ -6,11 +6,11 @@ module SolidStackWeb
         new_arguments = JSON.parse(params[:arguments])
         @execution.job.update!(arguments: new_arguments)
         @execution.retry
-        redirect_to failed_jobs_path, notice: "Arguments updated and job queued for retry."
+        redirect_to failed_jobs_path, notice: t("solid_stack_web.flash.arguments_updated")
       rescue JSON::ParserError
-        redirect_to failed_job_path(@execution), alert: "Invalid JSON — arguments were not saved."
+        redirect_to failed_job_path(@execution), alert: t("solid_stack_web.flash.invalid_json")
       rescue => e
-        redirect_to failed_jobs_path, alert: "Could not update job: #{e.message}"
+        redirect_to failed_jobs_path, alert: t("solid_stack_web.flash.cannot_update_job", error: e.message)
       end
     end
   end

data/app/controllers/solid_stack_web/failed_jobs/selections_controller.rb

@@ -7,18 +7,18 @@ module SolidStackWeb
         count = @ids.size
         SolidQueue::FailedExecution.where(id: @ids).each(&:retry)
         record_audit("failed_jobs_retried", item_count: count)
-        redirect_to failed_jobs_path, notice: "#{count} #{count == 1 ? "job" : "jobs"} retried."
+        redirect_to failed_jobs_path, notice: t("solid_stack_web.flash.jobs_retried", count: count)
       rescue => e
-        redirect_to failed_jobs_path, alert: "Could not retry jobs: #{e.message}"
+        redirect_to failed_jobs_path, alert: t("solid_stack_web.flash.cannot_retry_jobs", error: e.message)
       end
 
       def destroy
         job_ids = SolidQueue::FailedExecution.where(id: @ids).pluck(:job_id)
         count = SolidQueue::Job.where(id: job_ids).destroy_all.size
         record_audit("failed_jobs_discarded", item_count: count)
-        redirect_to failed_jobs_path, notice: "#{count} #{count == 1 ? "job" : "jobs"} discarded."
+        redirect_to failed_jobs_path, notice: t("solid_stack_web.flash.jobs_discarded", count: count)
       rescue => e
-        redirect_to failed_jobs_path, alert: "Could not discard jobs: #{e.message}"
+        redirect_to failed_jobs_path, alert: t("solid_stack_web.flash.cannot_discard_jobs", error: e.message)
       end
 
       private

data/app/controllers/solid_stack_web/failed_jobs_controller.rb

@@ -33,7 +33,7 @@ module SolidStackWeb
       @execution.job.destroy!
       record_audit("failed_job_discarded", job_class: job_class, queue_name: queue_name)
       @executions_remain = ::SolidQueue::FailedExecution.exists?
-      @notice = "Job discarded."
+      @notice = t("solid_stack_web.flash.job_discarded")
 
       respond_to do |format|
         format.html { redirect_to failed_jobs_path }
@@ -45,7 +45,7 @@ module SolidStackWeb
       execution = ::SolidQueue::FailedExecution.find(params[:id])
       record_audit("failed_job_retried", job_class: execution.job.class_name, queue_name: execution.job.queue_name)
       execution.retry
-      redirect_to failed_jobs_path, notice: "Job retried."
+      redirect_to failed_jobs_path, notice: t("solid_stack_web.flash.job_retried")
     end
 
     private

data/app/controllers/solid_stack_web/jobs/selections_controller.rb

@@ -3,7 +3,7 @@ module SolidStackWeb
     class SelectionsController < ApplicationController
       def destroy
         status = params[:status].presence_in(Job::STATUSES) || "ready"
-        raise ArgumentError, "Cannot discard #{status} jobs." unless Job::DISCARDABLE.include?(status)
+        raise ArgumentError, t("solid_stack_web.flash.cannot_discard", status: status) unless Job::DISCARDABLE.include?(status)
 
         ids     = Array(params[:job_ids]).map(&:to_i).reject(&:zero?)
         job_ids = Job::EXECUTION_MODELS[status].where(id: ids).pluck(:job_id)
@@ -18,7 +18,7 @@ module SolidStackWeb
           priority:  params[:priority].presence,
           sort:      params[:sort].presence,
           direction: params[:direction].presence
-        ), notice: "#{count} #{count == 1 ? "job" : "jobs"} discarded."
+        ), notice: t("solid_stack_web.flash.jobs_discarded", count: count)
       rescue ArgumentError => e
         redirect_to jobs_path(status: params[:status]), alert: e.message
       end

data/app/controllers/solid_stack_web/jobs_controller.rb

@@ -36,7 +36,7 @@ module SolidStackWeb
         @execution.job.destroy!
         record_audit("job_discarded", job_class: job_class, queue_name: queue_name)
         @executions_remain = Job::EXECUTION_MODELS[@status].exists?
-        @notice = "Job discarded."
+        @notice = t("solid_stack_web.flash.job_discarded")
 
         respond_to do |format|
           format.html { redirect_to jobs_path(status: @status, q: @search, queue: @queue, period: @period, priority: @priority, sort: @sort, direction: @direction) }
@@ -47,7 +47,7 @@ module SolidStackWeb
         count = SolidQueue::Job.where(id: job_ids).destroy_all.size
         record_audit("jobs_discarded", item_count: count)
         redirect_to jobs_path(status: @status, q: @search, queue: @queue, period: @period, priority: @priority, sort: @sort, direction: @direction),
-                    notice: "#{count} #{count == 1 ? "job" : "jobs"} discarded."
+                    notice: t("solid_stack_web.flash.jobs_discarded", count: count)
       end
     end
 

data/app/controllers/solid_stack_web/recurring_tasks/runs_controller.rb

@@ -5,14 +5,14 @@ module SolidStackWeb
       result = task.enqueue(at: Time.current)
 
       if result
-        redirect_to recurring_tasks_path, notice: "\"#{task.key}\" queued for immediate execution."
+        redirect_to recurring_tasks_path, notice: t("solid_stack_web.flash.task_queued", key: task.key)
       else
-        redirect_to recurring_tasks_path, alert: "Could not enqueue \"#{task.key}\" — it may have just run."
+        redirect_to recurring_tasks_path, alert: t("solid_stack_web.flash.cannot_enqueue_task", key: task.key)
       end
     rescue ActiveRecord::RecordNotFound
-      redirect_to recurring_tasks_path, alert: "Recurring task not found."
+      redirect_to recurring_tasks_path, alert: t("solid_stack_web.flash.task_not_found")
     rescue => e
-      redirect_to recurring_tasks_path, alert: "Could not run task: #{e.message}"
+      redirect_to recurring_tasks_path, alert: t("solid_stack_web.flash.cannot_run_task", error: e.message)
     end
   end
 end

data/app/controllers/solid_stack_web/scheduled_jobs_controller.rb

@@ -6,10 +6,10 @@ module SolidStackWeb
       SolidQueue::ScheduledExecution.where(job_id: job_ids).update_all(scheduled_at: 1.second.ago)
       SolidQueue::Job.where(id: job_ids).update_all(scheduled_at: 1.second.ago)
       redirect_to jobs_path(status: "scheduled", period: @period),
-                  notice: "#{job_ids.size} #{"job".pluralize(job_ids.size)} scheduled to run immediately."
+                  notice: t("solid_stack_web.flash.jobs_run_immediately", count: job_ids.size)
     rescue => e
       redirect_to jobs_path(status: "scheduled", period: @period),
-                  alert: "Could not run jobs: #{e.message}"
+                  alert: t("solid_stack_web.flash.cannot_run_jobs", error: e.message)
     end
 
     def update
@@ -24,14 +24,14 @@ module SolidStackWeb
       respond_to do |format|
         format.turbo_stream
         format.html do
-          notice = @run_now ? "Job scheduled to run immediately." : "Job rescheduled by +#{params[:offset]}."
+          notice = @run_now ? t("solid_stack_web.flash.job_run_immediately") : t("solid_stack_web.flash.job_rescheduled", offset: params[:offset])
           redirect_to jobs_path(status: "scheduled", period: @period), notice: notice
         end
       end
     rescue ArgumentError => e
       redirect_to jobs_path(status: "scheduled"), alert: e.message
     rescue => e
-      redirect_to jobs_path(status: "scheduled"), alert: "Could not reschedule job: #{e.message}"
+      redirect_to jobs_path(status: "scheduled"), alert: t("solid_stack_web.flash.cannot_reschedule_job", error: e.message)
     end
 
     private
@@ -44,7 +44,7 @@ module SolidStackWeb
 
     def resolve_new_time(execution, offset)
       return 1.second.ago if offset == "now"
-      raise ArgumentError, "Invalid offset." unless PERIOD_DURATIONS.key?(offset)
+      raise ArgumentError, t("solid_stack_web.flash.invalid_offset") unless PERIOD_DURATIONS.key?(offset)
 
       execution.scheduled_at + PERIOD_DURATIONS[offset]
     end

data/app/helpers/solid_stack_web/application_helper.rb

@@ -35,11 +35,14 @@ module SolidStackWeb
       build_sparkline_svg(
         Struct.new(:buckets, :max).new(timeline.entry_buckets, timeline.entry_max),
         css_class: "sqw-sparkline sqw-sparkline--lg",
-        aria_label: "Cache entries written over the last 24 hours"
+        aria_label: t("solid_stack_web.helpers.cache_entry_this_hour", count: 0).gsub(/\d+/, "…")
       ) do |count, i|
         hours_ago = CacheTimeline::HOURS - 1 - i
-        hours_ago.zero? ? "#{count} #{"entry".then { |w| count == 1 ? w : "entries" }} this hour" \
-                        : "#{count} #{"entry".then { |w| count == 1 ? w : "entries" }} #{hours_ago}h ago"
+        if hours_ago.zero?
+          t("solid_stack_web.helpers.cache_entry_this_hour", count: count)
+        else
+          t("solid_stack_web.helpers.cache_entry_hours_ago", count: count, hours: hours_ago)
+        end
       end
     end
 
@@ -47,11 +50,15 @@ module SolidStackWeb
       build_sparkline_svg(
         Struct.new(:buckets, :max).new(timeline.byte_buckets, timeline.byte_max),
         css_class: "sqw-sparkline sqw-sparkline--lg",
-        aria_label: "Cache bytes written over the last 24 hours"
+        aria_label: t("solid_stack_web.cache.bytes_written")
       ) do |bytes, i|
         hours_ago = CacheTimeline::HOURS - 1 - i
         size = number_to_human_size(bytes)
-        hours_ago.zero? ? "#{size} written this hour" : "#{size} written #{hours_ago}h ago"
+        if hours_ago.zero?
+          t("solid_stack_web.helpers.cache_size_this_hour", size: size)
+        else
+          t("solid_stack_web.helpers.cache_size_hours_ago", size: size, hours: hours_ago)
+        end
       end
     end
 
@@ -59,31 +66,37 @@ module SolidStackWeb
       build_sparkline_svg(
         Struct.new(:buckets, :max).new(timeline.message_buckets, timeline.message_max),
         css_class: "sqw-sparkline sqw-sparkline--lg",
-        aria_label: "Cable messages over the last 24 hours"
+        aria_label: t("solid_stack_web.cable.messages_timeline")
       ) do |count, i|
         hours_ago = CableTimeline::HOURS - 1 - i
-        label = count == 1 ? "message" : "messages"
-        hours_ago.zero? ? "#{count} #{label} this hour" : "#{count} #{label} #{hours_ago}h ago"
+        if hours_ago.zero?
+          t("solid_stack_web.helpers.cable_message_this_hour", count: count)
+        else
+          t("solid_stack_web.helpers.cable_message_hours_ago", count: count, hours: hours_ago)
+        end
       end
     end
 
     def throughput_sparkline_svg(sparkline)
-      build_sparkline_svg(sparkline, aria_label: "Throughput over the last 12 hours") do |count, i|
+      build_sparkline_svg(sparkline, aria_label: t("solid_stack_web.dashboard.throughput_label")) do |count, i|
         hours_ago = SolidStackWeb::ThroughputSparkline::HOURS - i
         if hours_ago == 1
-          "#{count} #{count == 1 ? "job" : "jobs"} in the last hour"
+          t("solid_stack_web.helpers.throughput_last_hour", count: count)
         else
-          "#{count} #{count == 1 ? "job" : "jobs"} (#{hours_ago}h–#{hours_ago - 1}h ago)"
+          t("solid_stack_web.helpers.throughput_hours_ago", count: count, from: hours_ago, to: hours_ago - 1)
         end
       end
     end
 
     def queue_depth_sparkline_svg(sparkline)
       build_sparkline_svg(sparkline, css_class: "sqw-sparkline sqw-sparkline--sm",
-                                     aria_label: "Queue depth over the last 12 hours") do |count, i|
+                                     aria_label: t("solid_stack_web.queues.col_depth")) do |count, i|
         hours_ago = SolidStackWeb::QueueDepthSparkline::HOURS - 1 - i
-        jobs_word = count == 1 ? "job" : "jobs"
-        hours_ago.zero? ? "#{count} ready #{jobs_word} now" : "#{count} ready #{jobs_word} #{hours_ago}h ago"
+        if hours_ago.zero?
+          t("solid_stack_web.helpers.queue_depth_now", count: count)
+        else
+          t("solid_stack_web.helpers.queue_depth_hours_ago", count: count, hours: hours_ago)
+        end
       end
     end
 
@@ -110,12 +123,12 @@ module SolidStackWeb
     end
 
     def failed_job_sparkline_svg(sparkline)
-      build_sparkline_svg(sparkline, aria_label: "Failed jobs over the last 12 hours") do |count, i|
+      build_sparkline_svg(sparkline, aria_label: t("solid_stack_web.dashboard.failures_label")) do |count, i|
         hours_ago = SolidStackWeb::FailedJobSparkline::HOURS - i
         if hours_ago == 1
-          "#{count} #{count == 1 ? "failure" : "failures"} in the last hour"
+          t("solid_stack_web.helpers.failure_last_hour", count: count)
         else
-          "#{count} #{count == 1 ? "failure" : "failures"} (#{hours_ago}h–#{hours_ago - 1}h ago)"
+          t("solid_stack_web.helpers.failure_hours_ago", count: count, from: hours_ago, to: hours_ago - 1)
         end
       end
     end