rails_error_dashboard 0.2.2 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1cc76e092da14b5ec94ca8b6977837fdd10b87946d46249bfd8c5f5e300874a
-  data.tar.gz: 5dab8f740555c28018905a9b031df6bff749cddd470d131ba0a807dbe16710e2
+  metadata.gz: 68039a8977f567c9175c9a1493c8162ff9d05cef23abe3f2cba629e815608bb2
+  data.tar.gz: e448d91e7038288916b705c048f1e9f7e2debc654e4bf136c243190a6a9a2a0b
 SHA512:
-  metadata.gz: fee35c5ab9248ab74aed67f2171fec3cc1acb143f6bf84c3f2c017027d1b4825bb2b77b6d6d9e6d93422065c0257bd6b8c3e6fcca7c51fc1a79d68639159d8bd
-  data.tar.gz: 9407c784ed243265cf34970d1deac082e4d5748c1e9899984370735e48eb93e3519ce09ed597054d9f26564ee079222a65e518eb885e8b92e9c6d39fe6922f64
+  metadata.gz: '034283ec93474130ec2786c3c0de00fcba1d15e2b358b167e0856e95b2fc62398cd71f0cef767ab7a4ea538d60cf7fc9dbfb56c0951efa9bf19eded0ba5a2c9e'
+  data.tar.gz: 40496fc117f9695d0da1cbb0ef9b5d4a1ceea6dc13c2fdd73c8ff262e60424bc142646af7ff442d880858e8c2eb10d3fbb9cb00c7d064117a24733f774cfe062

data/README.md

@@ -1,6 +1,7 @@
 # Rails Error Dashboard
 
 [![Gem Version](https://badge.fury.io/rb/rails_error_dashboard.svg)](https://badge.fury.io/rb/rails_error_dashboard)
+[![Downloads](https://img.shields.io/gem/dt/rails_error_dashboard)](https://rubygems.org/gems/rails_error_dashboard)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Tests](https://github.com/AnjanJ/rails_error_dashboard/workflows/Tests/badge.svg)](https://github.com/AnjanJ/rails_error_dashboard/actions)
 
@@ -26,6 +27,20 @@ Username: `gandalf` · Password: `youshallnotpass`
 
 Experience the full dashboard with 480+ realistic Rails errors, LOTR-themed demo data, cause chains, enriched context, auto-reopened errors, and all features enabled.
 
+### Screenshots
+
+**Dashboard Overview** — Real-time error stats, severity breakdown, and trend charts at a glance.
+
+![Dashboard Overview](docs/images/dashboard-overview.png)
+
+**Error Detail** — Full stack trace, cause chain, enriched context, and workflow management.
+
+![Error Detail](docs/images/error-detail.png)
+
+**Analytics** — Error trends, platform health, correlation insights, and pattern detection.
+
+![Analytics](docs/images/analytics.png)
+
 ---
 
 ### ⚠️ BETA SOFTWARE

data/app/views/rails_error_dashboard/errors/show.html.erb

@@ -144,6 +144,8 @@
                   </h6>
                   <div class="cause-chain">
                     <% cause_chain.each_with_index do |cause, index| %>
+                      <% cause_bt = cause["backtrace"] %>
+                      <% cause_bt = cause_bt.is_a?(String) ? cause_bt.split("\n") : Array(cause_bt) %>
                       <div class="card mb-2 border-warning">
                         <div class="card-header bg-warning bg-opacity-10 py-2">
                           <div class="d-flex justify-content-between align-items-center">
@@ -151,7 +153,7 @@
                               <small class="text-muted">Caused by<%= " (##{index + 1})" if cause_chain.length > 1 %>:</small>
                               <strong class="ms-1"><code><%= cause["class_name"] %></code></strong>
                             </div>
-                            <% if cause["backtrace"].present? %>
+                            <% if cause_bt.any? %>
                               <button class="btn btn-sm btn-outline-secondary py-0" type="button"
                                       data-bs-toggle="collapse"
                                       data-bs-target="#cause-backtrace-<%= index %>"
@@ -164,11 +166,11 @@
                         <div class="card-body py-2">
                           <small><%= cause["message"] %></small>
                         </div>
-                        <% if cause["backtrace"].present? %>
+                        <% if cause_bt.any? %>
                           <div class="collapse" id="cause-backtrace-<%= index %>">
                             <div class="card-body p-0 border-top">
                               <div class="code-block p-2" style="max-height: 200px; overflow-y: auto; overflow-x: auto; font-size: 0.8rem;">
-                                <pre class="mb-0"><code><% cause["backtrace"].each do |line| %><%= line %>
+                                <pre class="mb-0"><code><% cause_bt.each do |line| %><%= line %>
 <% end %></code></pre>
                               </div>
                             </div>

data/db/migrate/20251223000000_create_rails_error_dashboard_complete_schema.rb

@@ -66,7 +66,7 @@ class CreateRailsErrorDashboardCompleteSchema < ActiveRecord::Migration[7.0]
       t.integer :priority_level, default: 0
 
       # Application association (from 20260106094233)
-      t.integer :application_id, null: false
+      t.bigint :application_id, null: false
 
       # Exception cause chain (from 20260220000001)
       t.text :exception_cause
@@ -129,7 +129,7 @@ class CreateRailsErrorDashboardCompleteSchema < ActiveRecord::Migration[7.0]
 
     # Create error_occurrences table (from 20251225100236)
     create_table :rails_error_dashboard_error_occurrences do |t|
-      t.integer :error_log_id, null: false
+      t.bigint :error_log_id, null: false
       t.datetime :occurred_at, null: false
       t.integer :user_id
       t.string :request_id
@@ -143,8 +143,8 @@ class CreateRailsErrorDashboardCompleteSchema < ActiveRecord::Migration[7.0]
 
     # Create cascade_patterns table (from 20251225101920)
     create_table :rails_error_dashboard_cascade_patterns do |t|
-      t.integer :parent_error_id, null: false
-      t.integer :child_error_id, null: false
+      t.bigint :parent_error_id, null: false
+      t.bigint :child_error_id, null: false
       t.integer :frequency, default: 1, null: false
       t.float :avg_delay_seconds
       t.float :cascade_probability
@@ -177,7 +177,7 @@ class CreateRailsErrorDashboardCompleteSchema < ActiveRecord::Migration[7.0]
 
     # Create error_comments table (from 20251226020100)
     create_table :rails_error_dashboard_error_comments do |t|
-      t.integer :error_log_id, null: false
+      t.bigint :error_log_id, null: false
       t.string :author_name, null: false
       t.text :body, null: false
       t.timestamps

data/lib/generators/rails_error_dashboard/install/install_generator.rb

@@ -224,7 +224,29 @@ module RailsErrorDashboard
           @database_name = "error_dashboard"
           @application_name = detect_application_name
 
+          say "\n  Is this the first app using the shared error database,", :white
+          say "  or are you connecting to one that already exists?\n", :white
+          say "  a) First app  - create a new shared error database", :white
+          say "  b) Existing   - connect to a database already used by another app", :white
+          say "\n"
+
+          shared_response = ask("  Choose (a/b):", :yellow, limited_to: [ "a", "A", "b", "B", "" ])
+
+          if shared_response.downcase == "b"
+            say "\n  Enter the base database name from your other app's database.yml.", :white
+            say "  We'll append _development/_production automatically.", :white
+            say "  (e.g., if your DB is 'my_errors_development', enter 'my_errors'):\n", :white
+            @shared_db_name = ask("  Database name:", :yellow)
+            @shared_db_name = @shared_db_name.strip
+            # Strip environment suffixes in case the user pasted the full name
+            @shared_db_name = @shared_db_name.sub(/_(development|production|test)$/, "")
+            @shared_db_name = "shared_errors" if @shared_db_name.empty?
+          else
+            @shared_db_name = "shared_errors"
+          end
+
           say "\n  Database key: error_dashboard", :green
+          say "  Shared database: #{@shared_db_name}", :green
           say "  Application name: #{@application_name}", :green
           say "  This app will share the error database with your other apps.", :white
           say "\n"
@@ -270,7 +292,31 @@ module RailsErrorDashboard
       end
 
       def copy_migrations
-        rails_command "rails_error_dashboard:install:migrations"
+        source_dir = File.expand_path("../../../../db/migrate", __dir__)
+        migrate_subdir = @enable_separate_database ? "db/error_dashboard_migrate" : "db/migrate"
+        target_dir = File.join(destination_root, migrate_subdir)
+
+        FileUtils.mkdir_p(target_dir)
+
+        # Check which migrations are already installed (by descriptive name, ignoring timestamp)
+        existing = Dir.glob(File.join(target_dir, "*rails_error_dashboard*.rb")).map { |f|
+          File.basename(f).sub(/^\d+_/, "")
+        }.to_set
+
+        timestamp = Time.now.utc.strftime("%Y%m%d%H%M%S").to_i
+
+        Dir.glob(File.join(source_dir, "*.rb")).sort.each do |source_file|
+          basename = File.basename(source_file)
+          name_without_ts = basename.sub(/^\d+_/, "")
+          suffixed = name_without_ts.sub(/\.rb$/, ".rails_error_dashboard.rb")
+
+          next if existing.include?(suffixed)
+
+          FileUtils.cp(source_file, File.join(target_dir, "#{timestamp}_#{suffixed}"))
+          timestamp += 1
+        end
+
+        say_status "copied", "migrations to #{migrate_subdir}", :green
       end
 
       def add_route
@@ -432,7 +478,8 @@ module RailsErrorDashboard
         say "    error_dashboard:", :white
         say "      <<: *default", :white
         if @enable_multi_app
-          say "      database: shared_errors_development", :white
+          shared_db_base = @shared_db_name || "shared_errors"
+          say "      database: #{shared_db_base}_development", :white
         else
           say "      database: #{app_name_snake}_errors_development", :white
         end
@@ -445,7 +492,8 @@ module RailsErrorDashboard
         say "    error_dashboard:", :white
         say "      <<: *default", :white
         if @enable_multi_app
-          say "      database: shared_errors_production", :white
+          shared_db_base = @shared_db_name || "shared_errors"
+          say "      database: #{shared_db_base}_production", :white
         else
           say "      database: #{app_name_snake}_errors_production", :white
         end

data/lib/rails_error_dashboard/engine.rb

@@ -9,6 +9,15 @@ module RailsErrorDashboard
         if RailsErrorDashboard.configuration&.use_separate_database
           database_name = RailsErrorDashboard.configuration&.database || :error_dashboard
 
+          # Guard: skip connects_to if the database config doesn't exist yet in database.yml.
+          # This happens during `rails generate` when the initializer was just created but
+          # the user hasn't added the database.yml entry yet.
+          db_configs = ActiveRecord::Base.configurations.configs_for(env_name: Rails.env)
+          unless db_configs.any? { |c| c.name == database_name.to_s }
+            Rails.logger.warn "[Rails Error Dashboard] Separate database '#{database_name}' is not configured in database.yml for the '#{Rails.env}' environment. Skipping connects_to. See docs/guides/DATABASE_OPTIONS.md"
+            next
+          end
+
           RailsErrorDashboard::ErrorLogsRecord.connects_to(
             database: { writing: database_name, reading: database_name }
           )

data/lib/rails_error_dashboard/version.rb

@@ -1,3 +1,3 @@
 module RailsErrorDashboard
-  VERSION = "0.2.2"
+  VERSION = "0.2.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_error_dashboard
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.4
 platform: ruby
 authors:
 - Anjan Jagirdar
@@ -225,12 +225,14 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.15'
-description: "Own your errors. Own your stack. A fully open-source, self-hosted error
-  dashboard for solo founders, indie hackers, and small teams. Professional error
-  tracking with beautiful UI, multi-channel notifications (Slack, Email, Discord,
-  PagerDuty), platform detection (iOS/Android/Web/API), and analytics. 5-minute setup,
-  works out-of-the-box. Rails 7.0-8.1 compatible. ⚠️ BETA: API may change before v1.0.0.
-  \U0001F3AE Live demo: https://rails-error-dashboard.anjan.dev (gandalf/youshallnotpass)"
+description: 'Own your errors. Own your stack. A fully open-source, self-hosted error
+  tracking Rails engine for solo founders, indie hackers, and small teams. Exception
+  monitoring with beautiful dashboard UI, multi-channel notifications (Slack, Email,
+  Discord, PagerDuty), platform detection (iOS/Android/Web/API), advanced analytics,
+  workflow management, and cause chain capture. A self-hosted Sentry alternative with
+  5-minute setup that works out-of-the-box. Production error monitoring for Rails
+  7.0-8.1. BETA: API may change before v1.0.0. Live demo: https://rails-error-dashboard.anjan.dev
+  (gandalf/youshallnotpass)'
 email:
 - anjan.jagirdar@gmail.com
 executables: []
@@ -393,7 +395,7 @@ files:
 - lib/rails_error_dashboard/version.rb
 - lib/tasks/error_dashboard.rake
 - lib/tasks/rails_error_dashboard_tasks.rake
-homepage: https://github.com/AnjanJ/rails_error_dashboard
+homepage: https://AnjanJ.github.io/rails_error_dashboard
 licenses:
 - MIT
 metadata:
@@ -403,7 +405,7 @@ metadata:
   documentation_uri: https://AnjanJ.github.io/rails_error_dashboard
   bug_tracker_uri: https://github.com/AnjanJ/rails_error_dashboard/issues
 post_install_message: "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n
-  \ Rails Error Dashboard v0.2.2\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n\U0001F195
+  \ Rails Error Dashboard v0.2.4\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n\U0001F195
   First time? Quick start:\n   rails generate rails_error_dashboard:install\n   rails
   db:migrate\n   # Add to config/routes.rb:\n   mount RailsErrorDashboard::Engine
   => '/error_dashboard'\n\n\U0001F504 Upgrading from v0.1.x?\n   rails db:migrate\n
@@ -426,6 +428,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.3
 specification_version: 4
-summary: Self-hosted Rails error monitoring — free, forever. Zero SaaS fees, zero
-  lock-in.
+summary: Self-hosted error tracking and exception monitoring for Rails. Free, forever.
 test_files: []