lesli_bell 1.0.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a314f359bb1e0ef4d971fc23128c7b57e6e02655f6ce248d26539331e10affcc
-  data.tar.gz: 5a5f4327f3c7a2f34da5068746a0cec6648dca0579355eecb5f5f8bce5dfa0ed
+  metadata.gz: 230a04119c05f73f87f6fefcffc2f930301763388864f34fa6feb3bcf510598b
+  data.tar.gz: 654752028cdbe7d683f2c30a8060156f73b5e4a78de4d6dec07a5b1916cc3aa8
 SHA512:
-  metadata.gz: 01d5550b5e3a873cd3046008189346601c5996528ca010ed2d16231a44e5a2ade357337022721c40df8cf48c9f41de587a889392665fc76e12a0f6d6f2d1e45f
-  data.tar.gz: 90db0aad0cf9b93eabca7c42a597478a357e49bf94e11fdac550a7e04dee37f20b3be10bdaf52db6be69996b9b74cab49892e3dbd822a84065394ad9b4b80bb2
+  metadata.gz: f6d3dd2e9d2a37278dc122df57f2ab02b344f1c56d92167e4c4ae5eecef40badfda09cc39d8d4716ecccb72b144e111a7c0d54e9c95b300759f9784d630843fc
+  data.tar.gz: 77dbd210d847f72c9c923f1c010c73ee8453e83f544876a2df1a03edf3af3528530eccb881c0fb23a404fac81da316ea8b0821215818ff7f415af0422c58f8cd

data/Rakefile

@@ -1,5 +1,6 @@
 require "bundler/setup"
 
-load "rails/tasks/statistics.rake"
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
 
 require "bundler/gem_tasks"

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

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@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-space-y-reverse:0;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000}}}@layer theme{:root,:host{--spacing:.25rem;--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-xl:1.25rem;--text-xl--line-height:calc(1.75 / 1.25);--font-weight-medium:500;--font-weight-semibold:600;--radius-md:.375rem;--radius-lg:.5rem;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1)}}@layer utilities{.absolute{position:absolute}.relative{position:relative}.top-3{top:calc(var(--spacing) * 3)}.right-3{right:calc(var(--spacing) * 3)}.mt-1{margin-top:var(--spacing)}.mt-2{margin-top:calc(var(--spacing) * 2)}.block{display:block}.inline-flex{display:inline-flex}.size-8{width:calc(var(--spacing) * 8);height:calc(var(--spacing) * 8)}.items-center{align-items:center}.justify-center{justify-content:center}:where(.space-y-2>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2) * calc(1 - var(--tw-space-y-reverse)))}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-danger-300{border-color:var(--lesli-color-danger-300)}.border-info-300{border-color:var(--lesli-color-info-300)}.border-neutral-300{border-color:var(--lesli-color-neutral-300)}.border-success-300{border-color:var(--lesli-color-success-300)}.border-warning-300{border-color:var(--lesli-color-warning-300)}.bg-danger-50{background-color:var(--lesli-color-danger-50)}.bg-info-50{background-color:var(--lesli-color-info-50)}.bg-neutral-50{background-color:var(--lesli-color-neutral-50)}.bg-success-50{background-color:var(--lesli-color-success-50)}.bg-warning-50{background-color:var(--lesli-color-warning-50)}.px-4{padding-inline:calc(var(--spacing) * 4)}.py-3{padding-block:calc(var(--spacing) * 3)}.pr-14{padding-right:calc(var(--spacing) * 14)}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.leading-6{--tw-leading:calc(var(--spacing) * 6);line-height:calc(var(--spacing) * 6)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.break-all{word-break:break-all}.text-danger-700{color:var(--lesli-color-danger-700)}.text-danger-900{color:var(--lesli-color-danger-900)}.text-info-700{color:var(--lesli-color-info-700)}.text-info-900{color:var(--lesli-color-info-900)}.text-neutral-700{color:var(--lesli-color-neutral-700)}.text-neutral-900{color:var(--lesli-color-neutral-900)}.text-success-700{color:var(--lesli-color-success-700)}.text-success-900{color:var(--lesli-color-success-900)}.text-warning-700{color:var(--lesli-color-warning-700)}.text-warning-900{color:var(--lesli-color-warning-900)}.underline{text-decoration-line:underline}.decoration-current\/40{text-decoration-color:currentColor}@supports (color:color-mix(in lab, red, red)){.decoration-current\/40{-webkit-text-decoration-color:color-mix(in oklab, currentcolor 40%, transparent);-webkit-text-decoration-color:color-mix(in oklab, currentcolor 40%, transparent);text-decoration-color:color-mix(in oklab, currentcolor 40%, transparent)}}.underline-offset-2{text-underline-offset:2px}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}@media (hover:hover){.hover\:bg-danger-100:hover{background-color:var(--lesli-color-danger-100)}.hover\:bg-info-100:hover{background-color:var(--lesli-color-info-100)}.hover\:bg-neutral-100:hover{background-color:var(--lesli-color-neutral-100)}.hover\:bg-success-100:hover{background-color:var(--lesli-color-success-100)}.hover\:bg-warning-100:hover{background-color:var(--lesli-color-warning-100)}.hover\:decoration-current:hover{text-decoration-color:currentColor}}.focus-visible\:ring-2:focus-visible{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.focus-visible\:ring-current\/40:focus-visible{--tw-ring-color:currentcolor}@supports (color:color-mix(in lab, red, red)){.focus-visible\:ring-current\/40:focus-visible{--tw-ring-color:color-mix(in oklab, currentcolor 40%, transparent)}}.focus-visible\:ring-danger-500\/40:focus-visible{--tw-ring-color:var(--lesli-color-danger-500)}@supports (color:color-mix(in lab, red, red)){.focus-visible\:ring-danger-500\/40:focus-visible{--tw-ring-color:color-mix(in oklab, var(--lesli-color-danger-500) 40%, transparent)}}.focus-visible\:ring-info-500\/40:focus-visible{--tw-ring-color:var(--lesli-color-info-500)}@supports (color:color-mix(in lab, red, red)){.focus-visible\:ring-info-500\/40:focus-visible{--tw-ring-color:color-mix(in oklab, var(--lesli-color-info-500) 40%, transparent)}}.focus-visible\:ring-neutral-500\/40:focus-visible{--tw-ring-color:var(--lesli-color-neutral-500)}@supports (color:color-mix(in lab, red, red)){.focus-visible\:ring-neutral-500\/40:focus-visible{--tw-ring-color:color-mix(in oklab, var(--lesli-color-neutral-500) 40%, transparent)}}.focus-visible\:ring-success-500\/40:focus-visible{--tw-ring-color:var(--lesli-color-success-500)}@supports (color:color-mix(in lab, red, red)){.focus-visible\:ring-success-500\/40:focus-visible{--tw-ring-color:color-mix(in oklab, var(--lesli-color-success-500) 40%, transparent)}}.focus-visible\:ring-warning-500\/40:focus-visible{--tw-ring-color:var(--lesli-color-warning-500)}@supports (color:color-mix(in lab, red, red)){.focus-visible\:ring-warning-500\/40:focus-visible{--tw-ring-color:color-mix(in oklab, var(--lesli-color-warning-500) 40%, transparent)}}.focus-visible\:outline-none:focus-visible{--tw-outline-style:none;outline-style:none}}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}

data/app/controllers/lesli_bell/notifications_controller.rb

@@ -4,7 +4,7 @@ module LesliBell
 
         # GET /notifications
         def index
-            @notifications = respond_as_pagination(NotificationService.new(current_user, query).index)
+            @notifications = respond_with_pagination(NotificationService.new(current_user, query).index)
         end
 
         # GET /notifications/1
@@ -33,7 +33,7 @@ module LesliBell
         # PATCH/PUT /notifications/1
         def update
             NotificationService.new(current_user).read(params[:id])
-            @notifications = respond_as_pagination(NotificationService.new(current_user, query).index)
+            @notifications = respond_with_pagination(NotificationService.new(current_user, query).index)
             render :index
         end
 

data/app/models/lesli_bell/announcement/user.rb

@@ -1,6 +1,6 @@
 module LesliBell
     class Announcement::User < ApplicationRecord
-        belongs_to :announcement #, class_name: "CloudBell::Announcement", foreign_key: "cloud_bell_announcements_id", optional: false
-        #belongs_to :user, class_name: "Lesli::User", foreign_key: "users_id"
+        belongs_to :announcement
+        belongs_to :user, class_name: "::Lesli::User"
     end
 end

data/app/models/lesli_bell/announcement.rb

@@ -4,7 +4,7 @@ module LesliBell
         belongs_to :user, class_name: "::Lesli::User"
         has_many :users #, class_name: "::Lesli::User"
 
-        enum category: {
+        enum :category, {
             :info => 'info',
             :danger => 'danger',
             :warning => 'warning',

data/app/models/lesli_bell/dashboard.rb

@@ -32,9 +32,6 @@ Building a better future, one line of code at a time.
 
 module LesliBell
     class Dashboard < Lesli::Shared::Dashboard
-        self.table_name = "lesli_bell_dashboards"
-        belongs_to :account
-
         COMPONENTS = %i[]
     end
 end

data/app/views/lesli_bell/notifications/index.html.erb

@@ -30,24 +30,6 @@ Building a better future, one line of code at a time.
 // · 
 %>
 
-<style>
-.notification.is-danger.is-light {
-border: 2px solid hsl(var(--bulma-notification-h), var(--bulma-notification-s), var(--bulma-notification-color-l))
-}
-
-.notification.is-warning.is-light {
-border: 2px solid hsl(var(--bulma-notification-h), var(--bulma-notification-s), var(--bulma-notification-color-l));
-}
-
-.notification.is-success.is-light {
-border: 2px solid hsl(var(--bulma-notification-h), var(--bulma-notification-s), var(--bulma-notification-color-l));
-}
-
-.notification.is-info.is-light {
-border: 2px solid hsl(var(--bulma-notification-h), var(--bulma-notification-s), var(--bulma-notification-color-l));
-}
-</style>
-
 <%= render(LesliView::Layout::Container.new("lesli-bell-notifications-index")) do %>
 
     <%= render(LesliView::Components::Header.new("Notifications")) do %>
@@ -56,41 +38,75 @@ border: 2px solid hsl(var(--bulma-notification-h), var(--bulma-notification-s),
 
     <%= render(LesliView::Components::Toolbar.new) %>
 
-    <% if @notifications.size == 0 %>
+    <% if @notifications[:records].empty? %>
         <%= render(LesliView::Elements::Empty.new) %>
     <% else %>
-        <section class="notifications">
+        <section class="space-y-2" aria-label="Notifications">
             <% @notifications[:records].each do |notification| %>
-                <div class="notification is-<%= notification[:category] %> is-light mb-2">
+                <%
+                    notification_classes, close_button_classes = case notification[:category].to_s
+                    when "danger"
+                        [
+                            "border-danger-300 bg-danger-50 text-danger-900",
+                            "text-danger-700 hover:bg-danger-100 focus-visible:ring-danger-500/40"
+                        ]
+                    when "warning"
+                        [
+                            "border-warning-300 bg-warning-50 text-warning-900",
+                            "text-warning-700 hover:bg-warning-100 focus-visible:ring-warning-500/40"
+                        ]
+                    when "success"
+                        [
+                            "border-success-300 bg-success-50 text-success-900",
+                            "text-success-700 hover:bg-success-100 focus-visible:ring-success-500/40"
+                        ]
+                    when "info"
+                        [
+                            "border-info-300 bg-info-50 text-info-900",
+                            "text-info-700 hover:bg-info-100 focus-visible:ring-info-500/40"
+                        ]
+                    else
+                        [
+                            "border-neutral-300 bg-neutral-50 text-neutral-900",
+                            "text-neutral-700 hover:bg-neutral-100 focus-visible:ring-neutral-500/40"
+                        ]
+                    end
+                %>
+
+                <article class="relative rounded-lg border-2 px-4 py-3 pr-14 shadow-sm <%= notification_classes %>">
 
                     <!-- Close button -->
                     <%= button_to(
-                        notification_path(notification[:id]), 
-                        method: :put, 
-                        class: "button is-small is-#{notification[:category]}",
-                        form: { class: "delete" }) do %>
-                        <span class="icon">
-                            <span class="material-icons">close</span>
-                        </span>
+                        notification_path(notification[:id]),
+                        method: :put,
+                        class: "inline-flex size-8 items-center justify-center rounded-md transition-colors focus-visible:outline-none focus-visible:ring-2 #{close_button_classes}",
+                        form: { class: "absolute right-3 top-3" },
+                        aria: { label: "Mark notification as read" }) do %>
+                        <span class="material-symbols text-xl" aria-hidden="true">close</span>
                     <% end %>
 
                     <!-- Notification subject -->
-                    <strong><%= notification[:subject] %></strong>
+                    <strong class="block text-sm font-semibold"><%= notification[:subject] %></strong>
 
                     <!-- Notification body (optional) -->
                     <% if notification[:body].present? %>
-                        <p><%= notification[:body] %></p>
+                        <p class="mt-1 text-sm leading-6"><%= notification[:body] %></p>
                     <% end %>
 
                     <!-- Notification URL (optional) -->
                     <% if notification[:url].present? %>
-                        <p>
-                            <a href="<%= notification[:url] %>" target="_blank" rel="noopener noreferrer">
+                        <p class="mt-2 text-sm">
+                            <a
+                                class="break-all font-medium underline decoration-current/40 underline-offset-2 hover:decoration-current focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-current/40"
+                                href="<%= notification[:url] %>"
+                                target="_blank"
+                                rel="noopener noreferrer"
+                            >
                                 <%= notification[:url] %>
                             </a>
                         </p>
                     <% end %>
-                </div>
+                </article>
             <% end %>
         </section>
     <% end %>

data/config/routes.rb

@@ -31,7 +31,7 @@ Building a better future, one line of code at a time.
 =end
 
 LesliBell::Engine.routes.draw do  
-    Lesli::Routing.mount_dashboard_for(LesliBell)
+    Lesli::Router.mount_lesli_engine_routes(self)
     resources :notifications, only: [:index, :new, :update]
     resources :announcements, only: [:index]
 end

data/db/seeds.rb

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

data/lib/lesli_bell/engine.rb

@@ -4,9 +4,6 @@ module LesliBell
 
         initializer :lesli_bell do |app|
 
-            # register assets manifest
-            config.assets.precompile += %w[lesli_bell_manifest.js]
-
             # register engine migrations path
             unless app.root.to_s.match root.to_s
                 config.paths["db/migrate"].expanded.each do |expanded_path|

data/lib/lesli_bell/version.rb

@@ -1,4 +1,4 @@
 module LesliBell
-  VERSION = "1.0.0"
-  BUILD = "1752635550"
+  VERSION = "1.1.1"
+  BUILD = "1791607001"
 end

data/readme.md

@@ -1,67 +1,219 @@
-<div align="center" class="documentation-header">
-    <img width="100" alt="LesliBell logo" src="./app/assets/images/lesli_bell/bell-logo.svg" />
-    <h3 align="center">Notifications & Announcements System for the Lesli Framework.</h3>
+<div align="center">
+    <h1 align="center">
+        <img width="100" alt="LesliBell" src="./app/assets/images/lesli_bell/bell-logo.svg" />
+    </h1>
+    <h3 align="center">Notifications and announcements for the Lesli Framework.</h3>
 </div>
 
-
 <br />
-<hr/>
 
-<div align="center" class="documentation-statics">
-    <a target="blank" href="https://rubygems.org/gems/lesli">
-        <img height="22" alt="Gem Version" src="https://badge.fury.io/rb/lesli.svg"/>
+<div align="center">
+    <a target="_blank" href="https://github.com/LesliTech/LesliBell/actions/workflows/lesli-ci-tests.yaml">
+        <img
+            alt="LesliBell test status"
+            src="https://img.shields.io/github/actions/workflow/status/LesliTech/LesliBell/lesli-ci-tests.yaml?branch=master&style=for-the-badge&logo=github&label=tests">
+    </a>
+    <a target="_blank" href="https://rubygems.org/gems/lesli_bell">
+        <img alt="Gem Version" src="https://img.shields.io/gem/v/lesli_bell?style=for-the-badge&logo=ruby">
     </a>
-    <a class="mx-2" href="https://codecov.io/github/LesliTech/Lesli"> 
-        <img height="22" src="https://codecov.io/github/LesliTech/Lesli/graph/badge.svg?token=2O12NENK5Y"/> 
+    <a target="_blank" href="https://codecov.io/github/LesliTech/LesliBell">
+        <img alt="Codecov" src="https://img.shields.io/codecov/c/github/LesliTech/LesliBell?style=for-the-badge&logo=codecov">
     </a>
-    <a href="https://codecov.io/github/LesliTech/LesliBabel"> 
-        <img height="22" src="https://sonarcloud.io/api/project_badges/measure?project=LesliTech_LesliBabel&metric=sqale_rating"/> 
+    <a target="_blank" href="https://sonarcloud.io/project/overview?id=LesliTech_LesliBell">
+        <img alt="Sonar Quality Gate" src="https://img.shields.io/sonar/quality_gate/LesliTech_LesliBell?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="LesliBell notifications and announcements"
+        src="./docs/images/screenshot.png" />
+</div>
+
+---
+
+<br />
+
+## Introduction
+
+LesliBell is the official notifications and announcements engine for the [Lesli Framework](https://github.com/LesliTech/Lesli).
+
+It provides account-scoped communication tools that integrate with Lesli users, permissions, navigation, and shared application infrastructure.
+
+<br />
+
+## Features
+
+- User notification feeds with unread counts and read status
+- Notification categories for informational, success, warning, and danger messages
+- Delivery-channel metadata for web, push, email, dialog, and mobile notifications
+- Account-scoped announcements
+- Announcement metadata for paths, date ranges, links, and dismissible presentation
+- Pagination and integration with the standard Lesli interface
+
+<br />
+
+## Try LesliBell
+
+- [Try the online demo](https://demo.lesli.dev/)
+- [Run the Docker demo](https://github.com/LesliTech/lesli-docker-demo)
+
+<br />
+
+## Quick Start
 
-### Quick start
+### Requirements
+
+- A Rails application with [Lesli](https://rubygems.org/gems/lesli) 5.1 or newer
+- SQLite by default, or PostgreSQL when preferred by the host application
+
+### Install LesliBell
+
+Add the engine to the host Rails application and prepare its database:
 
 ```shell
-# Add LesliBell engine gem
 bundle add lesli_bell
+bin/rails lesli:db:prepare
 ```
 
-```shell
-# Setup & initialize the database
-rake lesli:db:setup
+### Mount the engine
+
+Applications using Lesli's standard router mount LesliBell automatically at `/bell`:
+
+```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 LesliBell engine
+# config/routes.rb
 Rails.application.routes.draw do
     mount LesliBell::Engine => "/bell"
 end
 ```
 
+Start Rails and visit [http://127.0.0.1:3000/bell](http://127.0.0.1:3000/bell):
+
+```shell
+bin/rails server
+```
+
+<br />
+
+## Usage
+
+### Create a notification for the current user
+
+LesliBell creates notifications through an account-scoped service. Pass a signed-in Lesli user to the service:
+
+```ruby
+LesliBell::NotificationService.new(current_user).create_for_me(
+    subject: "Your report is ready",
+    body: "Open the report to review the latest results.",
+    category: :success,
+    channel: :web,
+    url: "/reports/weekly"
+)
+```
+
+### Notify multiple users
+
+Use user IDs that belong to the current account:
+
+```ruby
+user_ids = current_user.account.users.pluck(:id)
+
+LesliBell::NotificationService.new(current_user).create(
+    {
+        subject: "Scheduled maintenance",
+        category: :warning,
+        channel: :web
+    },
+    send_to_user_ids: user_ids
+)
+```
+
+Unknown categories fall back to `info`; unknown channels fall back to `web`. The notification feed displays `created`, `sent`, and legacy records without a status. Updating `/bell/notifications/:id` marks that notification as read for the current user.
+
+See [Notifications](https://www.lesli.dev/engines/bell/notifications/overview/) and [Announcements](https://www.lesli.dev/engines/bell/announcements/overview/) for the data contracts, service behavior, and current route surface.
+
+<br />
 
-### Documentation
+## Development
 
+Clone LesliBell into the host application's `engines` directory:
 
+```shell
+cd RailsApp
+mkdir -p engines
+git clone https://github.com/LesliTech/LesliBell.git engines/LesliBell
+```
 
-### Lesli Documentation
-* [website](https://www.lesli.dev/)
-* [documentation](https://www.lesli.dev/engines/bell/)
+Reference the local engine from the host application's `Gemfile`:
+
+```ruby
+gem "lesli_bell", path: "engines/LesliBell"
+```
 
+Install dependencies, prepare the host database, and start Rails:
 
-### Get in touch with Lesli
+```shell
+bundle install
+bin/rails lesli:db:prepare
+bin/rails server
+```
 
-* [Email: hello@lesli.tech](hello@lesli.tech)
-* [Website: https://www.lesli.tech](https://www.lesli.tech)
-* [Twitter: @LesliTech](https://twitter.com/LesliTech)
+### Tests
 
+From a complete Lesli development workspace, run the engine test suite from the LesliBell directory:
 
-### License
--------
-Copyright (c) 2025, Lesli Technologies, S. A.
+```shell
+cd engines/LesliBell
+bin/rails test
+```
+
+Run the same suite with the engine coverage profile enabled:
+
+```shell
+COVERAGE=true bin/rails test
+```
+
+<br />
+
+## Documentation
+
+- [Lesli website](https://www.lesli.dev/)
+- [LesliBell documentation](https://www.lesli.dev/engines/bell/)
+- [Installation](https://www.lesli.dev/engines/bell/about/installation/)
+- [Notifications](https://www.lesli.dev/engines/bell/notifications/overview/)
+- [Announcements](https://www.lesli.dev/engines/bell/announcements/overview/)
+- [Database](https://www.lesli.dev/engines/bell/about/database/)
+- [Translations](https://www.lesli.dev/engines/bell/about/translations/)
+- [Frontend](https://www.lesli.dev/engines/bell/about/frontend/)
+- [Release notes](https://github.com/LesliTech/LesliBell/releases)
+- [Issue tracker](https://github.com/LesliTech/LesliBell/issues)
+- [Source code](https://github.com/LesliTech/LesliBell)
+
+<br />
+
+## Community
+
+- [X: @LesliTech](https://x.com/LesliTech)
+- [hello@lesli.tech](mailto:hello@lesli.tech)
+- [https://www.lesli.tech](https://www.lesli.tech)
+
+<br />
+
+## License
+
+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
@@ -74,12 +226,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/).
+
+The complete license text is available in the [license file](./license).
 
-<hr />
+---
+
+<br />
 <br />
 
-<div align="center" class="has-text-centered">
-    <img width="200" alt="Lesli logo" src="https://cdn.lesli.tech/lesli/brand/app-logo.svg" />
-    <h4 align="center" class="mt-0">Ruby on Rails SaaS Development Framework.</h4>
+<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,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: lesli_bell
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.1
 platform: ruby
 authors:
 - The Lesli Development Team
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-16 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lesli
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: 5.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5'
+        version: 5.1.0
 description: Notifications & Announcements System for the Lesli Framework.
 email:
 - hello@lesli.tech
@@ -37,6 +36,7 @@ files:
 - app/assets/javascripts/lesli_bell/application.js
 - app/assets/javascripts/lesli_bell/application.js.LICENSE.txt
 - app/assets/stylesheets/lesli_bell/application.css
+- app/assets/stylesheets/lesli_bell/application.tailwind.css
 - app/controllers/lesli_bell/accounts_controller.rb
 - app/controllers/lesli_bell/announcements_controller.rb
 - app/controllers/lesli_bell/application_controller.rb
@@ -81,7 +81,6 @@ files:
 - config/locales/translations.pt.yml
 - config/routes.rb
 - db/migrate/v1.0/0308000110_create_lesli_bell_accounts.rb
-- db/migrate/v1.0/0308003010_create_lesli_bell_dashboards.rb
 - db/migrate/v1.0/0308100110_create_lesli_bell_notifications.rb
 - db/migrate/v1.0/0308110110_create_lesli_bell_announcements.rb
 - db/migrate/v1.0/0308110210_create_lesli_bell_announcement_activities.rb
@@ -93,18 +92,7 @@ files:
 - lib/lesli_bell.rb
 - lib/lesli_bell/engine.rb
 - lib/lesli_bell/version.rb
-- lib/scss/application.scss
 - lib/tasks/lesli_bell_tasks.rake
-- lib/vue/application.js
-- lib/vue/apps/announcements/components/form.vue
-- lib/vue/apps/announcements/index.vue
-- lib/vue/apps/announcements/new.vue
-- lib/vue/apps/notifications/components/notification-form.vue
-- lib/vue/apps/notifications/index.vue
-- lib/vue/apps/notifications/new.vue
-- lib/vue/stores/announcement.js
-- lib/vue/stores/notification.js
-- lib/vue/stores/translations.json
 - license
 - readme.md
 homepage: https://www.lesli.dev/
@@ -114,7 +102,6 @@ metadata:
   homepage_uri: https://www.lesli.dev/
   changelog_uri: https://github.com/LesliTech/LesliBell
   source_code_uri: https://github.com/LesliTech/LesliBell
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -122,15 +109,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.7.1
 specification_version: 4
 summary: Notifications & Announcements System for the Lesli Framework.
 test_files: []

data/db/migrate/v1.0/0308003010_create_lesli_bell_dashboards.rb

@@ -1,37 +0,0 @@
-=begin
-
-Lesli
-
-Copyright (c) 2025, 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
-
-// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
-// · 
-=end
-
-class CreateLesliBellDashboards < ActiveRecord::Migration[6.1]
-    def change
-        create_table_lesli_shared_dashboards_10(:lesli_bell)
-    end
-end