lesli_dashboard 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00e59b42120b5d7fea1690f6f25c9d901a78abb45075ff735c28240cd37f0755
-  data.tar.gz: 374f8edac29b1c09b32937f4d27bb6a5fca9b572ad368045902c4cd65617980c
+  metadata.gz: 470a3490ccd8123513d348ba6b3dd443bf0e021dafe7b67470f584086da72d44
+  data.tar.gz: 16454047aebddbbed7c6a3788c4a4ecd15c0c5f9fd7d24b54f83a2b6e58094d9
 SHA512:
-  metadata.gz: 6768515e1c68c02331b2c26b390db37b80e71114983604fab663b369c253bfc8059aea8e5664c73be3566cd74061b02f9cb7d3c1745297749d5b6cce8f6a0746
-  data.tar.gz: de889af11479ddc2d33fbd745844a71c5df85a28a18df35469ac613b8da607515b60442eaace75b24b42deebd1b992287207677d63581ce9069478e6d0e25a1e
+  metadata.gz: 2258eb9725588b3387d8c49a9c8e2da000d9d712e8d5d2394af8843d9c20deb528782f191032ce4ee13eefe8f20bbea691ea62f28a7570a4ec0e06c81358a539
+  data.tar.gz: 57652dd6ee2d053e9232b36cfb3a9644b74b220ed64265fc999b71a4c21283b158e6664a9299df345d8e0aa14b288b581948bb47017e90167c6f31aa6df548aa

data/app/assets/stylesheets/lesli_dashboard/application.tailwind.css

@@ -0,0 +1,33 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+/*!
+
+Lesli
+
+Copyright (c) 2026, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by LesliTech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+*/
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid}}}@layer theme{:root,:host{--color-slate-50:oklch(98.4% .003 247.858);--color-slate-300:oklch(86.9% .022 252.894);--spacing:.25rem;--radius-2xl:1rem}}@layer utilities{.col-span-12{grid-column:span 12/span 12}.mt-6{margin-top:calc(var(--spacing) * 6)}.grid{display:grid}.h-full{height:100%}.w-full{width:100%}.min-w-0{min-width:0}.grid-cols-12{grid-template-columns:repeat(12,minmax(0,1fr))}.items-stretch{align-items:stretch}.gap-4{gap:calc(var(--spacing) * 4)}.rounded-2xl{border-radius:var(--radius-2xl)}.border{border-style:var(--tw-border-style);border-width:1px}.border-dashed{--tw-border-style:dashed;border-style:dashed}.border-slate-300{border-color:var(--color-slate-300)}.bg-slate-50\/70{background-color:#f8fafcb3}@supports (color:color-mix(in lab, red, red)){.bg-slate-50\/70{background-color:color-mix(in oklab, var(--color-slate-50) 70%, transparent)}}.px-6{padding-inline:calc(var(--spacing) * 6)}.py-12{padding-block:calc(var(--spacing) * 12)}@media (min-width:40rem){.sm\:gap-5{gap:calc(var(--spacing) * 5)}.sm\:py-16{padding-block:calc(var(--spacing) * 16)}}@media (min-width:48rem){.md\:col-span-6{grid-column:span 6/span 6}.md\:col-span-12{grid-column:span 12/span 12}}@media (min-width:64rem){.lg\:col-span-1{grid-column:span 1/span 1}.lg\:col-span-2{grid-column:span 2/span 2}.lg\:col-span-3{grid-column:span 3/span 3}.lg\:col-span-4{grid-column:span 4/span 4}.lg\:col-span-5{grid-column:span 5/span 5}.lg\:col-span-6{grid-column:span 6/span 6}.lg\:col-span-7{grid-column:span 7/span 7}.lg\:col-span-8{grid-column:span 8/span 8}.lg\:col-span-9{grid-column:span 9/span 9}.lg\:col-span-10{grid-column:span 10/span 10}.lg\:col-span-11{grid-column:span 11/span 11}.lg\:col-span-12{grid-column:span 12/span 12}.lg\:gap-6{gap:calc(var(--spacing) * 6)}}.\[\&_\.box\]\:h-full .box,.\[\&\>\*\]\:h-full>*{height:100%}}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}

data/app/views/lesli_dashboard/dashboards/_component-calendar.html.erb

@@ -1 +1,15 @@
-<%= render(LesliView::Widgets::Calendar.new) %>
+<%
+# Demo dates keep the widget populated until dashboard events come from the backend.
+# Replace this array with the account's event dates when that integration is available.
+calendar_date = Date.current
+calendar_events = [8, 10, 27].map { |day| calendar_date.change(day: day) }
+%>
+
+<%= render(
+    LesliView::Widgets::Calendar.new(
+        date: calendar_date,
+        events: calendar_events,
+        selected_date: calendar_date,
+        week_starts_on: :sunday
+    )
+) %>

data/app/views/lesli_dashboard/dashboards/_component-chart-bar.html.erb

@@ -1,6 +1,5 @@
-
 <%= render(LesliView::Widgets::Chart.new("Priorities", {
     "High": 10,
-    "Low": 16,
-    "Medium": 4
-}, type: :bar))%>
+    "Medium": 4,
+    "Low": 16
+}, type: :bar)) %>

data/app/views/lesli_dashboard/dashboards/_component-chart-line.html.erb

@@ -1,8 +1,7 @@
-
 <%= render(LesliView::Widgets::Chart.new("Requests", {
-    "1": 13,
-    "2": 17,
-    "3": 10,
-    "4": 5,
-    "5": 15,
-}, type: :line))%>
+    "Mon": 13,
+    "Tue": 17,
+    "Wed": 10,
+    "Thu": 5,
+    "Fri": 15
+}, type: :line)) %>

data/app/views/lesli_dashboard/dashboards/_component-weather.html.erb

@@ -1 +1,10 @@
-<%= render(LesliView::Widgets::Weather.new) %>
+<%# Demo values; replace them with backend weather data when available. %>
+<%= render(
+    LesliView::Widgets::Weather.new(
+        temperature: 26,
+        location: "Guatemala",
+        condition: "Showers",
+        unit: "C",
+        icon: "rainy"
+    )
+) %>

data/app/views/lesli_dashboard/dashboards/shared/_header.html.erb

@@ -1,21 +1,32 @@
 
 <%
+date = Date2.new
+hour = date.date.get.hour
 
-# Returns the hour (0–23) based on the app's timezone
-hour = Date2.new.date.get.hour  
-welcome_options = ["Good morning", "Good afternoon", "Good evening"]
-welcome_text = ""
+# Select the greeting using the application's configured time zone.
+greeting_key =
+    case hour
+    when 0...12 then "morning"
+    when 12...18 then "afternoon"
+    else "evening"
+    end
 
-if hour < 12
-    welcome_text = welcome_options.first
-elsif hour < 18
-    welcome_text = welcome_options.second
-else
-    welcome_text = welcome_options.third
-end
+greeting_defaults = {
+    "morning" => "Good morning",
+    "afternoon" => "Good afternoon",
+    "evening" => "Good evening"
+}.freeze
+
+greeting = I18n.t(
+    "lesli_dashboard.greetings.#{greeting_key}",
+    default: greeting_defaults.fetch(greeting_key)
+)
+
+# Avoid a trailing comma when the current user or full name is unavailable.
+title = [greeting, current_user&.full_name.presence].compact.join(", ")
 %>
 
 <%= render(LesliView::Components::Header.new(
-    welcome_text + ', ' + current_user&.full_name,
-    Date2.new.date_words_day
+    title,
+    date.date_words_day
 )) %>

data/app/views/lesli_dashboard/dashboards/shared/show.html.erb

@@ -29,45 +29,56 @@ Building a better future, one line of code at a time.
 // · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
 // · 
 %>
-<style>
-.dashboard-components .column > div,
-.dashboard-components .column > div > .box{
-    height: 100%;
-}
-</style>
-<%
-
-# Returns the hour (0–23) based on the app's timezone
-hour = Date2.new.date.get.hour  
-welcome_options = ["Good morning", "Good afternoon", "Good evening"]
-welcome_text = ""
-
-if hour < 12
-    welcome_text = welcome_options.first
-elsif hour < 18
-    welcome_text = welcome_options.second
-else
-    welcome_text = welcome_options.third
-end
-%>
 
-<% @dashboard ||= { :id=>0, :name=>"" } %>
 <% @components ||= [] %>
+<%
+# Dashboard component sizes use the same 12-column scale stored in the database.
+# Components stack on small screens and retain their configured width on desktops.
+component_width_classes = {
+    1 => "md:col-span-6 lg:col-span-1",
+    2 => "md:col-span-6 lg:col-span-2",
+    3 => "md:col-span-6 lg:col-span-3",
+    4 => "md:col-span-6 lg:col-span-4",
+    5 => "md:col-span-6 lg:col-span-5",
+    6 => "md:col-span-6 lg:col-span-6",
+    7 => "md:col-span-12 lg:col-span-7",
+    8 => "md:col-span-12 lg:col-span-8",
+    9 => "md:col-span-12 lg:col-span-9",
+    10 => "md:col-span-12 lg:col-span-10",
+    11 => "md:col-span-12 lg:col-span-11",
+    12 => "md:col-span-12 lg:col-span-12"
+}.freeze
+%>
 
 <%= render(LesliView::Layout::Container.new("dashboards-show", :dashboard => false)) do %>
 
     <%= render("lesli_dashboard/dashboards/shared/header") %>
 
-    <%= render(LesliView::Elements::Empty.new(text: "Empty dashboard")) if @components.empty? %>
-
-    <section class="container">
-        <div class="columns is-multiline is-variable dashboard-components">
-            <% @components.each do |component| %>
-                <div class="column is-<%= component["size"] %>">
-                    <% component_path = "#{controller.controller_path}/component-#{component["component"].gsub('_','-')}"%>
-                    <%= render(component_path, { :component => component }) %>
-                </div>
-            <% end %>
-        </div>
-    </section>
+    <% if @components.empty? %>
+        <section
+            class="mt-6 rounded-2xl border border-dashed border-slate-300 bg-slate-50/70 px-6 py-12 sm:py-16"
+            aria-label="Empty dashboard">
+            <%= render(LesliView::Elements::Empty.new(text: "Empty dashboard")) %>
+        </section>
+    <% else %>
+        <section class="mt-6 w-full" aria-label="Dashboard widgets">
+            <div class="grid grid-cols-12 items-stretch gap-4 sm:gap-5 lg:gap-6">
+                <% @components.each do |component| %>
+                    <%
+                    component_size = component["size"].to_i
+                    component_size = 4 unless component_width_classes.key?(component_size)
+                    component_name = component["component"].to_s
+                    component_path = "#{controller.controller_path}/component-#{component_name.dasherize}"
+                    %>
+                    <article
+                        class="col-span-12 min-w-0 <%= component_width_classes.fetch(component_size) %>"
+                        data-dashboard-component="<%= component_name %>">
+                        <div class="h-full min-w-0 [&>*]:h-full [&_.box]:h-full">
+                            <%= render(component_path, { :component => component }) %>
+                        </div>
+                    </article>
+                <% end %>
+            </div>
+        </section>
+    <% end %>
 <% end %>

data/config/locales/translations.en.yml

@@ -1,2 +1,7 @@
 ---
-:en: {}
+en:
+  lesli_dashboard:
+    greetings:
+      morning: Good morning
+      afternoon: Good afternoon
+      evening: Good evening

data/config/locales/translations.es.yml

@@ -1,2 +1,7 @@
 ---
-:es: {}
+es:
+  lesli_dashboard:
+    greetings:
+      morning: Buenos días
+      afternoon: Buenas tardes
+      evening: Buenas noches

data/config/locales/translations.fr.yml

@@ -1,2 +1,7 @@
 ---
-:fr: {}
+fr:
+  lesli_dashboard:
+    greetings:
+      morning: Bonjour
+      afternoon: Bon après-midi
+      evening: Bonsoir

data/config/locales/translations.it.yml

@@ -1,2 +1,7 @@
 ---
-:it: {}
+it:
+  lesli_dashboard:
+    greetings:
+      morning: Buongiorno
+      afternoon: Buon pomeriggio
+      evening: Buonasera

data/config/locales/translations.pt.yml

@@ -1,2 +1,7 @@
 ---
-:pt: {}
+pt:
+  lesli_dashboard:
+    greetings:
+      morning: Bom dia
+      afternoon: Boa tarde
+      evening: Boa noite

data/db/seeds.rb

@@ -30,7 +30,7 @@ Building a better future, one line of code at a time.
 // · 
 =end
 
-L2.msg("LesliDashboard", "Version: #{LesliDashboard::VERSION}", "Build: #{LesliDashboard::BUILD}")
+Termline.info("Loading seeds for: LesliDashboard #{LesliDashboard::VERSION} (#{LesliDashboard::BUILD})")
 
 # · load specific environment seeds
 if Rails.env.development? || Lesli.config.demo 

data/lib/lesli_dashboard/version.rb

@@ -1,4 +1,4 @@
 module LesliDashboard
-    VERSION = "1.1.0"
-    BUILD = "1774678451"
+    VERSION = "1.1.1"
+    BUILD = "1789353654"
 end

data/readme.md

@@ -1,14 +1,15 @@
 <div align="center">
-    <img width="100" alt="LesliDashboard logo" src="./app/assets/images/lesli_dashboard/dashboard-logo.svg" />
-    <h3 align="center">Dashboard Manager for the Lesli Framework.</h3>
+    <h1 align="center">
+        <img width="100" alt="LesliDashboard" src="./app/assets/images/lesli_dashboard/dashboard-logo.svg" />
+    </h1>
+    <h3 align="center">Configurable dashboards for the Lesli Framework.</h3>
 </div>
 
 <br />
-<hr/>
 
 <div align="center">
-    <a target="_blank" href="https://github.com/LesliTech/LesliDashboard/actions">
-        <img alt="Tests passing" src="https://img.shields.io/badge/Tests-passing-green?style=for-the-badge&logo=github">
+    <a target="_blank" href="https://github.com/LesliTech/LesliDashboard/actions/workflows/lesli-ci.yaml">
+        <img alt="LesliDashboard test status" src="https://img.shields.io/github/actions/workflow/status/LesliTech/LesliDashboard/lesli-ci.yaml?branch=master&style=for-the-badge&logo=github&label=tests">
     </a>
     <a target="_blank" href="https://rubygems.org/gems/lesli_dashboard">
         <img alt="Gem Version" src="https://img.shields.io/gem/v/lesli_dashboard?style=for-the-badge&logo=ruby">
@@ -16,83 +17,148 @@
     <a target="_blank" href="https://codecov.io/github/LesliTech/LesliDashboard">
         <img alt="Codecov" src="https://img.shields.io/codecov/c/github/LesliTech/LesliDashboard?style=for-the-badge&logo=codecov">
     </a>
+    <a target="_blank" href="https://sonarcloud.io/project/overview?id=LesliTech_LesliDashboard">
+        <img alt="Sonar Quality Gate" src="https://img.shields.io/sonar/quality_gate/LesliTech_LesliDashboard?server=https%3A%2F%2Fsonarcloud.io&style=for-the-badge&logo=sonarqubecloud&label=Quality">
+    </a>
 </div>
 
-<hr/>
 <br />
 
 <div align="center">
     <img
         style="width:100%;max-width:800px;border-radius:6px;"
-        alt="Lesli screenshot" src="./docs/images/screenshot.png" />
+        alt="LesliDashboard configurable dashboards"
+        src="./docs/images/screenshot.png" />
 </div>
 
+---
+
+<br />
+
+## Introduction
+
+LesliDashboard is the official dashboard engine for the [Lesli Framework](https://github.com/LesliTech/Lesli).
+
+It lets applications compose reusable, configurable dashboards from account-scoped components.
+
 <br />
-<hr/>
+
+## Features
+
+- Multiple account-scoped dashboards
+- Reusable dashboard components
+- Configurable component position and size
+- Component-specific configuration
+- Shared dashboards for teams and workflows
+
+<br />
+
+## Try LesliDashboard
+
+- [Try the online demo](https://demo.lesli.dev/)
+- [Run the Docker demo](https://github.com/LesliTech/lesli-docker-demo)
+
 <br />
 
-### Installation
+## Quick Start
+
+### Requirements
+
+- A Rails application with [Lesli](https://rubygems.org/gems/lesli)
+- SQLite by default, or PostgreSQL when preferred by the host application
+
+### Install LesliDashboard
+
+Add the engine to the host Rails application and prepare its database:
 
 ```shell
-# Add LesliDashboard engine gem
 bundle add lesli_dashboard
+bin/rails db:prepare
+```
+
+### Mount the engine
 
-# Setup & initialize the database
-rake lesli:db:setup
+Applications using Lesli's standard router mount LesliDashboard automatically at `/dashboard`:
+
+```ruby
+# config/routes.rb
+Rails.application.routes.draw do
+    Lesli::Router.mount(self)
+end
 ```
 
+If the application does not use the standard Lesli router, mount the engine directly:
+
 ```ruby
-# Load LesliDashboard engine
+# config/routes.rb
 Rails.application.routes.draw do
     mount LesliDashboard::Engine => "/dashboard"
 end
 ```
 
-<br />
-<hr/>
+Start Rails and visit [http://127.0.0.1:3000/dashboard](http://127.0.0.1:3000/dashboard):
+
+```shell
+bin/rails server
+```
+
 <br />
 
-### Development 
+## Development
+
+Clone LesliDashboard into the host application's `engines` directory:
 
 ```shell
-# clone the lesli repo inside your engine folder: RailsApp/engines
-git clone https://github.com/LesliTech/LesliDashboard.git
+cd RailsApp
+mkdir -p engines
+git clone https://github.com/LesliTech/LesliDashboard.git engines/LesliDashboard
+```
 
-# Load LesliDashboard as a Gem
-gem "lesli", path: "engines/LesliDashboard"
+Reference the local engine from the host application's `Gemfile`:
 
-# Install the necessary Gems to run LesliDashboard
+```ruby
+gem "lesli_dashboard", path: "engines/LesliDashboard"
+```
+
+Install dependencies, prepare the host database, and start Rails:
+
+```shell
 bundle install
+bin/rails db:prepare
+bin/rails server
+```
+
+### Tests
 
-# Setup & initialize the database
-rake lesli:db:setup
+From a complete Lesli development workspace, run the engine test suite from the LesliDashboard directory:
 
+```shell
+cd engines/LesliDashboard
+bin/rails test
 ```
 
 <br />
-<hr/>
-<br />
-
-### Demo
 
-* [online demo](https://demo.lesli.dev/)
-* [docker demo](https://github.com/LesliTech/lesli-docker-demo)
+## Documentation
 
+- [Lesli website](https://www.lesli.dev/)
+- [Documentation](https://www.lesli.dev/engines/dashboard)
+- [Release notes](https://github.com/LesliTech/LesliDashboard/releases)
+- [Issue tracker](https://github.com/LesliTech/LesliDashboard/issues)
+- [Source code](https://github.com/LesliTech/LesliDashboard)
 
-### Documentation
-* [website](https://www.lesli.dev/)
-* [documentation](https://www.lesli.dev/engines/dashboard)
+<br />
 
+## Community
 
-### Connect with Lesli
+- [X: @LesliTech](https://x.com/LesliTech)
+- [hello@lesli.tech](mailto:hello@lesli.tech)
+- [https://www.lesli.tech](https://www.lesli.tech)
 
-* [X: @LesliTech](https://x.com/LesliTech)
-* [Email: hello@lesli.tech](hello@lesli.tech)
-* [Website: https://www.lesli.tech](https://www.lesli.tech)
+<br />
 
+## License
 
-### License
--------
 Copyright (c) 2026, Lesli Technologies, S. A.
 
 This program is free software: you can redistribute it and/or modify
@@ -106,19 +172,16 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
-along with this program. If not, see http://www.gnu.org/licenses/.
+along with this program. If not, see [https://www.gnu.org/licenses/](https://www.gnu.org/licenses/).
 
-<br />
-<hr />
-<br />
-<br />
+The complete license text is available in the [license file](./license).
 
-<div align="center" class="has-text-centered">
-    <img width="200" alt="Lesli logo" src="https://cdn.lesli.tech/lesli/brand/app-logo.svg" />
-    <h3 align="center" class="mt-0">
-        The Open-Source SaaS Development Framework for Ruby on Rails.
-    </h3>
-</div>
+---
 
 <br />
 <br />
+
+<div align="center">
+    <img width="80" alt="Lesli icon" src="https://cdn.lesli.tech/lesli/brand/app-icon.svg" />
+    <h3 align="center">The Open-Source SaaS Development Framework for Ruby on Rails.</h3>
+</div>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lesli_dashboard
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - The Lesli Development Team
@@ -23,7 +23,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 5.1.0
-description: Dashboard Manager for the Lesli Framework
+description: |
+  Provides dashboard management capabilities for The Lesli Framework,
+  including configurable dashboards, widgets, metrics, and visual summaries
+  for monitoring business and system information.
 email:
 - hello@lesli.tech
 executables: []
@@ -35,6 +38,7 @@ files:
 - app/assets/images/lesli_dashboard/dashboard-logo.svg
 - app/assets/javascripts/lesli_dashboard/application.js
 - app/assets/stylesheets/lesli_dashboard/application.css
+- app/assets/stylesheets/lesli_dashboard/application.tailwind.css
 - app/controllers/lesli_dashboard/application_controller.rb
 - app/controllers/lesli_dashboard/components_controller.rb
 - app/controllers/lesli_dashboard/dashboard/components_controller.rb