rails_orbit 0.1.0

data/app/helpers/rails_orbit/dashboard_helper.rb

@@ -0,0 +1,44 @@
+module RailsOrbit
+  module DashboardHelper
+    def range_options
+      TimeRange::OPTIONS
+    end
+
+    def range_label
+      @time_range.label
+    end
+
+    def severity_class(count, thresholds: { success: 0, warning: 10 })
+      if count <= thresholds[:success]
+        "success"
+      elsif count < thresholds[:warning]
+        "warning"
+      else
+        "danger"
+      end
+    end
+
+    def cache_severity(hit_rate)
+      if hit_rate >= 80
+        "success"
+      elsif hit_rate >= 50
+        "warning"
+      else
+        "danger"
+      end
+    end
+
+    def delta_title(range_key)
+      window = TimeRange::OPTIONS.dig(range_key, :delta_window)
+      return "vs previous period" unless window
+      label = case window
+              when 15.minutes  then "15 min"
+              when 1.hour      then "hour"
+              when 6.hours     then "6 hours"
+              when 1.day       then "day"
+              else "period"
+              end
+      "vs previous #{label}"
+    end
+  end
+end

data/app/helpers/rails_orbit/icon_helper.rb

@@ -0,0 +1,19 @@
+module RailsOrbit
+  module IconHelper
+    ICONS = {
+      overview:  '<svg class="orbit-nav__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/></svg>',
+      jobs:      '<svg class="%{css_class}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="3" width="20" height="14" rx="2"/><path d="M8 21h8"/><path d="M12 17v4"/></svg>',
+      cache:     '<svg class="%{css_class}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14a9 3 0 0 0 18 0V5"/><path d="M3 12a9 3 0 0 0 18 0"/></svg>',
+      errors:    '<svg class="%{css_class}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>',
+      orbit:     '<svg class="orbit-nav__logo" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="3"/><circle cx="12" cy="12" r="8" stroke-dasharray="4 3"/></svg>',
+      delta_up:  '<svg class="orbit-delta__icon" viewBox="0 0 12 12" fill="currentColor"><path d="M6 2L10 7H2z"/></svg>',
+      delta_down:'<svg class="orbit-delta__icon" viewBox="0 0 12 12" fill="currentColor"><path d="M6 10L2 5h8z"/></svg>',
+    }.freeze
+
+    def orbit_icon(name, css_class: "orbit-icon")
+      template = ICONS[name.to_sym]
+      return "" unless template
+      (template % { css_class: css_class }).html_safe
+    end
+  end
+end

data/app/jobs/rails_orbit/application_job.rb

@@ -0,0 +1,4 @@
+module RailsOrbit
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/jobs/rails_orbit/retention_job.rb

@@ -0,0 +1,22 @@
+module RailsOrbit
+  class RetentionJob < ApplicationJob
+    queue_as :default
+
+    BATCH_SIZE = 1_000
+
+    def perform
+      days  = RailsOrbit.configuration.retention_days
+      total = 0
+
+      loop do
+        ids = Metric.older_than(days).limit(BATCH_SIZE).pluck(:id)
+        break if ids.empty?
+        deleted = Metric.where(id: ids).delete_all
+        total += deleted
+        break if ids.size < BATCH_SIZE
+      end
+
+      Rails.logger.info "[rails_orbit] RetentionJob: purged #{total} metrics older than #{days} days."
+    end
+  end
+end

data/app/models/rails_orbit/application_record.rb

@@ -0,0 +1,6 @@
+module RailsOrbit
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+    self.table_name_prefix = "rails_orbit_"
+  end
+end

data/app/models/rails_orbit/metric.rb

@@ -0,0 +1,97 @@
+module RailsOrbit
+  class Metric < ApplicationRecord
+    validates :key,         presence: true
+    validates :value,       presence: true, numericality: true
+    validates :recorded_at, presence: true
+
+    scope :recent,      ->(days = 1)  { where(recorded_at: days.days.ago..) }
+    scope :since,       ->(time)      { where(recorded_at: time..) }
+    scope :for_key,     ->(k)         { where(key: k) }
+    scope :older_than,  ->(days)      { where(recorded_at: ..days.days.ago) }
+
+    def self.record(key:, value:, dimension: nil, at: Time.current)
+      create!(key: key, value: value, dimension: dimension, recorded_at: at)
+    end
+
+    def self.hit_rate(hits, misses)
+      total = hits.to_f + misses.to_f
+      total.zero? ? 0.0 : ((hits / total) * 100).round(1)
+    end
+
+    def self.sums_since(time)
+      since(time).group(:key).sum(:value)
+    end
+
+    def self.compute_delta(key, window:)
+      now      = Time.current
+      current  = where(recorded_at: (now - window)..now).for_key(key).sum(:value).to_i
+      previous = where(recorded_at: (now - window * 2)..(now - window)).for_key(key).sum(:value).to_i
+      return { value: 0, direction: :flat } if previous.zero? && current.zero?
+      return { value: 100, direction: :up } if previous.zero?
+
+      pct = (((current - previous).to_f / previous) * 100).round(0)
+      direction = pct.positive? ? :up : (pct.negative? ? :down : :flat)
+      { value: pct.abs, direction: direction }
+    end
+
+    def self.compute_hit_rate_delta(window:)
+      now = Time.current
+      cur_hits   = where(recorded_at: (now - window)..now).for_key("solid_cache.read_hit").sum(:value).to_f
+      cur_misses = where(recorded_at: (now - window)..now).for_key("solid_cache.read_miss").sum(:value).to_f
+      prev_hits   = where(recorded_at: (now - window * 2)..(now - window)).for_key("solid_cache.read_hit").sum(:value).to_f
+      prev_misses = where(recorded_at: (now - window * 2)..(now - window)).for_key("solid_cache.read_miss").sum(:value).to_f
+
+      cur_rate  = hit_rate(cur_hits, cur_misses)
+      prev_rate = hit_rate(prev_hits, prev_misses)
+      diff = (cur_rate - prev_rate).round(1)
+      direction = diff.positive? ? :up : (diff.negative? ? :down : :flat)
+      { value: diff.abs, direction: direction }
+    end
+
+    def self.bucketed_series(key, since:, bucket_minutes:, aggregate: :sum)
+      conn    = connection
+      seconds = bucket_minutes * 60
+      agg_fn  = aggregate == :avg ? "AVG" : "SUM"
+      bucket  = bucket_expression(seconds)
+
+      sql = "SELECT #{bucket} AS bucket, #{agg_fn}(value) AS val " \
+            "FROM #{conn.quote_table_name(table_name)} " \
+            "WHERE key = #{conn.quote(key)} AND recorded_at >= #{conn.quote(since.utc.strftime('%Y-%m-%d %H:%M:%S'))} " \
+            "GROUP BY bucket ORDER BY bucket"
+
+      conn.select_all(sql).rows.map { |row| { t: row[0].to_s, v: row[1].to_f.round(1) } }
+    end
+
+    def self.bucketed_hit_rate_series(since:, bucket_minutes:)
+      conn    = connection
+      seconds = bucket_minutes * 60
+      bucket  = bucket_expression(seconds)
+      q_since = conn.quote(since.utc.strftime("%Y-%m-%d %H:%M:%S"))
+      q_hit   = conn.quote("solid_cache.read_hit")
+      q_miss  = conn.quote("solid_cache.read_miss")
+
+      sql = "SELECT #{bucket} AS bucket, " \
+            "SUM(CASE WHEN key = #{q_hit} THEN value ELSE 0 END) AS hits, " \
+            "SUM(CASE WHEN key = #{q_miss} THEN value ELSE 0 END) AS misses " \
+            "FROM #{conn.quote_table_name(table_name)} " \
+            "WHERE key IN (#{q_hit}, #{q_miss}) AND recorded_at >= #{q_since} " \
+            "GROUP BY bucket ORDER BY bucket"
+
+      conn.select_all(sql).rows.map do |row|
+        { t: row[0].to_s, v: hit_rate(row[1].to_f, row[2].to_f) }
+      end
+    end
+
+    def self.bucket_expression(seconds)
+      adapter = connection.adapter_name.downcase
+      if adapter.include?("sqlite")
+        "datetime((strftime('%s', recorded_at) / #{seconds}) * #{seconds}, 'unixepoch')"
+      elsif adapter.include?("postgres")
+        "to_timestamp(floor(extract(epoch from recorded_at) / #{seconds}) * #{seconds})"
+      else
+        "FROM_UNIXTIME(FLOOR(UNIX_TIMESTAMP(recorded_at) / #{seconds}) * #{seconds})"
+      end
+    end
+    private_class_method :bucket_expression
+  end
+end

data/app/views/layouts/rails_orbit/application.html.erb

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title><%= RailsOrbit.configuration.dashboard_title %></title>
+    <%= stylesheet_link_tag "/assets/rails_orbit/application.css", media: "all" %>
+    <%= javascript_include_tag "/assets/rails_orbit/application.js", defer: true %>
+    <%= csrf_meta_tags %>
+  </head>
+  <body class="orbit-body">
+    <%= render "rails_orbit/shared/nav" %>
+    <main class="orbit-main">
+      <% if flash[:warning] %>
+        <div class="orbit-flash orbit-flash--warning"><%= flash[:warning] %></div>
+      <% end %>
+      <%= yield %>
+    </main>
+  </body>
+</html>

data/app/views/rails_orbit/dashboard/_overview_card.html.erb

@@ -0,0 +1,17 @@
+<div class="orbit-card orbit-card--bordered orbit-card--border-<%= border %>">
+  <div class="orbit-card__header">
+    <div class="orbit-card__label">
+      <%= orbit_icon(icon) %>
+      <%= label %>
+    </div>
+    <%= render "rails_orbit/shared/delta", delta: delta %>
+  </div>
+  <div class="orbit-card__value <%= defined?(value_class) ? value_class : '' %>" id="<%= target_id %>">
+    <%= render partial: partial, locals: locals %>
+  </div>
+  <div class="orbit-card__footer">
+    <% footer_items.each do |item| %>
+      <span class="orbit-card__detail"><%= item %></span>
+    <% end %>
+  </div>
+</div>

data/app/views/rails_orbit/dashboard/cache.html.erb

@@ -0,0 +1,58 @@
+<div class="orbit-page">
+  <div class="orbit-page-header">
+    <h1 class="orbit-page__title">Cache</h1>
+    <%= render "rails_orbit/shared/range_picker" %>
+  </div>
+
+  <div class="orbit-grid orbit-grid--3">
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Total Reads (<%= range_label %>)</div>
+      <div class="orbit-card__value"><%= @reads %></div>
+      <div class="orbit-card__footer">
+        <span class="orbit-card__detail orbit-card__detail--success"><%= @hits %> hits</span>
+        <span class="orbit-card__detail orbit-card__detail--danger"><%= @misses %> misses</span>
+      </div>
+    </div>
+
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Hit Rate (<%= range_label %>)</div>
+      <div class="orbit-card__value"><%= @hit_rate %><span class="orbit-card__unit">%</span></div>
+      <div class="orbit-hit-bar" title="<%= @hit_rate %>% hit rate">
+        <div class="orbit-hit-bar__fill" style="width: <%= @hit_rate %>%"></div>
+      </div>
+    </div>
+
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Writes (<%= range_label %>)</div>
+      <div class="orbit-card__value"><%= @writes %></div>
+    </div>
+  </div>
+
+  <div class="orbit-grid orbit-grid--3">
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Deletes (<%= range_label %>)</div>
+      <div class="orbit-card__value"><%= @deletes %></div>
+    </div>
+
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Fetch Hits (<%= range_label %>)</div>
+      <div class="orbit-card__value"><%= @fetch_hit %></div>
+      <div class="orbit-card__footer">
+        <span class="orbit-card__detail">Block-level cache hits</span>
+      </div>
+    </div>
+
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Miss Rate</div>
+      <div class="orbit-card__value <%= 'orbit-card__value--warning' if @reads > 0 && (100 - @hit_rate) > 30 %>"><%= @reads.zero? ? 0 : (100 - @hit_rate).round(1) %><span class="orbit-card__unit">%</span></div>
+    </div>
+  </div>
+
+  <% if @reads.zero? && @writes.zero? %>
+    <div class="orbit-empty">
+      <svg class="orbit-empty__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14a9 3 0 0 0 18 0V5"/><path d="M3 12a9 3 0 0 0 18 0"/></svg>
+      <p>No cache activity in the selected time range.</p>
+      <p class="orbit-empty__hint">Cache events will appear here once solid_cache processes read/write operations.</p>
+    </div>
+  <% end %>
+</div>

data/app/views/rails_orbit/dashboard/errors.html.erb

@@ -0,0 +1,54 @@
+<div class="orbit-page">
+  <div class="orbit-page-header">
+    <h1 class="orbit-page__title">Errors</h1>
+    <%= render "rails_orbit/shared/range_picker" %>
+  </div>
+
+  <% if @grouped_errors.any? %>
+    <% @grouped_errors.each do |group| %>
+      <div class="orbit-error-group">
+        <div class="orbit-error-group__header">
+          <div class="orbit-error-group__title">
+            <span class="orbit-error-group__class"><%= group[:exception_class] %></span>
+            <span class="orbit-error-group__badge"><%= group[:count] %>x</span>
+            <% if group[:resolved] %>
+              <span class="orbit-error-group__resolved">resolved</span>
+            <% end %>
+          </div>
+          <div class="orbit-error-group__meta">
+            Last seen <%= time_ago_in_words(group[:last_seen]) %> ago
+          </div>
+        </div>
+
+        <div class="orbit-table-wrap">
+          <table class="orbit-table orbit-table--compact">
+            <thead>
+              <tr>
+                <th>Message</th>
+                <th class="orbit-table__right">Occurred At</th>
+              </tr>
+            </thead>
+            <tbody>
+              <% group[:records].each do |error| %>
+                <tr>
+                  <td><%= truncate(error.message, length: 140) %></td>
+                  <td class="orbit-table__right orbit-table__mono"><%= error.created_at.strftime("%b %d %H:%M:%S") %></td>
+                </tr>
+              <% end %>
+            </tbody>
+          </table>
+        </div>
+      </div>
+    <% end %>
+  <% else %>
+    <div class="orbit-empty">
+      <svg class="orbit-empty__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z"/><path d="M8 15s1.5 2 4 2 4-2 4-2"/><line x1="9" y1="9" x2="9.01" y2="9"/><line x1="15" y1="9" x2="15.01" y2="9"/></svg>
+      <% if flash[:warning] %>
+        <p><%= flash[:warning] %></p>
+      <% else %>
+        <p>No errors recorded in the selected time range.</p>
+        <p class="orbit-empty__hint">Exceptions will appear here once solid_errors captures them.</p>
+      <% end %>
+    </div>
+  <% end %>
+</div>

data/app/views/rails_orbit/dashboard/jobs.html.erb

@@ -0,0 +1,64 @@
+<div class="orbit-page">
+  <div class="orbit-page-header">
+    <h1 class="orbit-page__title">Jobs</h1>
+    <%= render "rails_orbit/shared/range_picker" %>
+  </div>
+
+  <div class="orbit-grid orbit-grid--4">
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Enqueued (<%= range_label %>)</div>
+      <div class="orbit-card__value"><%= @total_enqueued %></div>
+    </div>
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Avg Duration</div>
+      <div class="orbit-card__value"><%= @avg_duration %><span class="orbit-card__unit">ms</span></div>
+    </div>
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Failed</div>
+      <div class="orbit-card__value <%= 'orbit-card__value--danger' unless @total_failed.zero? %>"><%= @total_failed %></div>
+    </div>
+    <div class="orbit-card orbit-card--compact">
+      <div class="orbit-card__label">Discarded</div>
+      <div class="orbit-card__value <%= 'orbit-card__value--warning' unless @total_discarded.zero? %>"><%= @total_discarded %></div>
+    </div>
+  </div>
+
+  <% if @by_queue.any? %>
+    <div class="orbit-table-wrap">
+      <table class="orbit-table">
+        <thead>
+          <tr>
+            <th>Queue</th>
+            <th class="orbit-table__right">Enqueued</th>
+            <th class="orbit-table__right">Avg Duration</th>
+            <th class="orbit-table__right">Failed</th>
+            <th class="orbit-table__right">Retried</th>
+            <th class="orbit-table__right">Discarded</th>
+          </tr>
+        </thead>
+        <tbody>
+          <%
+            queues = @by_queue.keys.map(&:first).uniq.compact
+            queues.each do |queue|
+              failed_count = @by_queue[[queue, "solid_queue.failed"]]&.to_i || 0
+          %>
+            <tr class="<%= 'orbit-table__row--danger' if failed_count > 0 %>">
+              <td class="orbit-table__queue"><%= queue || "default" %></td>
+              <td class="orbit-table__right orbit-table__mono"><%= @by_queue[[queue, "solid_queue.enqueued"]]&.to_i || 0 %></td>
+              <td class="orbit-table__right orbit-table__mono"><%= @by_queue[[queue, "solid_queue.performed_ms"]]&.round(1) || 0 %><span class="orbit-table__unit">ms</span></td>
+              <td class="orbit-table__right orbit-table__mono <%= 'orbit-table__danger' if failed_count > 0 %>"><%= failed_count %></td>
+              <td class="orbit-table__right orbit-table__mono"><%= @by_queue[[queue, "solid_queue.retried"]]&.to_i || 0 %></td>
+              <td class="orbit-table__right orbit-table__mono"><%= @by_queue[[queue, "solid_queue.discarded"]]&.to_i || 0 %></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% else %>
+    <div class="orbit-empty">
+      <svg class="orbit-empty__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="2" y="3" width="20" height="14" rx="2"/><path d="M8 21h8"/><path d="M12 17v4"/><path d="M7 10h0"/><path d="M12 10h0"/><path d="M17 10h0"/></svg>
+      <p>No job metrics recorded in the selected time range.</p>
+      <p class="orbit-empty__hint">Jobs will appear here once solid_queue starts processing work.</p>
+    </div>
+  <% end %>
+</div>

data/app/views/rails_orbit/dashboard/overview.html.erb

@@ -0,0 +1,67 @@
+<div class="orbit-page" data-controller="orbit-poll" data-orbit-poll-url-value="<%= rails_orbit.stream_path %>" data-orbit-poll-interval-value="<%= RailsOrbit.configuration.poll_interval * 1000 %>">
+  <div class="orbit-page-header">
+    <h1 class="orbit-page__title">Overview</h1>
+    <div class="orbit-page-header__right">
+      <%= render "rails_orbit/shared/range_picker" %>
+      <div class="orbit-updated" id="orbit-last-updated" data-time="<%= Time.current.iso8601 %>">
+        Updated just now
+      </div>
+    </div>
+  </div>
+
+  <div class="orbit-grid orbit-grid--3">
+    <%= render "rails_orbit/dashboard/overview_card",
+      border: "primary",
+      icon: :jobs,
+      label: "Jobs (#{range_label})",
+      delta: @enqueued_delta,
+      target_id: "orbit-queue-stats",
+      partial: "rails_orbit/stream/queue_stats",
+      locals: { data: { enqueued: @enqueued_count, failed: @failed_jobs_count, retried: @retried_count, avg_ms: @avg_duration } },
+      footer_items: ["#{@discarded_count} discarded", "#{@avg_duration}ms avg"] %>
+
+    <%= render "rails_orbit/dashboard/overview_card",
+      border: cache_severity(@cache_hit_rate),
+      icon: :cache,
+      label: "Cache (#{range_label})",
+      delta: @cache_delta,
+      target_id: "orbit-cache-stats",
+      partial: "rails_orbit/stream/cache_stats",
+      locals: { data: { hit_rate: @cache_hit_rate, hits: @cache_hits, misses: @cache_misses, writes: @cache_writes } },
+      footer_items: ["#{@cache_hits} hits", "#{@cache_misses} misses", "#{@cache_writes} writes"] %>
+
+    <%= render "rails_orbit/dashboard/overview_card",
+      border: severity_class(@error_count),
+      icon: :errors,
+      label: "Errors (#{range_label})",
+      delta: @error_delta,
+      target_id: "orbit-error-count",
+      partial: "rails_orbit/stream/error_count",
+      locals: { count: @error_count },
+      value_class: (@error_count.zero? ? "" : "orbit-card__value--danger"),
+      footer_items: ["#{@failed_jobs_count} failed jobs", "#{@retried_count} retried"] %>
+  </div>
+
+  <div class="orbit-grid orbit-grid--1">
+    <% if @job_chart.any? %>
+      <div class="orbit-card orbit-card--wide">
+        <div class="orbit-card__label">Job Duration (avg ms)</div>
+        <div class="orbit-chart-interactive" data-chart='<%= @job_chart.to_json %>' data-unit="ms" data-color="var(--orbit-primary)" data-gradient-id="orbit-grad-jobs"></div>
+      </div>
+    <% end %>
+
+    <% if @cache_chart.any? %>
+      <div class="orbit-card orbit-card--wide">
+        <div class="orbit-card__label">Cache Hit Rate (%)</div>
+        <div class="orbit-chart-interactive" data-chart='<%= @cache_chart.to_json %>' data-unit="%" data-color="var(--orbit-success)" data-gradient-id="orbit-grad-cache"></div>
+      </div>
+    <% end %>
+
+    <% if @error_chart.any? %>
+      <div class="orbit-card orbit-card--wide">
+        <div class="orbit-card__label">Errors</div>
+        <div class="orbit-chart-interactive" data-chart='<%= @error_chart.to_json %>' data-unit="" data-color="var(--orbit-danger)" data-gradient-id="orbit-grad-errors"></div>
+      </div>
+    <% end %>
+  </div>
+</div>

data/app/views/rails_orbit/shared/_delta.html.erb

@@ -0,0 +1,14 @@
+<% title = defined?(@range_key) ? delta_title(@range_key) : "vs previous period" %>
+<% if delta[:direction] == :up %>
+  <span class="orbit-delta orbit-delta--up" title="<%= title %>">
+    <%= orbit_icon(:delta_up) %>
+    <%= delta[:value] %>%
+  </span>
+<% elsif delta[:direction] == :down %>
+  <span class="orbit-delta orbit-delta--down" title="<%= title %>">
+    <%= orbit_icon(:delta_down) %>
+    <%= delta[:value] %>%
+  </span>
+<% else %>
+  <span class="orbit-delta orbit-delta--flat" title="<%= title %>">--</span>
+<% end %>

data/app/views/rails_orbit/shared/_nav.html.erb

@@ -0,0 +1,26 @@
+<nav class="orbit-nav">
+  <div class="orbit-nav__inner">
+    <div class="orbit-nav__brand">
+      <%= orbit_icon(:orbit) %>
+      <span class="orbit-nav__title"><%= RailsOrbit.configuration.dashboard_title %></span>
+    </div>
+    <div class="orbit-nav__links">
+      <%= link_to rails_orbit.root_path, class: "orbit-nav__link #{'orbit-nav__link--active' if current_page?(rails_orbit.root_path)}" do %>
+        <%= orbit_icon(:overview, css_class: "orbit-nav__icon") %>
+        Overview
+      <% end %>
+      <%= link_to rails_orbit.jobs_path, class: "orbit-nav__link #{'orbit-nav__link--active' if current_page?(rails_orbit.jobs_path)}" do %>
+        <%= orbit_icon(:jobs, css_class: "orbit-nav__icon") %>
+        Jobs
+      <% end %>
+      <%= link_to rails_orbit.cache_path, class: "orbit-nav__link #{'orbit-nav__link--active' if current_page?(rails_orbit.cache_path)}" do %>
+        <%= orbit_icon(:cache, css_class: "orbit-nav__icon") %>
+        Cache
+      <% end %>
+      <%= link_to rails_orbit.errors_path, class: "orbit-nav__link #{'orbit-nav__link--active' if current_page?(rails_orbit.errors_path)}" do %>
+        <%= orbit_icon(:errors, css_class: "orbit-nav__icon") %>
+        Errors
+      <% end %>
+    </div>
+  </div>
+</nav>

data/app/views/rails_orbit/shared/_range_picker.html.erb

@@ -0,0 +1,5 @@
+<div class="orbit-range-picker">
+  <% range_options.each do |key, cfg| %>
+    <%= link_to cfg[:label], url_for(range: key), class: "orbit-range-picker__btn #{'orbit-range-picker__btn--active' if @range_key == key}" %>
+  <% end %>
+</div>

data/app/views/rails_orbit/stream/_cache_stats.html.erb

@@ -0,0 +1,9 @@
+<div class="orbit-stat-group">
+  <span class="orbit-stat"><%= data[:hit_rate] %><span class="orbit-card__unit">%</span></span>
+  <span class="orbit-stat--label">hit rate</span>
+</div>
+<div class="orbit-stat-row">
+  <span class="orbit-stat-pill orbit-stat-pill--success"><%= data[:hits] %> hits</span>
+  <span class="orbit-stat-pill orbit-stat-pill--danger"><%= data[:misses] %> misses</span>
+  <span class="orbit-stat-pill"><%= data[:writes] %> writes</span>
+</div>

data/app/views/rails_orbit/stream/_error_count.html.erb

@@ -0,0 +1 @@
+<span class="orbit-stat <%= count.zero? ? 'orbit-stat--success' : (count < 10 ? 'orbit-stat--warning' : 'orbit-stat--danger') %>"><%= count %></span>

data/app/views/rails_orbit/stream/_queue_stats.html.erb

@@ -0,0 +1,8 @@
+<div class="orbit-stat-group">
+  <span class="orbit-stat"><%= data[:enqueued] %></span>
+  <span class="orbit-stat--label">enqueued</span>
+</div>
+<div class="orbit-stat-row">
+  <span class="orbit-stat-pill orbit-stat-pill--danger"><%= data[:failed] %> failed</span>
+  <span class="orbit-stat-pill"><%= data[:retried] %> retried</span>
+</div>

data/app/views/rails_orbit/stream/index.turbo_stream.erb

@@ -0,0 +1,11 @@
+<%= turbo_stream.update "orbit-queue-stats" do %>
+  <%= render "rails_orbit/stream/queue_stats", data: @queue_data %>
+<% end %>
+
+<%= turbo_stream.update "orbit-cache-stats" do %>
+  <%= render "rails_orbit/stream/cache_stats", data: @cache_data %>
+<% end %>
+
+<%= turbo_stream.update "orbit-error-count" do %>
+  <%= render "rails_orbit/stream/error_count", count: @error_count %>
+<% end %>

data/config/routes.rb

@@ -0,0 +1,9 @@
+RailsOrbit::Engine.routes.draw do
+  root to: "dashboard#overview"
+
+  get "jobs",   to: "dashboard#jobs",   as: :jobs
+  get "cache",  to: "dashboard#cache",  as: :cache
+  get "errors", to: "dashboard#errors", as: :errors
+
+  get "stream", to: "stream#index", as: :stream
+end

data/lib/generators/rails_orbit/install_generator.rb

@@ -0,0 +1,55 @@
+require "rails/generators"
+require "rails/generators/active_record"
+
+module RailsOrbit
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Installs rails_orbit: copies migrations, creates initializer, suggests route mount."
+
+      def create_initializer
+        template "initializer.rb", "config/initializers/rails_orbit.rb"
+      end
+
+      def copy_migrations
+        migration_template(
+          "create_orbit_metrics.rb.erb",
+          "db/migrate/create_rails_orbit_metrics.rb"
+        )
+      end
+
+      def mount_route
+        route 'mount RailsOrbit::Engine, at: "/orbit"'
+      end
+
+      def print_next_steps
+        say "\n"
+        say "rails_orbit installed!", :green
+        say ""
+        say "Next steps:"
+        say ""
+        say "  For :host_db or :external adapters:"
+        say "    bin/rails db:migrate"
+        say ""
+        say "  For :sqlite adapter (default):"
+        say "    The table is created automatically on first boot."
+        say "    Or run manually: bin/rails rails_orbit:setup"
+        say ""
+        say "  Then:"
+        say "    1. Edit config/initializers/rails_orbit.rb"
+        say "    2. Set ORBIT_USER and ORBIT_PASSWORD in your environment"
+        say "    3. Visit /orbit in your browser"
+        say ""
+        say "  Useful commands:"
+        say "    bin/rails rails_orbit:setup   — create the metrics table"
+        say "    bin/rails rails_orbit:status  — check config and table status"
+        say ""
+        say "If you are deploying to Heroku or another ephemeral platform:", :yellow
+        say "  Set config.storage_adapter = :host_db in the initializer.", :yellow
+      end
+    end
+  end
+end