rsb-admin 0.9.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3071fe9fb7627de15eb032d8ae6c15059f3131b3f1b659621a39e642a6222bdc
+  data.tar.gz: 9a80f870291efcc587c5c065e8daad3435e07ef3cf2fede88b2a5146f6a7fe91
+SHA512:
+  metadata.gz: 04bcb5b79f9670a8037d46ad7de412c4c2dea86419ae707a51504971e6e70cede74005ee6db11d20d8339055cd1b03a022fe964b869e166420c5a0a2197caf95
+  data.tar.gz: be1e160d6579cfd6cb1c1a08e0ccb9d5adc30bc39cd16ca1a09df3b255896ed98d77caa1a97377b932ab9e6d49a82b29509622a680fc825d4b4068c8de13c125

data/LICENSE

@@ -0,0 +1,15 @@
+Rails SaaS Builder (RSB)
+Copyright (C) 2026 Aleksandr Marchenko
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser 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 Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.

data/README.md

@@ -0,0 +1,83 @@
+# rsb-admin
+
+Lightweight, registrable admin panel for Rails SaaS Builder. Features dynamic resource CRUD, role-based access control with granular permissions, settings management, multi-theme support, and optional two-factor authentication. Other gems register resources and pages lazily via `ActiveSupport.on_load(:rsb_admin)`.
+
+## Installation
+
+### As part of Rails SaaS Builder
+
+```ruby
+gem "rails-saas-builder"
+```
+
+### Standalone
+
+```ruby
+gem "rsb-admin"
+```
+
+Then run:
+
+```bash
+bundle install
+rails generate rsb_admin:install
+rails db:migrate
+```
+
+## Key Features
+
+- Dynamic resource registration with DSL (columns, filters, form fields)
+- Role-based access control with per-resource, per-action permissions
+- Settings management page (tabbed by category)
+- Built-in themes: default and modern (dark/light)
+- Admin user management with email verification
+- Two-factor authentication (TOTP with backup codes)
+- Session management and device tracking
+- Breadcrumb navigation and pagination
+- Test kit for extension developers
+- Lazy resource registration via `on_load(:rsb_admin)` hooks
+
+## Basic Usage
+
+```ruby
+# Register resources from another gem
+ActiveSupport.on_load(:rsb_admin) do |registry|
+  registry.register_category "Content" do
+    resource Post, icon: "file-text", actions: [:index, :show, :edit, :update] do
+      column :title, sortable: true, link: true
+      column :status, formatter: :badge
+      filter :status, type: :select, options: %w[draft published]
+      form_field :title, type: :text, required: true
+      form_field :body, type: :textarea
+    end
+  end
+end
+```
+
+## Configuration
+
+```ruby
+RSB::Admin.configure do |config|
+  config.app_name = "My SaaS Admin"
+  config.company_name = "Acme Inc"
+  config.theme = :modern
+end
+```
+
+## Test Kit
+
+```ruby
+# In your integration tests
+include RSB::Admin::TestKit::Helpers
+
+admin = create_test_admin!(superadmin: true)
+sign_in_admin(admin)
+```
+
+## Documentation
+
+Part of [Rails SaaS Builder](../README.md). See the main README for the full picture.
+
+## License
+
+[LGPL-3.0](../LICENSE)

data/Rakefile

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'fileutils'
+require 'rake/testtask'
+
+task :prepare_test_db do
+  ENV['RAILS_ENV'] = 'test'
+  db = File.expand_path('test/dummy/db/test.sqlite3', __dir__)
+  FileUtils.rm_f(db)
+  require_relative 'test/dummy/config/environment'
+  ActiveRecord::Migration.verbose = false
+  ActiveRecord::MigrationContext.new(Rails.application.paths['db/migrate'].to_a).migrate
+  schema = File.expand_path('test/dummy/db/schema.rb', __dir__)
+  File.open(schema, 'w') { |f| ActiveRecord::SchemaDumper.dump(ActiveRecord::Base.connection_pool, f) }
+end
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task test: :prepare_test_db
+task default: :test

data/app/assets/javascripts/rsb/admin/themes/modern.js

@@ -0,0 +1,37 @@
+(function() {
+  var STORAGE_KEY = 'rsb-admin-mode';
+
+  function getPreferred() {
+    var stored = localStorage.getItem(STORAGE_KEY);
+    if (stored) return stored;
+    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+  }
+
+  function apply(mode) {
+    document.documentElement.setAttribute('data-rsb-mode', mode);
+    localStorage.setItem(STORAGE_KEY, mode);
+  }
+
+  // Apply on load (rule #17)
+  apply(getPreferred());
+
+  // Toggle function exposed globally for the button
+  window.rsbToggleMode = function() {
+    var current = document.documentElement.getAttribute('data-rsb-mode');
+    apply(current === 'dark' ? 'light' : 'dark');
+  };
+
+  // Sidebar section collapse/expand toggle
+  window.rsbToggleSection = function(id) {
+    var content = document.getElementById(id);
+    var chevron = document.getElementById(id + '-chevron');
+    if (!content) return;
+    if (content.classList.contains('hidden')) {
+      content.classList.remove('hidden');
+      if (chevron) chevron.classList.add('rotate-90');
+    } else {
+      content.classList.add('hidden');
+      if (chevron) chevron.classList.remove('rotate-90');
+    }
+  };
+})();