SolidStackWeb

A mountable Rails engine that provides a unified web dashboard for the full Solid Stack — Solid Queue, Solid Cache, and Solid Cable — in a single interface with no asset pipeline dependency and no JavaScript runtime requirement.

• Overview dashboard with live counts across all three Solid Stack components; cards are clickable and link directly to each section
• Solid Queue — browse jobs by status (ready, scheduled, claimed, blocked) with filtering by job class, queue name, priority, and time period; manage failed jobs (retry / discard / bulk retry / bulk discard), pause/resume queues, and inspect worker processes; Bulk selection checkbox-selects individual jobs for discard or retry; Discard All bulk-discards every job matching the current filters in one request; CSV export downloads jobs or failed jobs as a CSV file respecting active filters; Per-queue browser — click any queue name or size to drill into its ready jobs with per-row and bulk discard
• Performance statistics page — GET /stats aggregates finished jobs by class name with execution count, avg, p50, p95, min, and max duration; click any column header to sort; defaults to p95 descending
• Job history view — paginated list of all finished jobs with class name, queue, duration, and finished-at time; filterable by queue (click a badge), class substring, and time period; CSV export respects active filters
• Scheduled job management — "Run Now" and offset buttons (+1h / +24h / +7d) per row update the scheduled time inline via Turbo Stream; "Run All Now (N)" in the header back-dates all matching executions at once
• Recurring task list — enumerates all SolidQueue::RecurringTask records with cron schedule, job class or command, queue, next-run and last-run times, and a static/dynamic badge; each row has a "Run Now" button that immediately enqueues the task
• Job detail page — drill into any job to see full arguments (pretty-printed JSON), queue, priority, enqueued time, Active Job ID, concurrency key, scheduled/blocked-until metadata, and a Discard button
• Failed job detail page — drill into any failed job to see the full error, backtrace, and an inline JSON argument editor; submit to update arguments and retry in one action
• Solid Cache — entry count and total byte size at a glance
• Solid Cable — active message count and distinct channel count
• Turbo Stream job discard — removes the row inline without a full page reload
• Authentication hook — plug in your own auth logic (Devise, Basic Auth, custom) via a one-line initializer
• Zero asset pipeline coupling — CSS is injected inline; safe to mount in any host app

Add the gem to your application's Gemfile:

gem "solid_stack_web"

Run:

bundle install

Mount the engine in config/routes.rb:

mount SolidStackWeb::Engine, at: "/solid_stack"

The dashboard will be available at /solid_stack (or whatever path you choose).

Create an initializer at config/initializers/solid_stack_web.rb:

SolidStackWeb.configure do |config|
  # Number of items per paginated page (default: 25)
  config.page_size = 50

  # Authentication — block runs in controller context.
  # Return a truthy value to allow access; falsy falls back to HTTP Basic.
  config.authenticate do
    current_user&.admin?
  end
end

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.

The authenticate block is evaluated in the context of each request's controller instance, so any helper method available to controllers (e.g. current_user from Devise) works directly. If the block returns false or nil, the engine falls back to HTTP Basic authentication. If no authenticate block is configured, the dashboard is open.

• Ruby >= 3.3
• Rails >= 8.1.3
• solid_queue >= 1.0
• solid_cache >= 1.0
• solid_cable >= 1.0
• turbo-rails >= 2.0
• importmap-rails >= 1.2

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Run the test suite: bundle exec rake
4. Open a pull request

Bug reports and feature requests are welcome on GitHub Issues.

The gem is available as open source under the terms of the MIT License.