admin_suite 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0f7c1be0b2abc25afb2d0e162c35694d27c03acb1c0db9aa5f7c75fdf9f5a0de
+  data.tar.gz: 5f969a9e650ccc2e135334658c00bda4fe59918d8b4f8402a43c7207ffd5b0cb
+SHA512:
+  metadata.gz: afadac82d6a9e20a8b6416c1299e3cba56fc4f0cab22ca33987498c7809e44167743636dc991acf08d2d6d142b5eac4132a8f8fafb3f79cd7c1dd697b12ba861
+  data.tar.gz: d2dac896f3b213c9058ec702a9673201d4561a793105c2f552afa6a79c7d4896b716372737a08db4eb0c5230b5a7a1d719f9d98f20c994143f9393c8b52005dc

data/.gitignore

@@ -0,0 +1,10 @@
+/pkg/
+/vendor/bundle/
+/coverage/
+/test/dummy/db/*.sqlite3*
+/test/dummy/config/master.key
+/test/dummy/config/credentials.yml.enc
+/test/dummy/log/*
+!/test/dummy/log/.keep
+/test/dummy/tmp/
+/test/dummy/storage/

data/Gemfile

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+
+# Declare runtime dependencies in the gemspec.
+gemspec
+
+group :development, :test do
+  # Provides the asset pipeline used by the engine/dummy app.
+  gem "propshaft"
+end
+
+group :test do
+  gem "simplecov", require: false
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Gleania
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,7 @@
+# AdminSuite
+
+A mountable Rails engine that provides a resource-based admin UI and generators.
+
+This engine is currently extracted from the Gleania app and is intended to be reused
+across other products.
+

data/Rakefile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+end
+
+task default: :test

data/app/assets/admin_suite.css

@@ -0,0 +1,444 @@
+/*
+ * AdminSuite baseline styles.
+ *
+ * This is intentionally small: it provides usable defaults for core UI elements
+ * even when the host app does not ship Tailwind.
+ *
+ * Host apps can still include their own stylesheet (e.g. Tailwind) via
+ * `AdminSuite.config.host_stylesheet`.
+ */
+
+body.admin-suite {
+  --admin-suite-bg: #f8fafc; /* slate-50 */
+  --admin-suite-fg: #0f172a; /* slate-900 */
+  --admin-suite-muted: #475569; /* slate-600 */
+  --admin-suite-border: #e2e8f0; /* slate-200 */
+  --admin-suite-card: #ffffff;
+  --admin-suite-primary: #4f46e5; /* indigo-600 */
+  --admin-suite-primary-hover: #4338ca; /* indigo-700 */
+  --admin-suite-danger: #ef4444; /* red-500 */
+
+  /* Sidebar gradient (dark) */
+  --admin-suite-sidebar-from: #312e81;
+  --admin-suite-sidebar-via: #3730a3;
+  --admin-suite-sidebar-to: #581c87;
+
+  /* Common portal accent colors (fixed palette) */
+  --admin-suite-color-amber: #f59e0b;
+  --admin-suite-color-emerald: #10b981;
+  --admin-suite-color-cyan: #06b6d4;
+  --admin-suite-color-violet: #8b5cf6;
+  --admin-suite-color-slate: #64748b;
+}
+
+/* Light-mode only for now.
+   The host app can implement dark mode later via Tailwind and explicit `.dark` toggling. */
+
+html, body {
+  height: 100%;
+}
+
+body.admin-suite {
+  background: var(--admin-suite-bg);
+  color: var(--admin-suite-fg);
+  font-family: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, Helvetica, Arial, "Apple Color Emoji", "Segoe UI Emoji";
+  line-height: 1.5;
+}
+
+body.admin-suite a {
+  color: var(--admin-suite-primary);
+  text-decoration: none;
+}
+/* Avoid global underline-on-hover: the engine uses Tailwind utilities for hover
+   states (nav items, button-like links). Prose/markdown renderers should opt-in
+   to underlines explicitly. */
+body.admin-suite a:hover { text-decoration: none; }
+
+/* Docs viewer (engine-owned, no Tailwind typography plugin required) */
+.admin-suite-doc-content {
+  color: var(--admin-suite-fg);
+  font-size: 0.95rem;
+  line-height: 1.75;
+}
+
+.admin-suite-doc-content h1,
+.admin-suite-doc-content h2,
+.admin-suite-doc-content h3,
+.admin-suite-doc-content h4 {
+  color: var(--admin-suite-fg);
+  font-weight: 700;
+  line-height: 1.25;
+  margin: 1.5rem 0 0.75rem;
+}
+
+.admin-suite-doc-content h2 {
+  font-size: 1.25rem;
+  padding-bottom: 0.5rem;
+  border-bottom: 1px solid var(--admin-suite-border);
+}
+
+.admin-suite-doc-content h3 { font-size: 1.05rem; }
+.admin-suite-doc-content h4 { font-size: 1rem; }
+
+.admin-suite-doc-content p { margin: 0.75rem 0; color: color-mix(in srgb, var(--admin-suite-fg) 80%, #0000); }
+
+.admin-suite-doc-content a {
+  color: var(--admin-suite-primary);
+  text-decoration: none;
+  font-weight: 600;
+}
+.admin-suite-doc-content a:hover { text-decoration: underline; }
+
+.admin-suite-doc-content ul,
+.admin-suite-doc-content ol { margin: 0.75rem 0 0.75rem 1.25rem; }
+.admin-suite-doc-content li { margin: 0.25rem 0; }
+
+.admin-suite-doc-content code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+  font-size: 0.9em;
+  padding: 0.1rem 0.35rem;
+  border-radius: 0.35rem;
+  background: #f1f5f9; /* slate-100 */
+}
+
+.admin-suite-doc-content pre {
+  margin: 1rem 0;
+  border-radius: 0.75rem;
+  overflow-x: auto;
+}
+
+.admin-suite-doc-content pre.highlight {
+  background: #1e293b; /* slate-800 */
+  padding: 1rem;
+}
+
+.admin-suite-doc-content pre code {
+  background: transparent;
+  padding: 0;
+  color: #e2e8f0; /* slate-200 */
+}
+
+.admin-suite-doc-content .code-block {
+  position: relative;
+}
+
+.admin-suite-doc-content .code-lang {
+  position: absolute;
+  top: 0.5rem;
+  right: 0.75rem;
+  font-size: 0.65rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  color: rgba(226, 232, 240, 0.8);
+  background: rgba(0, 0, 0, 0.25);
+  padding: 0.125rem 0.5rem;
+  border-radius: 0.35rem;
+}
+
+.admin-suite-doc-table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 1rem 0;
+  font-size: 0.95rem;
+}
+
+.admin-suite-doc-table th,
+.admin-suite-doc-table td {
+  border: 1px solid var(--admin-suite-border);
+  padding: 0.6rem 0.75rem;
+  text-align: left;
+  vertical-align: top;
+}
+
+.admin-suite-doc-table th {
+  background: #f8fafc; /* slate-50 */
+  font-weight: 700;
+}
+
+.admin-suite-doc-content blockquote {
+  margin: 1rem 0;
+  padding: 0.75rem 1rem;
+  border-left: 4px solid var(--admin-suite-primary);
+  background: color-mix(in srgb, var(--admin-suite-primary) 8%, #fff);
+  border-radius: 0 0.75rem 0.75rem 0;
+}
+
+/* Semantic theme classes (used throughout engine views) */
+.admin-suite-link {
+  color: var(--admin-suite-primary);
+  text-decoration: none;
+}
+
+.admin-suite-link-hover:hover {
+  color: var(--admin-suite-primary-hover);
+}
+
+.admin-suite-badge-primary {
+  background: color-mix(in srgb, var(--admin-suite-primary) 14%, #ffffff);
+  color: color-mix(in srgb, var(--admin-suite-primary) 80%, #000000);
+}
+
+.admin-suite-focus-ring:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--admin-suite-primary) 30%, transparent);
+}
+
+/* Portal / accent color helpers (semantic; no Tailwind palette dependency) */
+.admin-suite-portal-accent {
+  --portal-color: var(--admin-suite-color-slate);
+}
+.admin-suite-portal-accent--amber { --portal-color: var(--admin-suite-color-amber); }
+.admin-suite-portal-accent--emerald { --portal-color: var(--admin-suite-color-emerald); }
+.admin-suite-portal-accent--cyan { --portal-color: var(--admin-suite-color-cyan); }
+.admin-suite-portal-accent--violet { --portal-color: var(--admin-suite-color-violet); }
+.admin-suite-portal-accent--slate { --portal-color: var(--admin-suite-color-slate); }
+
+.admin-suite-portal-chip {
+  background: color-mix(in srgb, var(--portal-color) 22%, transparent);
+}
+
+.admin-suite-portal-icon {
+  color: color-mix(in srgb, var(--portal-color) 45%, white);
+}
+
+.admin-suite-portal-card {
+  background: color-mix(in srgb, var(--portal-color) 10%, white);
+  border: 1px solid var(--admin-suite-border);
+}
+
+.admin-suite-portal-card:hover {
+  box-shadow: 0 1px 2px rgba(15, 23, 42, 0.08);
+}
+
+.admin-suite-portal-link {
+  color: color-mix(in srgb, var(--portal-color) 75%, #000);
+}
+
+.admin-suite-portal-link:hover {
+  color: color-mix(in srgb, var(--portal-color) 90%, #000);
+}
+
+/* Generic themed card hover accents */
+.admin-suite-theme-border-hover:hover {
+  border-color: color-mix(in srgb, var(--admin-suite-primary) 35%, var(--admin-suite-border));
+}
+
+.admin-suite-theme-text-hover:hover {
+  color: var(--admin-suite-primary);
+}
+
+.admin-suite-env-dot {
+  background: var(--admin-suite-primary);
+}
+
+.admin-suite-avatar {
+  background: color-mix(in srgb, var(--admin-suite-primary) 18%, #fff);
+  color: color-mix(in srgb, var(--admin-suite-primary) 80%, #000);
+}
+
+.admin-suite-flash--info {
+  background: color-mix(in srgb, var(--admin-suite-primary) 10%, #fff);
+  border-color: color-mix(in srgb, var(--admin-suite-primary) 30%, var(--admin-suite-border));
+  color: color-mix(in srgb, var(--admin-suite-primary) 70%, #000);
+}
+
+/* Sidebar readability (engine-owned, light-mode only)
+   Ensures nav text is readable even without Tailwind utilities.
+   Note: `body.admin-suite a { color: var(--admin-suite-primary) }` is more specific
+   than `.admin-suite-sidebar a`, so we scope these rules under `body.admin-suite`
+   to guarantee the sidebar stays readable. */
+.admin-suite-sidebar {
+  background: linear-gradient(to bottom, var(--admin-suite-sidebar-from), var(--admin-suite-sidebar-via), var(--admin-suite-sidebar-to));
+}
+
+body.admin-suite .admin-suite-sidebar,
+body.admin-suite .admin-suite-sidebar a {
+  color: rgba(255, 255, 255, 0.95);
+}
+
+body.admin-suite .admin-suite-sidebar a:hover {
+  color: #ffffff;
+}
+
+body.admin-suite .admin-suite-sidebar .admin-suite-sidebar-muted {
+  color: rgba(255, 255, 255, 0.75);
+}
+
+.form-group { margin-bottom: 1rem; }
+.form-label {
+  display: block;
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: var(--admin-suite-muted);
+  margin-bottom: 0.25rem;
+}
+
+.form-input,
+.form-input-file,
+select.form-input,
+textarea.form-input {
+  display: block;
+  width: 100%;
+  padding: 0.55rem 0.75rem;
+  border: 1px solid var(--admin-suite-border);
+  border-radius: 0.5rem;
+  background: var(--admin-suite-card);
+  color: var(--admin-suite-fg);
+  font-size: 0.875rem;
+  box-sizing: border-box;
+}
+
+.form-input:focus,
+.form-input-file:focus {
+  outline: none;
+  border-color: var(--admin-suite-primary);
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--admin-suite-primary) 25%, transparent);
+}
+
+.form-checkbox {
+  width: 1rem;
+  height: 1rem;
+}
+
+table {
+  border-collapse: collapse;
+}
+
+th, td {
+  border-bottom: 1px solid var(--admin-suite-border);
+  padding: 0.6rem 0.75rem;
+  vertical-align: top;
+}
+
+th {
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  font-size: 0.75rem;
+  color: var(--admin-suite-muted);
+  text-align: left;
+}
+
+button {
+  font-family: inherit;
+}
+
+button[type="submit"],
+.btn-primary {
+  background: var(--admin-suite-primary);
+  color: white;
+  border: 0;
+  border-radius: 0.5rem;
+  padding: 0.55rem 0.9rem;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+button[type="submit"]:hover,
+.btn-primary:hover {
+  filter: brightness(0.95);
+}
+
+/* Primary buttons rendered as links (e.g. "New ...") */
+.admin-suite-btn-primary {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  padding: 0.55rem 0.9rem;
+  background: var(--admin-suite-primary);
+  color: #fff !important;
+  text-decoration: none !important;
+  border-radius: 0.5rem;
+  border: 0;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.admin-suite-btn-primary:hover {
+  background: var(--admin-suite-primary-hover);
+}
+
+.admin-suite-btn-primary--sm {
+  padding: 0.5rem 0.75rem;
+}
+
+/* Toggle switch fallback (engine-owned)
+   -----------------------------------
+   Some host builds (or Tailwind v4 scanning) may not emit translate utilities.
+   Provide minimal styles so index-page toggles render correctly regardless.
+*/
+.admin-suite-toggle-track {
+  position: relative;
+  display: inline-flex;
+  height: 1.5rem; /* h-6 */
+  width: 2.75rem; /* w-11 */
+  flex-shrink: 0;
+  cursor: pointer;
+  border-radius: 9999px;
+  border: 2px solid transparent;
+  transition: background-color 0.2s ease-in-out;
+  background: #e2e8f0; /* slate-200 (off) */
+  vertical-align: middle;
+}
+
+.admin-suite-toggle-wrap {
+  vertical-align: middle;
+}
+
+.admin-suite-toggle-wrap form.button_to {
+  margin: 0;
+  display: inline-flex;
+  align-items: center;
+}
+
+/* Rails `button_to` uses a submit button; our baseline styles all submit buttons.
+   Override those defaults for toggle switches so off/on colors can differ. */
+button.admin-suite-toggle-track {
+  padding: 0;
+  line-height: 1;
+  font-weight: 400;
+  background: #e2e8f0; /* slate-200 (off) */
+  color: inherit;
+  border-radius: 9999px;
+  vertical-align: middle;
+}
+
+.admin-suite-toggle-track:hover {
+  filter: none;
+}
+
+.admin-suite-toggle-thumb {
+  pointer-events: none;
+  display: inline-block;
+  height: 1.25rem; /* h-5 */
+  width: 1.25rem; /* w-5 */
+  border-radius: 9999px;
+  background: #fff;
+  box-shadow: 0 1px 2px rgba(0,0,0,0.15);
+  transition: transform 0.2s ease-in-out;
+  transform: translateX(0);
+}
+
+.admin-suite-toggle-track.is-on .admin-suite-toggle-thumb {
+  transform: translateX(1.25rem); /* translate-x-5 */
+}
+
+.admin-suite-toggle-track.is-on {
+  background: var(--admin-suite-primary);
+}
+
+button.admin-suite-toggle-track.is-on {
+  background: var(--admin-suite-primary);
+}
+
+.admin-suite-toggle-track:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px color-mix(in srgb, var(--admin-suite-primary) 30%, transparent);
+}
+
+.btn-danger {
+  background: var(--admin-suite-danger);
+  color: white;
+}
+

data/app/assets/admin_suite_tailwind.css

@@ -0,0 +1,8 @@
+/*
+ * Placeholder compiled Tailwind output for AdminSuite.
+ *
+ * Host apps should generate a real build during asset precompile or via a
+ * `tailwindcss` build step. This file exists so the engine can boot (and its
+ * test dummy app can render) even when a compiled build is not present.
+ */
+

data/app/assets/builds/admin_suite_tailwind.css

@@ -0,0 +1,8 @@
+/*
+ * Placeholder compiled Tailwind output for AdminSuite.
+ *
+ * Host apps should generate a real build during asset precompile or via the
+ * `tailwindcss` build step. This file exists so the engine can boot (and its
+ * test dummy app can render) even when a compiled build is not present.
+ */
+