Lato

Lato is a Rails Engine to deliver a full featured web panel for your Rails application.

This gem includes:

User management with full authentication system (signin, signup, recover password, email validation, Google Authenticator multi-factor authentication, ETH wallet connection) and account management (user settings, password change, email change, etc.);
Web interface built with Bootstrap and Bootstrap Icons;
UI components integrated with Rails (data tables, forms, modals, async job executions etc.);

The gem is agnostic to the application stack. You can use it with different databases (PostgreSQL, MySQL, SQLite), different Job processors (Solid queue, Sidekiq, Delayed Job, etc.), different cache systems (Redis, Memcached, etc.).

The gem is designed to be easily customizable and extendable. You can fully customize the UI and the functionalities of the panel. You can also add new functionalities and components to the panel on the main application or develop new engines to extend the panel.

The gem is ready to be used with the latest Rails 7+ features like ESM import maps, Turbo and Stimulus. The front-end is designed to be responsive, mobile friendly and accessible.

Lato preview

Full documentation

The full documentation is available at: 👉 👉 THIS LINK 👈 👈

You can also use the Lato AI Agent directly on your browser to generate code and get helps with the gem.

Eco-system

The idea behind Lato is to create an eco-system of engines that can improve the functionalities of the panel. The following engines are already available:

Lato Spaces: manage multiple workspaces in the panel with user invitation and workspace roles;
Lato Settings: manage application settings from the UI panel;
Lato Storage: manage storage (Active Storage data) from the UI panel;

Installation

Add required dependencies to your application’s Gemfile:

# Use JavaScript with ESM import maps [https://github.com/rails/importmap-rails]
gem "importmap-rails" # NOTE: Probably already installed in default rails 7+ project

# Hotwire's SPA-like page accelerator [https://turbo.hotwired.dev]
gem "turbo-rails" # NOTE: Probably already installed in default rails 7+ project

# Hotwire's modest JavaScript framework [https://stimulus.hotwired.dev]
gem "stimulus-rails" # NOTE: Probably already installed in default rails 7+ project

# Use Sass to process CSS
gem "sassc-rails"

# Use lato as application panel
gem "lato"

Install gem and run required tasks:

$ bundle
$ rails active_storage:install
$ rails lato:install:application
$ rails lato:install:migrations
$ rails db:migrate

Mount lato routes on the config/routes.rb file:

Rails.application.routes.draw do
  mount Lato::Engine =&gt; "/lato"

  # ....
end

Import Lato Scss on app/assets/stylesheets/application.scss file:

@import 'lato/application';

// ....

Import Lato Js on app/javascript/application.js file:

import "lato/application";

// ....

Setup I18n on the config/application.rb file:

module MyApplication
  class Application &lt; Rails::Application
    config.i18n.available_locales = [:it, :en]
    config.i18n.default_locale = :it

    # ...
  end
end

Extra tasks

Lato integrates by default a basic PWAs manifest and service worker. To re-generate them with all required assets follow these steps:

Complete the configuration of lato on a custom initializer (see configuration options for more details)
Add an icon.png file on public/icon.png with minimum size of 512x512px
Run the following commands:

$ rails lato:generate:favicon
$ rails lato:generate:pwa

Development

Clone repository, install dependencies, run migrations and start:

$ git clone https://github.com/lato-org/lato
$ cd lato
$ bundle
$ rails db:migrate
$ rails db:seed
$ foreman start -f Procfile.dev

Publish

This script will publish the gem to rubygems.org. Make sure you have the correct permissions and that you are logged in to your rubygems account.

$ ruby ./bin/publish.rb

Generate documentation

This script will generate the documentation for the gem by exporting the Rails rendered views to HTML files. The documentation will be generated in the docs folder.

Make sure to have the server running on port 3000 before running the script.

$ ruby ./bin/generate_docs.rb

License

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

Modules

Classes