How to use Lato Storage

lato_storage adds an Active Storage management section to a Lato admin panel. Use it to monitor uploaded files, inspect storage usage, and run cleanup operations from the back office.

Installation

Add Lato Storage to the application Gemfile:

gem "lato"
gem "lato_storage"

Install the engine and run migrations:

bundle
rails lato_storage:install:application
rails lato_storage:install:migrations
rails db:migrate

Mount the engine in config/routes.rb:

Rails.application.routes.draw do
  mount LatoStorage::Engine => "/lato-storage"

  # ...
end

Import styles in app/assets/stylesheets/application.scss:

@import "lato_storage/application";

Import JavaScript in app/javascript/application.js:

import "lato_storage/application"

Permissions

Users must be logged into Lato and must have Lato Storage admin permission enabled.

user = Lato::User.find_by(email: "admin@example.com")
user.update!(lato_storage_admin: true)

What admins can do

• View an overview of storage usage.
• Check how many files, attachments, and variants exist.
• Browse uploaded files and related storage metadata.
• Identify unattached files that can be cleaned.
• Start a cleanup operation from the panel.

Performance configuration

Large applications can enable performance optimization for the dashboard. When enabled, some dashboard numbers can be estimates instead of exact values.

LatoStorage.configure do |config|
  config.optimize_performances = true
end

Cleanup

The cleaner action runs as a Lato operation, so admins can follow progress and result in the operation page. Use it to remove files that are no longer attached to application records.