A beautiful Rails engine that provides a sleek, modern dashboard for monitoring and inspecting Active Storage data in your Rails application.

• 📊 Overview of Active Storage usage statistics
• 🔍 Browse and inspect blobs, attachments and variant records
• 📝 View metadata, file details, and relationships
• 🎨 Modern, responsive UI with animations
• 🚫 No external dependencies (vanilla JavaScript and CSS)

Add this line to your application's Gemfile:

gem 'active_storage_dashboard'

And then execute:

$ bundle

Mount the engine in your config/routes.rb file:

Rails.application.routes.draw do
  # IMPORTANT: Make sure the mount path does not contain any special characters
  # Use a simple path like '/active-storage-dashboard' or '/storage-dashboard'
  # This is crucial for proper URL generation
  mount ActiveStorageDashboard::Engine, at: "/active-storage-dashboard"
end

Then visit /active-storage-dashboard in your browser to see the beautiful dashboard.

The dashboard provides direct file download capabilities from both the list and detail views. Simply click on the download button to get your files.

The dashboard includes a task to remove unused blobs and attachments.

You can run this task from the command line:

$ rails active_storage:dashboard:purge_orphans

Re-analyze blobs that are not yet analyzed

$ rails active_storage:dashboard:reanalyze

Regenerate missing or outdated variants

$ rails active_storage:dashboard:regenerate_variants

This dashboard provides access to all Active Storage data. Consider adding authentication before using in production:

# config/routes.rb
authenticate :user, -> (user) { user.admin? } do
  mount ActiveStorageDashboard::Engine, at: "/active-storage-dashboard"
end

or with devise:

constraints lambda { |req| req.session[:user_id].present? || (req.env['warden'] && req.env['warden'].user(:user)) } do
  mount ActiveStorageDashboard::Engine, at: "/active-storage-dashboard"
end

Or, in your environment config or application.rb:

config.active_storage_dashboard.base_controller_class = "AdminController"

Bug reports and pull requests are welcome on GitHub at https://github.com/giovapanasiti/active_storage_dashboard.

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