solid_observer 0.1.1 → 0.3.0

data/app/views/solid_observer/dashboard/index.html.erb

@@ -0,0 +1,113 @@
+<% content_for :title, "Dashboard" %>
+
+<div class="so-dashboard">
+  <%# Zone A: Toolbar — range selector, Refresh, Live toggle, help disclosure %>
+  <div class="so-dashboard-toolbar" data-so-live>
+    <div class="so-dashboard-toolbar__left">
+      <label for="so-range" class="so-card__label so-filters__label">Range</label>
+      <select id="so-range" name="range" data-so-range-select>
+        <% SolidObserver::QueueStats::RANGES.each_key do |key| %>
+          <option value="<%= key %>" <%= "selected" if key == @range %>><%= key %></option>
+        <% end %>
+      </select>
+      <button type="button" class="so-btn so-btn--refresh" data-so-refresh aria-busy="false">Refresh data</button>
+      <span class="so-toolbar-freshness" data-so-freshness aria-live="polite"></span>
+    </div>
+    <div class="so-dashboard-toolbar__right">
+      <label class="so-toggle so-toggle--pill <%= "so-toggle--on" if @live %>">
+        <input type="checkbox" name="live" value="on" <%= "checked" if @live %> data-so-live-toggle>
+        <span class="so-toggle__track" aria-hidden="true">
+          <span class="so-toggle__thumb"></span>
+        </span>
+        <span class="so-toggle__label">Live</span>
+        <span class="so-toggle__sep" aria-hidden="true"> · </span>
+        <span class="so-toggle__cadence" aria-live="polite"><%= @live ? "5s" : "off" %></span>
+        <span class="so-toggle__dot" aria-hidden="true"></span>
+      </label>
+      <div class="so-help-wrapper" data-so-help-wrapper>
+        <button type="button" class="so-btn so-btn--help" data-so-help-btn aria-expanded="false" aria-controls="so-help-panel">(?)
+        </button>
+        <div id="so-help-panel" class="so-help-panel" data-so-help-panel hidden>
+          <p>Live mode polls every 5 seconds for current queue state. Throughput and chart data update only on range change or manual refresh.</p>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <%# Zone B: Right now — live state %>
+  <section class="so-dashboard-section" aria-labelledby="so-live-state-heading">
+    <div class="so-dashboard-section__header">
+      <h2 class="so-dashboard-section__title" id="so-live-state-heading">Right now</h2>
+      <span class="so-dashboard-section__meta"><span class="so-badge so-badge--pill so-badge--success"><svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true"><circle r="3" cx="3" cy="3" fill="var(--so-live-marker, var(--so-success))"/></svg></span> current</span>
+    </div>
+    <%= render "live_state", stats: @stats %>
+  </section>
+
+  <%# Zone C: Throughput in selected range %>
+  <% if persistence_mode? && @stats[:available] %>
+    <section class="so-dashboard-section" aria-labelledby="so-throughput-heading">
+      <div class="so-dashboard-section__header">
+        <h2 class="so-dashboard-section__title" id="so-throughput-heading">Throughput in selected range</h2>
+        <span class="so-dashboard-section__meta"><span class="so-badge so-badge--pill so-badge--info"><svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true"><circle r="3" cx="3" cy="3" fill="var(--so-range-marker, var(--so-info))"/></svg></span> <span data-so-range-copy><%= range_label(@range) %></span></span>
+      </div>
+      <%= render "throughput", stats: @stats, range: @range %>
+    </section>
+  <% end %>
+
+  <%# Zone D: Charts %>
+  <% if @stats[:available] %>
+    <section class="so-dashboard-section" aria-labelledby="so-chart-heading">
+      <div class="so-dashboard-section__header">
+        <h2 class="so-dashboard-section__title" id="so-chart-heading">Charts</h2>
+      </div>
+      <%= render "chart", range: @range %>
+    </section>
+  <% end %>
+
+  <%# Zone E: Per-queue table %>
+  <%= render "queue_table", stats: @stats, range: @range %>
+
+  <%# Zone F: Stability strip %>
+  <% if @stats[:available] && persistence_mode? %>
+    <section class="so-stability" data-so-zone="stability" aria-labelledby="so-stability-heading">
+      <span class="so-stability__label" id="so-stability-heading">Stability</span>
+      <%= stability_badge(@stats) %>
+      <span class="so-stability__detail"><%= stability_detail(@stats) %></span>
+      <%= link_to "View failures →", events_path(event_type: "job_failed"), class: "so-stability__link" %>
+    </section>
+  <% end %>
+
+  <%# Zone G: Recent Events %>
+  <% if @stats[:available] && persistence_mode? %>
+    <% if defined?(@recent_events) && @recent_events.present? %>
+      <div class="so-card">
+        <div class="so-card__label">Recent Events</div>
+        <table class="so-table so-table--card">
+          <thead>
+            <tr>
+              <th>Event</th>
+              <th>Job Class</th>
+              <th>Queue</th>
+              <th>Time</th>
+            </tr>
+          </thead>
+          <tbody>
+            <% @recent_events.each do |event| %>
+              <tr>
+                <td><%= event.event_type.humanize %></td>
+                <td><%= event.job_class %></td>
+                <td><%= event.queue_name %></td>
+                <td><%= time_ago_in_words(event.recorded_at) %> ago</td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    <% else %>
+      <div class="so-card">
+        <div class="so-card__label">Recent Events</div>
+        <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">No recent events yet. Queue activity will appear here after jobs are enqueued, performed, or failed.</p>
+      </div>
+    <% end %>
+  <% end %>
+</div>

data/app/views/solid_observer/errors/storage_unavailable.html.erb

@@ -0,0 +1,27 @@
+<% content_for :title, "Storage Unavailable" %>
+
+<div class="so-content__header">
+  <h1>SolidObserver storage is not reachable</h1>
+</div>
+
+<div class="so-card so-card--spaced so-card--accent-danger">
+  <p class="so-card__label so-card__label--danger">
+    <strong><%= @error_class %></strong>
+  </p>
+  <pre class="so-pre so-pre--error"><%= @error_message %></pre>
+</div>
+
+<div class="so-card so-card--spaced">
+  <h2>What to do next</h2>
+  <ol>
+    <li>Confirm the <code>solid_observer_queue</code> database in <code>config/database.yml</code> is reachable.</li>
+    <li>
+      Run migrations if you have not yet:
+      <pre class="so-pre">bin/rails solid_observer:install:migrations
+bin/rails db:create
+bin/rails db:migrate</pre>
+    </li>
+    <li>If the database server is temporarily down, reload this page once it recovers.</li>
+    <li>Switch to <code>storage_mode: :realtime</code> in <code>config/initializers/solid_observer.rb</code> if you want SolidObserver without a persistence database.</li>
+  </ol>
+</div>

data/app/views/solid_observer/events/index.html.erb

@@ -0,0 +1,53 @@
+<% content_for :title, "Events" %>
+
+<div class="so-content__header">
+  <h1>Events</h1>
+</div>
+
+<%= form_tag events_path, method: :get, class: "so-filters" do %>
+  <%= select_tag :event_type,
+      options_for_select([["All Event Types", ""]] + @available_event_types.map { |t| [t.humanize, t] }, @event_type),
+      onchange: "this.form.submit()" %>
+
+  <%= select_tag :job_class,
+      options_for_select([["All Classes", ""]] + @available_job_classes.map { |c| [c, c] }, @job_class),
+      onchange: "this.form.submit()" %>
+
+  <%= select_tag :queue_name,
+      options_for_select([["All Queues", ""]] + @available_queues.map { |q| [q, q] }, @queue_name),
+      onchange: "this.form.submit()" %>
+
+  <%= date_field_tag :from, @from&.strftime("%Y-%m-%d"), placeholder: "From date", onchange: "this.form.submit()" %>
+  <%= date_field_tag :to, @to&.strftime("%Y-%m-%d"), placeholder: "To date", onchange: "this.form.submit()" %>
+
+  <%= link_to "Clear Filters", events_path, class: "so-btn" if @event_type.present? || @job_class.present? || @queue_name.present? || @from || @to %>
+<% end %>
+
+<% if @events.any? %>
+  <table class="so-table so-table--listing">
+    <thead>
+      <tr>
+        <th>Event</th>
+        <th>Job Class</th>
+        <th>Queue</th>
+        <th>Duration</th>
+        <th>Time</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @events.each do |event| %>
+        <tr>
+          <td><%= link_to event.event_type.humanize, event_path(event.id) %></td>
+          <td><%= event.job_class %></td>
+          <td><%= event.queue_name %></td>
+          <td><%= duration_with_semantic(event.duration, event.event_type) %></td>
+          <td><%= time_ago_in_words(event.recorded_at) %> ago</td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+
+  <%= render "solid_observer/shared/pagination", page: @page, total_pages: @total_pages %>
+<% else %>
+  <%= render "solid_observer/shared/empty_state", message: "No events found matching the criteria" %>
+<% end %>

data/app/views/solid_observer/events/show.html.erb

@@ -0,0 +1,47 @@
+<% content_for :title, "Event ##{@event.id}" %>
+
+<div class="so-content__header">
+  <h1>Event #<%= @event.id %></h1>
+</div>
+
+<div class="so-back-link">
+  <%= link_to "← Back to Events", events_path(event_type: params[:event_type], job_class: params[:job_class], queue_name: params[:queue_name], from: params[:from], to: params[:to]), class: "so-btn" %>
+</div>
+
+<div class="so-card so-card--spaced">
+  <table class="so-table so-details">
+    <tbody>
+      <tr>
+        <td>Event Type</td>
+        <td><%= @event.event_type.humanize %></td>
+      </tr>
+      <tr>
+        <td>Job Class</td>
+        <td><code><%= @event.job_class %></code></td>
+      </tr>
+      <tr>
+        <td>Queue</td>
+        <td><%= @event.queue_name %></td>
+      </tr>
+      <tr>
+        <td>Correlation ID</td>
+        <td><code><%= @event.correlation_id || "N/A" %></code></td>
+      </tr>
+      <tr>
+        <td>Duration</td>
+        <td><%= duration_with_semantic(@event.duration, @event.event_type) %></td>
+      </tr>
+      <tr>
+        <td>Recorded At</td>
+        <td><%= @event.recorded_at.strftime("%Y-%m-%d %H:%M:%S.%3N UTC") %></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+
+<% if @metadata %>
+  <div class="so-card so-card--spaced">
+    <div class="so-card__label">Metadata</div>
+    <pre class="so-pre"><code><%= JSON.pretty_generate(@metadata) %></code></pre>
+  </div>
+<% end %>

data/app/views/solid_observer/jobs/index.html.erb

@@ -0,0 +1,61 @@
+<% content_for :title, "Jobs" %>
+
+<div class="so-content__header">
+  <h1>Jobs</h1>
+</div>
+
+<%= form_tag jobs_path, method: :get, class: "so-filters" do %>
+  <%= select_tag :status,
+      options_for_select([["All Active", "all_active"], ["Ready", "ready"], ["Scheduled", "scheduled"], ["Claimed", "claimed"], ["Failed", "failed"]], @status),
+      onchange: "this.form.submit()" %>
+
+  <%= select_tag :queue_name,
+      options_for_select([["All Queues", ""]] + @available_queues.map { |q| [q, q] }, @queue_name),
+      onchange: "this.form.submit()" %>
+
+  <%= select_tag :job_class,
+      options_for_select([["All Classes", ""]] + @available_job_classes.map { |c| [c, c] }, @job_class),
+      onchange: "this.form.submit()" %>
+<% end %>
+
+<% if @jobs.any? %>
+  <table class="so-table so-table--listing">
+    <thead>
+      <tr>
+        <th>ID</th>
+        <th>Class</th>
+        <th>Queue</th>
+        <th>Status</th>
+        <th>Created</th>
+        <th>Actions</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @jobs.each do |execution| %>
+        <% job = execution.job %>
+        <% status = execution_status(execution) %>
+        <tr>
+          <td><%= link_to execution.id, job_path(execution.id, status: status) %></td>
+          <td><%= job&.class_name || "N/A" %></td>
+          <td><%= job&.queue_name || execution&.queue_name || "N/A" %></td>
+          <td><%= status_badge(status) %></td>
+          <td><%= time_ago_in_words(execution.created_at) %> ago</td>
+          <td>
+            <%= link_to "View", job_path(execution.id, status: status), class: "so-btn" %>
+            <% if execution.is_a?(SolidQueue::FailedExecution) %>
+              <%= button_to "Retry", retry_job_path(execution.id), method: :post, class: "so-btn so-btn--primary", form: { class: "so-form--inline" }, data: { confirm: "Retry job #{execution.id}?" } %>
+              <%= button_to "Discard", discard_job_path(execution.id), method: :post, class: "so-btn so-btn--danger", form: { class: "so-form--inline" }, data: { confirm: "Discard job #{execution.id}? This cannot be undone." } %>
+            <% end %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+
+  <%= render "solid_observer/shared/pagination", page: @page, total_pages: @total_pages %>
+<% else %>
+  <%= render "solid_observer/shared/empty_state",
+      message: persistence_mode? ?
+        "No jobs match this filter. Successfully completed jobs are not stored here — see #{link_to("Events tab", events_path)} for the full job history.".html_safe :
+        "No jobs match this filter." %>
+<% end %>

data/app/views/solid_observer/jobs/show.html.erb

@@ -0,0 +1,71 @@
+<% content_for :title, "Job ##{@execution.id}" %>
+
+<div class="so-content__header">
+  <h1>Job #<%= @execution.id %></h1>
+</div>
+
+<div class="so-back-link">
+  <%= link_to "← Back to Jobs", jobs_path(status: @status), class: "so-btn" %>
+</div>
+
+<div class="so-card so-card--spaced">
+  <table class="so-table so-details">
+    <tbody>
+      <tr>
+        <td>Job Class</td>
+        <td><code><%= @job&.class_name || "N/A" %></code></td>
+      </tr>
+      <tr>
+        <td>Job ID</td>
+        <td><%= @job&.id || "N/A" %></td>
+      </tr>
+      <tr>
+        <td>Status</td>
+        <td><%= status_badge(@status) %></td>
+      </tr>
+      <tr>
+        <td>Queue</td>
+        <td><%= @presenter.queue_name || "N/A" %></td>
+      </tr>
+      <tr>
+        <td>Priority</td>
+        <td><%= @presenter.priority || "N/A" %></td>
+      </tr>
+      <tr>
+        <td>Created At</td>
+        <td><%= @execution.created_at.strftime("%Y-%m-%d %H:%M:%S UTC") %></td>
+      </tr>
+      <% if @execution.respond_to?(:scheduled_at) && @execution.scheduled_at %>
+        <tr>
+          <td>Scheduled At</td>
+          <td><%= @execution.scheduled_at.strftime("%Y-%m-%d %H:%M:%S UTC") %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>
+
+<% if @execution.is_a?(SolidQueue::FailedExecution) && @execution.error %>
+  <div class="so-card so-card--accent-danger">
+    <div class="so-card__label so-card__label--danger">Error Details</div>
+    <table class="so-table so-details so-table--card">
+      <tbody>
+        <tr>
+          <td>Error Class</td>
+          <td><code><%= @execution.error.exception_class %></code></td>
+        </tr>
+        <tr>
+          <td>Message</td>
+          <td><%= @execution.error.message %></td>
+        </tr>
+      </tbody>
+    </table>
+    <div class="so-card__label">Backtrace</div>
+    <pre class="so-pre so-pre--error"><code><%= @execution.error.backtrace&.first(20)&.join("\n") || "No backtrace available" %></code></pre>
+  </div>
+
+  <div class="so-actions">
+    <%= button_to "Retry Job", retry_job_path(@execution.id), method: :post, class: "so-btn so-btn--primary", data: { confirm: "Retry job #{@execution.id}?" } %>
+    <%= button_to "Discard Job", discard_job_path(@execution.id), method: :post, class: "so-btn so-btn--danger", data: { confirm: "Discard job #{@execution.id}? This cannot be undone." } %>
+  </div>
+<% end %>

data/app/views/solid_observer/shared/_empty_state.html.erb

@@ -0,0 +1,5 @@
+<% local_assigns[:message] ||= "No data available" %>
+<div class="so-empty">
+  <div class="so-empty__icon">📭</div>
+  <div class="so-empty__message"><%= message %></div>
+</div>

data/app/views/solid_observer/shared/_pagination.html.erb

@@ -0,0 +1,17 @@
+<% if total_pages > 1 %>
+  <div class="so-pagination">
+    <% if page > 1 %>
+      <%= link_to "Previous", url_for(request.query_parameters.merge(page: page - 1)), class: "so-btn" %>
+    <% else %>
+      <span class="so-btn so-btn--disabled" aria-disabled="true">Previous</span>
+    <% end %>
+
+    <span class="so-btn so-btn--static so-pagination__status">Page <%= page %> of <%= total_pages %></span>
+
+    <% if page < total_pages %>
+      <%= link_to "Next", url_for(request.query_parameters.merge(page: page + 1)), class: "so-btn" %>
+    <% else %>
+      <span class="so-btn so-btn--disabled" aria-disabled="true">Next</span>
+    <% end %>
+  </div>
+<% end %>

data/app/views/solid_observer/shared/_stat_card.html.erb

@@ -0,0 +1,9 @@
+<% subtitle = local_assigns[:subtitle] %>
+<% data_key = local_assigns[:data_key] %>
+<div class="so-card">
+  <div class="so-card__label"><%= label %></div>
+  <% if subtitle.present? %>
+    <div class="so-card__subtitle"><%= subtitle %></div>
+  <% end %>
+  <div class="so-card__value"<%= data_key ? " data-so-card-value=\"#{data_key}\"".html_safe : "".html_safe %>><%= value || 0 %></div>
+</div>

data/app/views/solid_observer/storages/show.html.erb

@@ -0,0 +1,39 @@
+<% content_for :title, "Storage" %>
+
+<div class="so-content__header">
+  <h1>Storage</h1>
+</div>
+
+<% if @current_storage %>
+  <div class="so-stat-cards">
+    <%= render "solid_observer/shared/stat_card", label: "Database Size", value: number_to_human_size(@current_storage.db_size_bytes, precision: 1, significant: false, strip_insignificant_zeros: false) %>
+    <%= render "solid_observer/shared/stat_card", label: "Event Count", value: number_with_delimiter(@current_storage.event_count) %>
+    <%= render "solid_observer/shared/stat_card", label: "Last Updated", value: time_ago_in_words(@current_storage.recorded_at) + " ago" %>
+  </div>
+
+  <% if @storage_history.any? %>
+    <div class="so-card so-card--section">
+      <div class="so-card__label">Recent Snapshots</div>
+      <table class="so-table so-table--card">
+        <thead>
+          <tr>
+            <th>Time</th>
+            <th>Size</th>
+            <th>Events</th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @storage_history.each do |snapshot| %>
+            <tr>
+              <td><%= snapshot.recorded_at.strftime("%Y-%m-%d %H:%M") %></td>
+              <td><%= number_to_human_size(snapshot.db_size_bytes, precision: 1, significant: false, strip_insignificant_zeros: false) %></td>
+              <td><%= number_with_delimiter(snapshot.event_count) %></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% end %>
+<% else %>
+  <%= render "solid_observer/shared/empty_state", message: "No storage information available" %>
+<% end %>

data/bin/quality_gate

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# SolidObserver Quality Gate Suite
+# Runs all non-negotiable gates in sequence.
+# Usage: bin/quality_gate [--skip-appraisal]
+#
+# Individual gates can be run via:
+#   bin/quality_gate rspec
+#   bin/quality_gate standardrb
+#   bin/quality_gate reek
+#   bin/quality_gate appraisal
+#   bin/quality_gate audit
+
+SKIP_APPRAISAL=false
+SINGLE_GATE=""
+
+for arg in "$@"; do
+  case "$arg" in
+    --skip-appraisal) SKIP_APPRAISAL=true ;;
+    rspec|standardrb|reek|appraisal|audit) SINGLE_GATE="$arg" ;;
+  esac
+done
+
+red()   { printf '\033[31m%s\033[0m\n' "$*" >&2; }
+green() { printf '\033[32m%s\033[0m\n' "$*"; }
+dim()   { printf '\033[2m%s\033[0m\n' "$*"; }
+
+run_gate() {
+  local label="$1"; shift
+  dim "⏳ ${label}..."
+  if "$@" > /dev/null 2>&1; then
+    green "✅ ${label}"
+    return 0
+  else
+    red "❌ ${label} FAILED — check output above"
+    return 1
+  fi
+}
+
+gate_rspec() {
+  run_gate "RSpec" bundle exec rspec
+}
+
+gate_standardrb() {
+  run_gate "StandardRB" bundle exec standardrb
+}
+
+gate_reek() {
+  run_gate "Reek" bundle exec reek lib/ app/ db/
+}
+
+gate_appraisal() {
+  run_gate "Rails 8.0 appraisal" bundle exec appraisal rails-8.0 rspec \
+    && run_gate "Rails 8.1 appraisal" bundle exec appraisal rails-8.1 rspec
+}
+
+gate_audit() {
+  dim "⏳ bundler-audit: updating advisory DB..."
+  bundle exec bundler-audit update > /dev/null 2>&1 || true
+  run_gate "bundler-audit" bundle exec bundler-audit check
+}
+
+run_all() {
+  local failed=0
+
+  gate_rspec      || failed=$((failed + 1))
+  gate_standardrb || failed=$((failed + 1))
+  gate_reek       || failed=$((failed + 1))
+
+  if [ "$SKIP_APPRAISAL" = false ]; then
+    gate_appraisal || failed=$((failed + 1))
+  else
+    dim "⏭️  Skipping appraisal (--skip-appraisal)"
+  fi
+
+  gate_audit      || failed=$((failed + 1))
+
+  echo ""
+  if [ "$failed" -eq 0 ]; then
+    green "All quality gates passed"
+  else
+    red "${failed} gate(s) failed"
+    return 1
+  fi
+}
+
+case "$SINGLE_GATE" in
+  rspec)      gate_rspec ;;
+  standardrb) gate_standardrb ;;
+  reek)       gate_reek ;;
+  appraisal)  gate_appraisal ;;
+  audit)      gate_audit ;;
+  "")         run_all ;;
+esac

data/config/routes.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+SolidObserver::Engine.routes.draw do
+  root "dashboard#index"
+  get "poll_data", to: "dashboard#poll_data", as: :poll_data
+  get "live_poll.js", to: "dashboard#live_poll", as: :live_poll_script
+
+  resources :jobs, only: %i[index show] do
+    member do
+      post :retry
+      post :discard
+    end
+  end
+
+  resource :storage, only: %i[show]
+  resources :events, only: %i[index show]
+end

data/db/migrate/20260424000001_add_composite_indexes_to_queue_events.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+class AddCompositeIndexesToQueueEvents < ActiveRecord::Migration[8.0]
+  disable_ddl_transaction!
+
+  def change
+    options = concurrent_supported? ? {algorithm: :concurrently} : {}
+
+    add_index :solid_observer_queue_events,
+      %i[job_class recorded_at],
+      order: {recorded_at: :desc},
+      if_not_exists: true,
+      **options
+
+    add_index :solid_observer_queue_events,
+      %i[queue_name recorded_at],
+      order: {recorded_at: :desc},
+      if_not_exists: true,
+      **options
+
+    remove_index :solid_observer_queue_events, :job_class, if_exists: true, **options
+    remove_index :solid_observer_queue_events, :queue_name, if_exists: true, **options
+  end
+
+  private
+
+  def concurrent_supported?
+    connection.adapter_name.match?(/postgres/i)
+  end
+end

data/lib/generators/solid_observer/install_generator.rb

@@ -24,6 +24,10 @@ module SolidObserver
         end
       end
 
+      def add_engine_mount
+        route 'mount SolidObserver::Engine, at: "/solid_observer"'
+      end
+
       def show_instructions
         say "\n"
         print_banner
@@ -34,38 +38,21 @@ module SolidObserver
         say "  3. Create database: bin/rails db:create"
         say "  4. Run migrations: bin/rails db:migrate"
         say "  5. Restart your Rails server"
+        say "  6. Visit /solid_observer to access the web dashboard"
         say "\n"
-        say "Documentation: https://solid.observer", :cyan
-        say "GitHub: https://github.com/bart-oz/solid_observer", :cyan
+        say "Documentation: https://solid.observer", :red
+        say "GitHub: https://github.com/bart-oz/solid_observer", :red
         say "\n"
       end
 
       private
 
       def print_banner
-        banner = <<~BANNER
-
-          ███████╗ ██████╗ ██╗     ██╗██████╗
-          ██╔════╝██╔═══██╗██║     ██║██╔══██╗
-          ███████╗██║   ██║██║     ██║██║  ██║
-          ╚════██║██║   ██║██║     ██║██║  ██║
-          ███████║╚██████╔╝███████╗██║██████╔╝
-          ╚══════╝ ╚═════╝ ╚══════╝╚═╝╚═════╝
-
-           ██████╗ ██████╗ ███████╗███████╗██████╗ ██╗   ██╗███████╗██████╗
-          ██╔═══██╗██╔══██╗██╔════╝██╔════╝██╔══██╗██║   ██║██╔════╝██╔══██╗
-          ██║   ██║██████╔╝███████╗█████╗  ██████╔╝██║   ██║█████╗  ██████╔╝
-          ██║   ██║██╔══██╗╚════██║██╔══╝  ██╔══██╗╚██╗ ██╔╝██╔══╝  ██╔══██╗
-          ╚██████╔╝██████╔╝███████║███████╗██║  ██║ ╚████╔╝ ███████╗██║  ██║
-           ╚═════╝ ╚═════╝ ╚══════╝╚══════╝╚═╝  ╚═╝  ╚═══╝  ╚══════╝╚═╝  ╚═╝
-
-                 Observe your Solid Stack like a pro! 🔭
-                                v#{SolidObserver::VERSION}
-
-        BANNER
-
-        banner.each_line { |line| say line.chomp, :cyan }
-        say "  ✓ SolidObserver installed successfully!", :green
+        say "         ┌─   ─┐", :red
+        say "            ◉     solid_observer", :red
+        say "         └─   ─┘", :red
+        say ""
+        say "   ✓ SolidObserver installed successfully!", :green
       end
     end
   end