studio-engine 0.29.1 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db4fb7663508ced21fce80ca29ec063c300c2826e0dadc511c266219303e449d
-  data.tar.gz: b7e7c5cb133164b6d2a0521d4f08291540a78b4fb01a0be3b840f5413e35d8bb
+  metadata.gz: be8862879ffbd78bccc84e617beb1bae213e57c76c91d421b1b64d8e9f5122ff
+  data.tar.gz: 8e8fbc3e9f4db83b65f4693aec67f58f183363e873869a89513c62215422345c
 SHA512:
-  metadata.gz: 328965e3979861ddc61b3c312a665b42b4e17d4d35a45851c3c76e9c538904e8096ba20725aa81fd45ba3e0509e8cf1fa764bbac70483a26afb5d8273bb43341
-  data.tar.gz: c3323dfb24072f240935a1c3300dcf694d9c5ba22097fe2c1dc27ed04d0ee68cfb18df95844fe182e71622ccc6ba151dcb8ef3c5cc3488b5ac9959535e16c0c3
+  metadata.gz: ae3fee306fed9857d3421c005ac4006f46dda013d95009a0cde4daf6fc010a6c2d604e8ea173d7806985807e8b5603c57e6cef392a2b2fd00943d3db050d645d
+  data.tar.gz: b629a74f76f684338f82e028e6a5833dd15289720da55fea4f25e08afa1549454bed48df1131f1338a8ac28880e9e86b9201765ab4c7aac043510eefe7a70797

data/CHANGELOG.md

@@ -2,6 +2,104 @@
 
 The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) — `MAJOR.MINOR.PATCH`. Consumer Rails apps install the released RubyGems package with `gem "studio-engine", "~> 0.6"`; bumping the gem version and updating consumer lockfiles is a release.
 
+## 0.30.0 — 2026-08-08
+
+**The hub's link sidebar becomes the engine's out-of-the-box navigation.** New
+apps get a default navigation surface without forking the navbar: declare
+`Studio.sidebar_sections` (a static Array or a callable receiving the view
+context; sections flagged `admin: true` show to admins only) and the engine
+navbar mounts a trigger in its desktop icon rail and mobile sub-navbar, then
+renders the slide-out link panels after the header. The family ships as
+`components/_link_sidebar` (dual desktop/mobile panels + the engine-owned
+Alpine `sidebars` store bridge, Turbo- and bfcache-safe), the generic
+`components/_sidebar_panel` shell, and `components/_link_sidebar_trigger` —
+all lifted from the mcritchie-studio hub. `engine.css` gains the
+`studio-link-sidebar-layer` stacking utility and the Alpine `[x-cloak]`
+pre-init rule. **Upgrade-safe by default:** `sidebar_sections` defaults to
+`[]`, which renders nothing — existing consumers see zero change until they
+opt in (pinned by `test/integration/sidebar_navbar_render_test.rb`). The
+`html { overflow-x: clip }` slide guard ships inside the sidebar partial, not
+globally. When the viewer's resolved sections carry an `admin: true` entry,
+the sidebar replaces the engine admin dropdown (both use the cog glyph — one
+gear, not two); public-only sections keep the dropdown. Resolution rules live
+in `lib/studio/sidebar_sections.rb` (pure Ruby, unit-tested); docs in
+`NEW_APP_SETUP.md` §4/§13 and `NAVBAR_SETUP.md`.
+
+**Off-chain apps lose the user nav's dead space.** The default second row
+(wallet address + level progress bar) renders only when it has something to
+show — a wallet, a server level, or the `show_logout_link` link. A plain
+app's signed-in nav collapses to one line instead of an empty progress strip.
+The engine navbar's fixed-width `.user-nav-col` (reserved to seat a balance)
+likewise applies only when `balance_html` is passed; without one the column
+becomes `.user-nav-fit` (shrink-to-fit, `max-width` capped for username
+truncation). turf-monster's dense nav is untouched: its users carry wallet +
+level, and it ships its own navbar. Pinned by
+`test/integration/user_nav_collapse_render_test.rb` and the user_nav view
+tests.
+
+**The dev/QA environment banner is now an engine standard a host adopts with ONE
+render call, and it carries the Local Inbox link.** Every app hand-rolled its own
+yellow "<Env> Environment" strip — this gem's own `NEW_APP_SETUP.md` § 9 shipped
+the `<div>` to copy — so no two apps agreed on when it showed or what it said, and
+none of them linked `/_studio/local_emails`. The engine already had the pieces
+(`studio/banners/_environment` and friends); it just could not decide *whether* to
+render, so no host could use it. It can now:
+
+```erb
+<%= render "studio/banners/environment" %>
+```
+
+No `unless Rails.env.production?` around it, no host `show_environment_banner?`,
+no forked buttons. The partial owns all three decisions — whether it appears
+(everywhere except real production; a QA app is Rails-production but a review
+target, so `QA_ENV=true` re-opens it), what it says (`"QA Environment ·
+Non-production"` on QA), and whether the inbox is linkable.
+
+**The inbox link tells the truth.** `Studio.local_inbox_reachable?` consults the
+SAME gate `Studio::LocalEmailsController` enforces, so the banner can never
+advertise a page that answers 404. Where the viewer resolves (a developer desk)
+you get a link; where it does not (QA — Rails-production, remote requests) the
+button degrades to an inert `role="status"` chip that still reports the connector
+and whether mail is sending or captured. This generalizes the degradation
+turf-monster had already built for itself.
+
+Purely additive. `Studio.local_tool_enabled?` and `Studio.local_email_capture?`
+are **unchanged** — their production hard-close still stands, which is also why
+`LOCAL_EMAIL_CAPTURE=1` on a QA dyno does nothing and QA still sends real mail.
+
+### Added
+
+- **`studio/banners/environment` self-gates** and accepts `preview:` (suppress
+  inside a navbar-preview render — a duplicate `vt-pinned-header` silently kills
+  view transitions), `extra:` (message segments), `devnet:`, and
+  `environment_label:`.
+- **`Studio::EnvironmentBanner`** — the show/label rules as dependency-free Ruby,
+  unit-tested directly so the suite exercises the shipped code, not a copy.
+- **`Studio.qa_environment?` / `.show_environment_banner?` /
+  `.environment_banner_message` / `.local_inbox_reachable?` / `.rails_env_name`.**
+  `qa_environment?` reads the existing `QA_ENV` the release conductor already sets
+  on every QA app — no new variable.
+- **`studio/banners/button` gained `as: :status`** — the same chrome, inert, for a
+  fact we can report but not navigate to.
+
+### Fixed
+
+- **`studio/banners/button` dropped every attribute on a block render.**
+  `tag.span(hash) { }` reads the hash as CONTENT, so the options never reached the
+  tag. Splatted as keywords now. Latent until `as: :status` became the first block
+  path to use it.
+
+### Docs
+
+- **`NEW_APP_SETUP.md` § 9 no longer ships a hand-rolled banner to copy** — it
+  renders the shared partial, and documents the QA/email reality.
+- **`NEW_APP_SETUP.md` § 5 now installs the engine migrations FIRST**
+  (`bin/rails studio:install:migrations`). Omitting them is silent:
+  `Studio::Email.deliver` records mail only when `studio_email_deliveries` exists
+  and otherwise falls back to a plain `deliver_later`, so the app drops every
+  captured email and shows an empty inbox. Exactly the mcritchie-industries bug,
+  fixed 2026-08-08.
+
 ## 0.29.1 — 2026-07-29
 
 **`Studio::Board::Rankable#reposition!` is now atomic — a mid-loop failure can no

data/README.md

@@ -2,7 +2,7 @@
 
 Shared Rails engine for McRitchie apps. Provides authentication, error handling, dynamic theming, and common concerns used by [McRitchie Studio](https://app.mcritchie.studio) and [Turf Monster](https://app.turfmonster.media).
 
-> **Part of the McRitchie ecosystem** — see [`ECOSYSTEM.md`](https://github.com/amcritchie/mcritchie-studio/blob/main/docs/ECOSYSTEM.md) for the 5-repo map; [`house-burn-down.md`](https://github.com/amcritchie/mcritchie-studio/blob/main/docs/agents/system/house-burn-down.md) for fresh-Mac recovery.
+> **Part of the McRitchie ecosystem** — see [`ECOSYSTEM.md`](https://github.com/McRitchie-Studio/mcritchie-studio/blob/main/docs/ECOSYSTEM.md) for the 5-repo map; [`house-burn-down.md`](https://github.com/McRitchie-Studio/mcritchie-studio/blob/main/docs/agents/system/house-burn-down.md) for fresh-Mac recovery.
 
 ## Installation
 
@@ -280,4 +280,4 @@ For short local experiments, temporarily point a consumer Gemfile at `path: "../
 Use the docs in [`docs/`](./docs) for engine setup, release, email transport,
 and host-app contracts. Current cross-repo setup, ports, credentials, and
 workflow guidance live in McRitchie Studio's
-[`docs/agents/`](https://github.com/amcritchie/mcritchie-studio/tree/main/docs/agents).
+[`docs/agents/`](https://github.com/McRitchie-Studio/mcritchie-studio/tree/main/docs/agents).

data/app/assets/tailwind/studio_engine/engine.css

@@ -181,6 +181,24 @@
   @apply px-8 py-3 text-base rounded-xl shadow-sm;
 }
 
+/* -- Link sidebar (out-of-the-box navigation) ------------------------------
+   Paired with components/_link_sidebar + _link_sidebar_trigger and the
+   Studio.sidebar_sections config. The layer sits above the sticky header
+   (z-50) and the modal host. Inert without the panel in the DOM, so apps
+   that declare no sections are unaffected. */
+
+@utility studio-link-sidebar-layer {
+  z-index: 10000;
+}
+
+/* Alpine's pre-init cloak. Engine partials (sidebar panels, dropdowns, the
+   modal host) mark themselves x-cloak so they stay hidden until Alpine boots
+   and x-show takes over. Engine-owned so every consumer gets the rule without
+   carrying the one-liner app-side; a duplicate app copy is harmless. */
+[x-cloak] {
+  display: none !important;
+}
+
 /* -- Smooth-load convention ------------------------------------------------
    Paired with layouts/studio/_smooth_load.html.erb (the Studio.smooth_load
    metas that opt Turbo into document.startViewTransition). These rules are

data/app/helpers/studio_sidebar_helper.rb

@@ -0,0 +1,22 @@
+# The link-sidebar's view seam. Exposed to host views automatically (the
+# engine is non-isolated), so the navbar and any host layout can gate on
+# studio_sidebar? without wiring. Sections resolve once per render pass —
+# the resolver may call a host lambda that walks models or routes.
+module StudioSidebarHelper
+  def studio_sidebar_sections
+    @studio_sidebar_sections ||= Studio.sidebar_sections_for(self)
+  end
+
+  def studio_sidebar?
+    studio_sidebar_sections.any?
+  end
+
+  # The admin dropdown and the sidebar trigger share the cog glyph — showing
+  # both reads as a double gear. When the viewer's resolved sections carry an
+  # admin-flagged entry, the sidebar IS the admin menu (its title says so) and
+  # the engine components skip the dropdown. Declaring only public sections
+  # keeps the dropdown, so admins never lose Theme/Navbar/Error Logs.
+  def studio_sidebar_replaces_admin_menu?
+    studio_sidebar_sections.any? { |section| section[:admin] }
+  end
+end

data/app/views/components/_link_sidebar.html.erb

@@ -0,0 +1,179 @@
+<%# The link sidebar — the engine's out-of-the-box navigation panel (lifted
+    from the mcritchie-studio hub). Renders the host's Studio.sidebar_sections
+    as a slide-out link tree in dual desktop/mobile panels, and carries its
+    own store bridge so a single render is self-sufficient. Render it once,
+    outside any sticky/backdrop-filter header (a fixed panel inside one
+    positions against the header, not the viewport); the engine navbar does
+    this automatically when sections are declared. %>
+<% sections = studio_sidebar_sections %>
+<% sidebar_admin = respond_to?(:admin?) && admin? %>
+<% close_action = "$store.sidebars.linkTreeOpen = false" %>
+
+<style>
+  /* Clip horizontal overflow so the off-canvas start/end frame of the slide
+     never flashes a scrollbar. `clip` (not `hidden`) does not create a scroll
+     container, so sticky headers keep working. Scoped here — not engine.css —
+     so apps that declare no sections get zero global CSS change. */
+  html { overflow-x: clip; }
+</style>
+
+<script>
+  // Store bridge (engine-owned): registers the Alpine `sidebars` store and
+  // keeps it healthy across Turbo navigations and bfcache restores. The
+  // panel's open/closed state is driven ENTIRELY by the store flag via
+  // x-show + x-transition — this bridge only flips the flag, never `display`
+  // directly, because an imperative display:none bakes an inline style that
+  // makes Alpine skip its enter transition (the panel pops instead of
+  // sliding). On turbo:before-cache / bfcache the flag drops so a restored
+  // page is closed. The document-level capture handlers make the trigger
+  // work even for clicks that land before Alpine initializes.
+  (function () {
+    function ensureLinkSidebarStore() {
+      if (!window.Alpine) return null;
+
+      var sidebars = Alpine.store('sidebars');
+      if (!sidebars) {
+        Alpine.store('sidebars', { linkTreeOpen: false });
+        return Alpine.store('sidebars');
+      }
+
+      if (typeof sidebars.linkTreeOpen === 'undefined') {
+        sidebars.linkTreeOpen = false;
+      }
+
+      return sidebars;
+    }
+
+    function setLinkSidebarOpen(open) {
+      var sidebars = ensureLinkSidebarStore();
+      if (sidebars) sidebars.linkTreeOpen = open;
+    }
+
+    function closeLinkSidebar() {
+      setLinkSidebarOpen(false);
+    }
+
+    function handleLinkSidebarClick(event) {
+      var closeTrigger = event.target.closest('[data-link-sidebar-close]');
+      if (closeTrigger) {
+        event.preventDefault();
+        event.stopPropagation();
+        event.stopImmediatePropagation();
+        closeLinkSidebar();
+        return;
+      }
+
+      var trigger = event.target.closest('[data-link-sidebar-trigger], [data-username-display], [data-profile-image-toggle]');
+      if (trigger && trigger.matches('[aria-controls~="studio-link-sidebar"]')) {
+        var sidebars = ensureLinkSidebarStore();
+        if (!sidebars) return;
+
+        event.preventDefault();
+        event.stopPropagation();
+        event.stopImmediatePropagation();
+        sidebars.linkTreeOpen = !sidebars.linkTreeOpen;
+        return;
+      }
+
+      var sidebars = ensureLinkSidebarStore();
+      if (!sidebars || !sidebars.linkTreeOpen) return;
+      if (event.target.closest('#studio-link-sidebar, #studio-link-sidebar-mobile')) return;
+
+      closeLinkSidebar();
+    }
+
+    function handleLinkSidebarKeydown(event) {
+      if (event.key === 'Escape') closeLinkSidebar();
+    }
+
+    if (!window.__studioLinkSidebarBridge) {
+      window.__studioLinkSidebarBridge = true;
+      document.addEventListener('alpine:init', ensureLinkSidebarStore);
+      document.addEventListener('turbo:load', ensureLinkSidebarStore);
+      document.addEventListener('turbo:before-cache', closeLinkSidebar);
+      window.addEventListener('pageshow', function (event) {
+        if (event.persisted) closeLinkSidebar();
+      });
+      document.addEventListener('click', handleLinkSidebarClick, true);
+      document.addEventListener('keydown', handleLinkSidebarKeydown, true);
+    }
+
+    ensureLinkSidebarStore();
+  })();
+</script>
+
+<% body_html = capture do %>
+  <nav class="flex-1 min-h-0 overflow-y-auto py-2" aria-label="Studio links">
+    <% sections.each do |section| %>
+      <div class="px-4 pt-4 pb-1 label-upper font-bold text-muted flex items-center gap-2">
+        <span><%= section[:title] %></span>
+        <% if section[:admin] %>
+          <span class="rounded border border-primary/20 bg-primary/10 px-1.5 py-0.5 text-[10px] font-mono text-primary">ADMIN</span>
+        <% end %>
+      </div>
+
+      <% section[:links].each do |link| %>
+        <% target = link[:target].presence %>
+        <%= link_to link[:href],
+              class: "group flex items-start gap-3 px-4 py-3 text-sm text-body hover:text-heading hover:bg-surface-alt focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/40 focus-visible:ring-inset transition",
+              target: target,
+              rel: target == "_blank" ? "noopener" : nil,
+              "@click": close_action do %>
+          <% if link[:hover_emoji].present? %>
+            <%= render "components/emoji_swap",
+                  base: link[:emoji],
+                  hover: link[:hover_emoji],
+                  class_name: "text-lg leading-none" %>
+          <% else %>
+            <span class="text-lg leading-none flex-shrink-0"><%= link[:emoji] %></span>
+          <% end %>
+          <span class="min-w-0">
+            <span class="block font-medium truncate"><%= link[:label] %></span>
+            <% if link[:desc].present? %>
+              <span class="block text-xs text-muted leading-snug mt-0.5"><%= link[:desc] %></span>
+            <% end %>
+          </span>
+        <% end %>
+      <% end %>
+    <% end %>
+  </nav>
+<% end %>
+
+<% footer_html = capture do %>
+  <% if logged_in? %>
+    <div class="border-t border-subtle p-2">
+      <%= link_to logout_path,
+            class: "flex items-center gap-3 rounded-md px-4 py-3 text-sm text-body hover:text-heading hover:bg-surface-alt focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/40 transition",
+            "@click": close_action do %>
+        <span>👋</span><span>Log out</span>
+      <% end %>
+    </div>
+  <% end %>
+<% end %>
+
+<%= render "components/sidebar_panel",
+      id: "studio-link-sidebar",
+      title: sidebar_admin ? "Admin Menu" : "Links",
+      open: "$store.sidebars.linkTreeOpen",
+      body_html: body_html,
+      footer_html: footer_html,
+      close_action: close_action,
+      outside_action: close_action,
+      escape_action: close_action,
+      display_class: "hidden md:flex",
+      role: "navigation",
+      aria_label: sidebar_admin ? "Admin menu" : "Links menu" %>
+
+<%= render "components/sidebar_panel",
+      id: "studio-link-sidebar-mobile",
+      title: sidebar_admin ? "Admin Menu" : "Links",
+      open: "$store.sidebars.linkTreeOpen",
+      body_html: body_html,
+      footer_html: footer_html,
+      close_action: close_action,
+      outside_action: close_action,
+      escape_action: close_action,
+      display_class: "flex md:hidden",
+      width_class: "w-full",
+      role: "navigation",
+      aria_label: sidebar_admin ? "Admin menu" : "Links menu" %>

data/app/views/components/_link_sidebar_trigger.html.erb

@@ -0,0 +1,21 @@
+<%# Link-sidebar toggle button. `class_name` prepends responsive placement
+    classes (the navbar mounts one instance `hidden md:inline-flex` in the
+    desktop icon rail and one in the mobile sub-navbar row). The click is
+    handled twice on purpose: the Alpine @click for normal operation, and the
+    document-level capture bridge in _link_sidebar for pre-Alpine clicks. %>
+<% extra_classes = local_assigns.fetch(:class_name, "") %>
+<% sidebar_admin = respond_to?(:admin?) && admin? %>
+<button type="button"
+        @click.stop="$store.sidebars.linkTreeOpen = !$store.sidebars.linkTreeOpen"
+        class="<%= "#{extra_classes} " if extra_classes.present? %>inline-flex h-9 w-9 items-center justify-center rounded-md text-secondary hover:text-heading hover:bg-surface-alt focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/40 transition"
+        title="<%= sidebar_admin ? 'Admin Menu' : 'Links' %>"
+        aria-label="<%= sidebar_admin ? 'Toggle admin menu' : 'Toggle links menu' %>"
+        aria-controls="studio-link-sidebar studio-link-sidebar-mobile"
+        aria-haspopup="dialog"
+        :aria-expanded="$store.sidebars && $store.sidebars.linkTreeOpen ? 'true' : 'false'"
+        data-link-sidebar-trigger="true">
+  <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-5 h-5">
+    <path stroke-linecap="round" stroke-linejoin="round" d="M9.594 3.94c.09-.542.56-.94 1.11-.94h2.593c.55 0 1.02.398 1.11.94l.213 1.281c.063.374.313.686.645.87.074.04.147.083.22.127.325.196.72.257 1.075.124l1.217-.456a1.125 1.125 0 0 1 1.37.49l1.296 2.247a1.125 1.125 0 0 1-.26 1.431l-1.003.827c-.293.241-.438.613-.43.992a7.723 7.723 0 0 1 0 .255c-.008.378.137.75.43.991l1.004.827c.424.35.534.955.26 1.43l-1.298 2.247a1.125 1.125 0 0 1-1.369.491l-1.217-.456c-.355-.133-.75-.072-1.076.124a6.47 6.47 0 0 1-.22.128c-.331.183-.581.495-.644.869l-.213 1.281c-.09.543-.56.941-1.11.941h-2.594c-.55 0-1.019-.398-1.11-.94l-.213-1.281c-.062-.374-.312-.686-.644-.87a6.52 6.52 0 0 1-.22-.127c-.325-.196-.72-.257-1.076-.124l-1.217.456a1.125 1.125 0 0 1-1.369-.49l-1.297-2.247a1.125 1.125 0 0 1 .26-1.431l1.004-.827c.292-.24.437-.613.43-.991a6.932 6.932 0 0 1 0-.255c.007-.38-.138-.751-.43-.992l-1.004-.827a1.125 1.125 0 0 1-.26-1.43l1.297-2.247a1.125 1.125 0 0 1 1.37-.491l1.216.456c.356.133.751.072 1.076-.124.072-.044.146-.086.22-.128.332-.183.582-.495.644-.869l.214-1.28Z" />
+    <path stroke-linecap="round" stroke-linejoin="round" d="M15 12a3 3 0 1 1-6 0 3 3 0 0 1 6 0Z" />
+  </svg>
+</button>

data/app/views/components/_sidebar_panel.html.erb

@@ -0,0 +1,63 @@
+<%# Shared fixed right-sidebar shell (lifted from the mcritchie-studio hub).
+    Alpine-driven: `open` is an Alpine expression; the panel slides in from
+    off-screen right under x-transition and positions beneath the sticky
+    header via the --nav-h custom property _head.html.erb publishes. %>
+<% id             = local_assigns.fetch(:id, nil) %>
+<% title          = local_assigns.fetch(:title, nil) %>
+<% open           = local_assigns.fetch(:open) %>
+<% actions_html   = local_assigns.fetch(:actions_html, nil) %>
+<% body_html      = local_assigns.fetch(:body_html, nil) %>
+<% footer_html    = local_assigns.fetch(:footer_html, nil) %>
+<% close_action   = local_assigns.fetch(:close_action, nil) %>
+<% outside_action = local_assigns.fetch(:outside_action, nil) %>
+<% escape_action  = local_assigns.fetch(:escape_action, nil) %>
+<% display_class  = local_assigns.fetch(:display_class, "hidden md:flex") %>
+<% width_class    = local_assigns.fetch(:width_class, "w-80 max-w-full") %>
+<% z_class        = local_assigns.fetch(:z_class, "studio-link-sidebar-layer") %>
+<% panel_class    = local_assigns.fetch(:panel_class, "") %>
+<% role           = local_assigns.fetch(:role, "complementary") %>
+<% aria_label     = local_assigns.fetch(:aria_label, title) %>
+<% labelledby     = id.present? && title.present? ? "#{id}-title" : nil %>
+
+<aside
+  <% if id.present? %>id="<%= id %>"<% end %>
+  x-cloak
+  x-show="<%= open %>"
+  <%= %(#{outside_action.present? ? "@click.outside=\"#{outside_action}\"" : ""}).html_safe %>
+  <%= %(#{escape_action.present? ? "@keydown.escape.window=\"#{escape_action}\"" : ""}).html_safe %>
+  <%= %(#{close_action.present? ? "@turbo:before-cache.window=\"#{close_action}\"" : ""}).html_safe %>
+  x-transition:enter="transition ease-out duration-300"
+  x-transition:enter-start="translate-x-full"
+  x-transition:enter-end="translate-x-0"
+  x-transition:leave="transition ease-in duration-200"
+  x-transition:leave-start="translate-x-0"
+  x-transition:leave-end="translate-x-full"
+  class="<%= display_class %> fixed right-0 <%= width_class %> bg-surface border-l border-subtle shadow-2xl <%= z_class %> flex-col <%= panel_class %>"
+  style="top:var(--nav-h, 6rem);height:calc(100% - var(--nav-h, 6rem))"
+  role="<%= role %>"
+  <% if labelledby %>aria-labelledby="<%= labelledby %>"<% elsif aria_label.present? %>aria-label="<%= aria_label %>"<% end %>>
+  <div class="flex flex-col h-full">
+    <% if title.present? || actions_html.present? || close_action.present? %>
+      <div class="flex items-center justify-between p-4 border-b border-subtle">
+        <% if title.present? %>
+          <h3 <% if labelledby %>id="<%= labelledby %>"<% end %> class="text-lg font-bold text-heading"><%= title %></h3>
+        <% end %>
+        <div class="flex items-center gap-2 ml-auto">
+          <%= actions_html if actions_html.present? %>
+          <% if close_action.present? %>
+            <button type="button"
+                    @click="<%= close_action %>"
+                    class="flex items-center justify-center w-8 h-8 rounded-full text-secondary hover:text-heading hover:bg-surface-alt focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/40 transition"
+                    aria-label="Close sidebar"
+                    data-link-sidebar-close="true">
+              <span class="text-xl leading-none">&times;</span>
+            </button>
+          <% end %>
+        </div>
+      </div>
+    <% end %>
+
+    <%= body_html if body_html.present? %>
+    <%= footer_html if footer_html.present? %>
+  </div>
+</aside>

data/app/views/components/_user_nav.html.erb

@@ -56,7 +56,9 @@
         <%= studio_nav_slot.call(balance_slot, balance_html) %>
         <div class="flex items-center gap-2 ml-auto self-end">
           <%= studio_nav_slot.call(extra_icons_slot, extra_icons_html) %>
-          <%= render "components/admin_dropdown" %>
+          <%# Skipped when the link sidebar carries the admin menu — two cog
+              glyphs side by side read as a double gear. %>
+          <%= render "components/admin_dropdown" unless respond_to?(:studio_sidebar_replaces_admin_menu?) && studio_sidebar_replaces_admin_menu? %>
           <%= render "components/theme_toggle_morph" %>
         </div>
         <% account_link = defined?(account_path) ? account_path : "#" %>
@@ -65,12 +67,16 @@
         <% end %>
       </div>
       <% div2_content = studio_nav_slot.call(div2_slot, div2_html) %>
+      <% server_level = current_user.respond_to?(:level) && current_user.level.present? ? current_user.level : nil %>
+      <% wallet_connected = current_user.respond_to?(:truncated_solana) && current_user.try(:solana_connected?) %>
       <% if div2_content.present? %>
         <%# Div 2 replaced by the consumer's slot (div2_slot or legacy div2_html). %>
         <%= div2_content %>
-      <% else %>
-        <%# Div 2 (Smaller): wallet address (left) + level (right) with progress bar %>
-        <% server_level = current_user.respond_to?(:level) && current_user.level.present? ? current_user.level : nil %>
+      <% elsif server_level || wallet_connected || show_logout_link %>
+        <%# Div 2 (Smaller): wallet address (left) + level (right) with progress
+            bar. Renders only when it has something to show — an off-chain,
+            level-less user without a logout link gets NO second row, so the
+            nav collapses to one line instead of an empty progress strip. %>
         <div x-data="{
                barWidth: 0,
                displayLevel: <%= server_level || 1 %>,
@@ -123,7 +129,7 @@
           <%# Text layer 1: muted (visible outside bar) %>
           <div class="absolute inset-0 flex items-center justify-between px-1.5 font-mono text-muted z-[1] nav-bar-text">
             <span>
-              <% if current_user.respond_to?(:truncated_solana) && current_user.try(:solana_connected?) %>
+              <% if wallet_connected %>
                 <%= current_user.truncated_solana %>
               <% end %>
             </span>
@@ -136,7 +142,7 @@
           <%# Text layer 2: white (clip-path reveals where bar covers) %>
           <div class="absolute inset-0 flex items-center justify-between px-1.5 font-mono text-white z-[2] nav-bar-text" :style="{ 'clip-path': 'inset(0 ' + (100 - barWidth) + '% 0 0)' }">
             <span>
-              <% if current_user.respond_to?(:truncated_solana) && current_user.try(:solana_connected?) %>
+              <% if wallet_connected %>
                 <%= current_user.truncated_solana %>
               <% end %>
             </span>
@@ -167,7 +173,7 @@
       <%= render "components/avatar", user: current_user, size: "nav" %>
     <% end %>
   <% else %>
-    <%= render "components/admin_dropdown" %>
+    <%= render "components/admin_dropdown" unless respond_to?(:studio_sidebar_replaces_admin_menu?) && studio_sidebar_replaces_admin_menu? %>
     <%= render "components/theme_toggle_morph" %>
     <div class="flex items-center gap-3 ml-auto">
       <%= link_to "Log in", login_path, class: "text-heading hover:text-primary text-sm font-semibold transition" %>

data/app/views/layouts/_navbar.html.erb

@@ -19,6 +19,17 @@
 <% balance_html = local_assigns.fetch(:balance_html, nil) %>
 <% extra_icons_html = local_assigns.fetch(:extra_icons_html, nil) %>
 <% show_logout_link = local_assigns.fetch(:show_logout_link, false) %>
+<%# Out-of-the-box navigation (engine 0.30): when the host declares
+    Studio.sidebar_sections, the navbar mounts the link-sidebar trigger in its
+    icon rails and renders the slide-out panels after the header. With no
+    sections (the default) all of this is skipped — the navbar is unchanged.
+    Preview renders skip it too: the /admin/navbar page renders this partial
+    repeatedly and the panels carry page-unique ids. %>
+<% sidebar_active = !is_preview && respond_to?(:studio_sidebar?) && studio_sidebar? %>
+<% if sidebar_active %>
+  <% sidebar_trigger_desktop = capture { render "components/link_sidebar_trigger", class_name: "hidden md:inline-flex" } %>
+  <% extra_icons_html = safe_join([extra_icons_html, sidebar_trigger_desktop].compact) %>
+<% end %>
 <%
   words = Studio.app_name.split
   last_word = words.pop
@@ -31,9 +42,14 @@
         :class="scrolled && 'shadow-lg border-b border-subtle is-scrolled'">
   <style>
     .user-nav-col { width: 14rem; }
+    /* No balance content → no reserved column. The nav hugs its icons and
+       name instead of floating in the balance's empty seat. max-width steps
+       mirror the col's clamps: the item is flex-shrink-0, so without them a
+       long nowrap username sizes the column past a narrow viewport. */
+    .user-nav-fit { max-width: 14rem; }
     .nav-title { display: flex; gap: 0.25em; align-items: baseline; }
-    @media (min-width: 400px) { .user-nav-col { width: 15rem; } }
-    @media (min-width: 768px) { .user-nav-col { width: 20rem; } }
+    @media (min-width: 400px) { .user-nav-col { width: 15rem; } .user-nav-fit { max-width: 15rem; } }
+    @media (min-width: 768px) { .user-nav-col { width: 20rem; } .user-nav-fit { max-width: 20rem; } }
     @media (max-width: 767px) {
       .nav-title { font-size: 1.25rem !important; flex-direction: column; gap: 0; line-height: 1.15; transition: font-size 0.3s; }
       .nav-title span:first-child { margin-bottom: -4px; }
@@ -69,12 +85,15 @@
         </nav>
       </div>
     </div>
-    <%# Right side: user nav (matches sidebar width) %>
-    <div class="user-nav-col flex-shrink-0 pl-0 pr-4 md:px-4">
+    <%# Right side: user nav. The fixed column (matches sidebar width) exists
+        to seat a balance in the top row; with no balance content it shrinks
+        to fit. %>
+    <div class="<%= balance_html.present? ? 'user-nav-col' : 'user-nav-fit' %> flex-shrink-0 pl-0 pr-4 md:px-4">
       <% if show_user %>
         <%= render "components/user_nav", balance_html: balance_html, extra_icons_html: extra_icons_html, show_logout_link: show_logout_link %>
       <% else %>
         <div class="flex items-center justify-end gap-3">
+          <%= sidebar_trigger_desktop if sidebar_active %>
           <span class="hidden md:flex"><%= render "components/theme_toggle_morph" %></span>
           <%= link_to "Log in", login_path, class: "btn btn-primary" %>
         </div>
@@ -84,8 +103,13 @@
   <%# Mobile sub-navbar: compact row hidden on desktop — apps should override to add links %>
   <div class="flex md:hidden items-center gap-3 px-4 py-1.5 border-t border-subtle bg-surface-alt">
     <span class="ml-auto flex items-center gap-3">
-      <%= render "components/admin_dropdown" %>
+      <%= render "components/link_sidebar_trigger" if sidebar_active %>
+      <%= render "components/admin_dropdown" unless sidebar_active && studio_sidebar_replaces_admin_menu? %>
       <%= render "components/theme_toggle_morph" %>
     </span>
   </div>
 </header>
+<%# The panels mount OUTSIDE the header: the sticky header's backdrop-filter
+    creates a containing block, which would pin a fixed panel to the header
+    instead of the viewport. %>
+<%= render "components/link_sidebar" if sidebar_active %>

data/app/views/navbar/show.html.erb

@@ -15,7 +15,7 @@
   .navbar-preview.is-mobile .hidden.md\:flex { display: none !important; }
   .navbar-preview.is-mobile .hidden.md\:block { display: none !important; }
   .navbar-preview.is-mobile .flex.md\:hidden { display: flex !important; }
-  .navbar-preview.is-mobile .user-nav-col { padding-left: 0 !important; padding-right: 1rem !important; }
+  .navbar-preview.is-mobile .user-nav-col, .navbar-preview.is-mobile .user-nav-fit { padding-left: 0 !important; padding-right: 1rem !important; }
   .navbar-preview.is-mobile .nav-title { flex-direction: column !important; gap: 0 !important; line-height: 1.15 !important; }
   .navbar-preview.is-mobile .nav-title span:first-child { margin-bottom: -4px !important; }
   .navbar-preview.is-mobile .nav-title span:last-child { font-size: 1.5rem !important; }
@@ -26,15 +26,18 @@
   .navbar-preview.bp-tiny .nav-title span:last-child { font-size: 1.3rem !important; }
   .navbar-preview.bp-tiny .nav-logo-link { gap: 0.25rem !important; }
   .navbar-preview.bp-tiny .user-nav-col { width: 14rem !important; }
+  .navbar-preview.bp-tiny .user-nav-fit { max-width: 14rem !important; }
   .navbar-preview.bp-tiny .username-cap { max-width: 5rem !important; }
 
   /* Small (400-767px) */
   .navbar-preview.bp-small .nav-title { font-size: 1.25rem !important; }
   .navbar-preview.bp-small .user-nav-col { width: 15rem !important; }
+  .navbar-preview.bp-small .user-nav-fit { max-width: 15rem !important; }
   .navbar-preview.bp-small .username-cap { max-width: 6rem !important; }
 
   /* Desktop (768px+) */
   .navbar-preview.is-desktop .user-nav-col { width: 20rem !important; }
+  .navbar-preview.is-desktop .user-nav-fit { max-width: 20rem !important; }
   .navbar-preview.is-desktop .username-cap { max-width: 7rem !important; }
 
   /* Transitions for scrolled toggle */

data/app/views/studio/banners/_button.html.erb

@@ -2,6 +2,8 @@
   label = local_assigns[:label]
   content = local_assigns[:content] || label
   href = local_assigns[:href]
+  # :link · :button · :status — a status chip carries the same chrome but is
+  # inert (no href, no click), for facts we can report but not navigate to.
   as = local_assigns.fetch(:as, href.present? ? :link : :button).to_sym
   method = local_assigns[:method]
   tooltip = local_assigns[:tooltip]
@@ -36,7 +38,7 @@
     "background:#{default_background}",
     "border:1px solid #{default_border}",
     "color:#{default_color}",
-    "cursor:pointer",
+    "cursor:#{as == :status ? "default" : "pointer"}",
     "font:inherit",
     "font-weight:700",
     "text-decoration:none",
@@ -73,7 +75,13 @@
   end
 %>
 
-<% if as == :button %>
+<%# `tag.span(hash) { }` would read the hash as CONTENT and drop every attribute
+    on the floor — the options must be splatted as keywords when a block is given. %>
+<% if as == :status %>
+  <%= tag.span(**attrs.merge(role: "status", tabindex: "0")) do %>
+    <%= content %><%= tooltip_content if tooltip.present? %>
+  <% end %>
+<% elsif as == :button %>
   <%= button_tag attrs.merge(type: "button") do %>
     <%= content %><%= tooltip_content if tooltip.present? %>
   <% end %>

data/app/views/studio/banners/_email_status_button.html.erb

@@ -1,4 +1,15 @@
-<% details = email_delivery_banner_details %>
+<%
+  details = email_delivery_banner_details
+
+  # Link the inbox only where it actually answers. Studio::LocalEmailsController
+  # gates on the SAME call, so this can never advertise a 404: on QA (Rails
+  # production, remote requests) the button degrades to a non-link status chip
+  # that still reports the connector and whether mail is sending or captured.
+  inbox_reachable = Studio.local_inbox_reachable?(
+    request_local: (respond_to?(:request) && request ? request.local? : false)
+  )
+  tooltip = inbox_reachable ? details.fetch(:tooltip) : "#{details.fetch(:tooltip)} · Inbox: local only"
+%>
 
 <% content = capture do %>
   <span>Email</span>
@@ -16,8 +27,16 @@
   <% end %>
 <% end %>
 
-<%= render "studio/banners/button",
-           href: "/_studio/local_emails",
-           label: "Email",
-           content: content,
-           tooltip: details.fetch(:tooltip) %>
+<% if inbox_reachable %>
+  <%= render "studio/banners/button",
+             href: Studio::EnvironmentBanner::INBOX_PATH,
+             label: "Email",
+             content: content,
+             tooltip: tooltip %>
+<% else %>
+  <%= render "studio/banners/button",
+             as: :status,
+             label: "Email",
+             content: content,
+             tooltip: tooltip %>
+<% end %>

data/app/views/studio/banners/_environment.html.erb

@@ -1,18 +1,43 @@
+<%#
+  The ONE environment banner every Studio app renders. Host layouts render this
+  partial and nothing else — it decides FOR ITSELF whether to appear, what to
+  say, and whether the local inbox is linkable. See docs/NEW_APP_SETUP.md § 9.
+
+  Locals (all optional):
+    preview           — true inside a navbar-preview render; suppresses the
+                        banner so a preview copy can't duplicate live chrome.
+    environment_label — override the whole message (rare; prefer `extra`).
+    extra             — extra message segments, joined with " · " (e.g. "Devnet").
+    devnet            — renders a DEVNET chip beside the buttons.
+%>
 <%
-  environment_label = local_assigns.fetch(:environment_label, "#{Rails.env.capitalize} Environment")
-  devnet = local_assigns.fetch(:devnet, false)
+  preview           = local_assigns.fetch(:preview, false)
+  devnet            = local_assigns.fetch(:devnet, false)
+  extra             = Array(local_assigns.fetch(:extra, []))
+  qa_environment    = Studio.qa_environment?
+
+  # On QA the devnet fact belongs in the message (the chip's contrast is built
+  # for the dev strip); everywhere else it stays a chip beside the buttons.
+  message_extra     = devnet && qa_environment ? extra + ["Devnet"] : extra
+  show_devnet_chip  = devnet && !qa_environment
+
+  environment_label = local_assigns.fetch(:environment_label) do
+    Studio.environment_banner_message(extra: message_extra)
+  end
 %>
 
-<% actions = capture do %>
-  <% if devnet %>
-    <span class="rounded" style="font-size:10px; font-weight:700; padding:1px 6px; background:rgba(0,0,0,0.2);">DEVNET</span>
+<% if !preview && Studio.show_environment_banner? %>
+  <% actions = capture do %>
+    <% if show_devnet_chip %>
+      <span class="rounded" style="font-size:10px; font-weight:700; padding:1px 6px; background:rgba(0,0,0,0.2);">DEVNET</span>
+    <% end %>
+    <%= render "studio/banners/dev_mode_button" %>
+    <%= render "studio/banners/email_status_button" %>
   <% end %>
-  <%= render "studio/banners/dev_mode_button" %>
-  <%= render "studio/banners/email_status_button" %>
-<% end %>
 
-<%= render "studio/banners/app_banner",
-           tone: :environment,
-           density: :normal,
-           message: environment_label,
-           actions: actions %>
+  <%= render "studio/banners/app_banner",
+             tone: :environment,
+             density: :normal,
+             message: environment_label,
+             actions: actions %>
+<% end %>

data/lib/studio/environment_banner.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Studio
+  # The shared dev/QA environment banner's decisions, as pure Ruby.
+  #
+  # Every Studio app used to hand-roll its own yellow "<Env> Environment" strip,
+  # so no two agreed on when it appeared, what it said, or whether it linked the
+  # local email inbox. Those three rules live here and `studio/banners/_environment`
+  # renders them, so a host adopts the standard with one `render` call.
+  #
+  # Dependency-free on purpose: the unit suite requires this file directly, so
+  # the tests exercise the SHIPPED rules rather than a copy of them.
+  module EnvironmentBanner
+    QA_ENV_VAR = "QA_ENV"
+
+    # The engine's local email inbox (Studio::LocalEmailsController).
+    INBOX_PATH = "/_studio/local_emails"
+
+    module_function
+
+    # True for stable QA apps. They run Rails in production mode but are
+    # non-production REVIEW targets and must say so. The release conductor sets
+    # QA_ENV=true on every QA app (mcritchie-studio/config/qa_environments.yml).
+    def qa_environment?(env = ENV)
+      truthy?(env[QA_ENV_VAR])
+    end
+
+    # Show the banner in every environment EXCEPT real production. A QA app is
+    # Rails-production but not real production, so QA_ENV re-opens it there.
+    def show?(rails_env:, qa_environment: qa_environment?)
+      return true unless rails_env.to_s == "production"
+
+      qa_environment
+    end
+
+    # "Development Environment" · "QA Environment · Non-production", plus any
+    # app-supplied suffix ("Devnet", ...).
+    def message(rails_env:, qa_environment: qa_environment?, extra: [])
+      head = if qa_environment
+               ["QA Environment", "Non-production"]
+             else
+               ["#{rails_env.to_s.capitalize} Environment"]
+             end
+
+      (head + present_parts(extra)).join(" · ")
+    end
+
+    def present_parts(extra)
+      Array(extra).map(&:to_s).reject { |part| part.strip.empty? }
+    end
+
+    def truthy?(value)
+      %w[1 true yes on].include?(value.to_s.strip.downcase)
+    end
+  end
+end

data/lib/studio/sidebar_sections.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Resolves Studio.sidebar_sections — the host's declared link-sidebar data —
+# for a given view context. Pure Ruby (no Rails dependency) so the unit suite
+# exercises the resolution rules without booting the dummy app.
+#
+# Declared sections may be a static Array or a callable (receives the view
+# context) for dynamic data: route helpers, logged_in? walls, model-backed
+# link lists. Each section normalizes to symbol keys:
+#
+#   { title: "Site", admin: true, links: [
+#     { label: "Dashboard", href: "/admin", emoji: "📊",
+#       hover_emoji: "🔬", desc: "Users + logs", target: "_blank" } ] }
+#
+# Sections flagged admin: true resolve only for admin? viewers, so the
+# trigger and panel stay invisible to everyone else even when the host
+# declares nothing but admin links.
+module Studio
+  module SidebarSections
+    module_function
+
+    def resolve(declared, view)
+      sections = declared.respond_to?(:call) ? declared.call(view) : declared
+      admin = view.respond_to?(:admin?) && view.admin?
+      Array(sections).map { |section| symbolize(section) }
+                     .reject { |section| section[:admin] && !admin }
+                     .map { |section| section.merge(links: Array(section[:links]).map { |link| symbolize(link) }) }
+    end
+
+    def symbolize(hash)
+      hash.to_h.each_with_object({}) { |(key, value), out| out[key.to_sym] = value }
+    end
+  end
+end

data/lib/studio/version.rb

@@ -1,3 +1,3 @@
 module Studio
-  VERSION = "0.29.1"
+  VERSION = "0.30.0"
 end

data/lib/studio.rb

@@ -1,8 +1,10 @@
 require "studio/version"
 require "studio/engine"
 require "studio/color_scale"
+require "studio/environment_banner"
 require "studio/theme_resolver"
 require "studio/ui_primitives"
+require "studio/sidebar_sections"
 require "studio/username_generator"
 require "studio/s3"
 require "studio/image_cache"
@@ -61,6 +63,23 @@ module Studio
   # feature off (e.g. McRitchie Studio, which ships neither).
   mattr_accessor :features, default: []
 
+  # ---- Sidebar navigation ----
+  # Out-of-the-box navigation: the engine navbar mounts a link-sidebar trigger
+  # and slide-out panel when the host declares sections here. The default []
+  # renders NOTHING, so existing consumers see no change on upgrade until they
+  # opt in. Accepts a static Array of section hashes or a callable (receives
+  # the view context) for dynamic sections — route helpers, logged_in? walls.
+  # Sections flagged admin: true render only for admin? viewers. Shape and
+  # resolution rules: lib/studio/sidebar_sections.rb.
+  #
+  #   Studio.configure do |config|
+  #     config.sidebar_sections = ->(view) {
+  #       [ { title: "Site", links: [
+  #             { label: "Home", href: view.root_path, emoji: "🏠" } ] } ]
+  #     }
+  #   end
+  mattr_accessor :sidebar_sections, default: []
+
   # Magic-link (passwordless email) tuning. token_name keys the MessageVerifier
   # purpose; bump it to invalidate every outstanding link. See MagicLink service.
   mattr_accessor :magic_link_ttl,        default: 15.minutes
@@ -238,6 +257,40 @@ module Studio
     env_truthy?(ENV["LOCAL_EMAIL_CAPTURE"]) || env_truthy?(ENV["AGENT_WORKTREE"])
   end
 
+  # ---- Shared environment banner ------------------------------------------
+  # Rules live in Studio::EnvironmentBanner (pure Ruby, unit-tested); these are
+  # the Rails-aware entry points `studio/banners/_environment` calls. A host
+  # renders that ONE partial instead of hand-rolling its own strip.
+
+  # True for a stable QA app: Rails-production, but a non-production review
+  # target that must identify itself as one. Keyed off QA_ENV, the signal the
+  # release conductor already sets on every QA app.
+  def self.qa_environment?
+    EnvironmentBanner.qa_environment?
+  end
+
+  def self.show_environment_banner?(rails_env: rails_env_name)
+    EnvironmentBanner.show?(rails_env: rails_env, qa_environment: qa_environment?)
+  end
+
+  def self.environment_banner_message(rails_env: rails_env_name, extra: [])
+    EnvironmentBanner.message(rails_env: rails_env, qa_environment: qa_environment?, extra: extra)
+  end
+
+  # Whether the local email inbox is actually REACHABLE for this request, which
+  # is the only honest reason to render a link to it. Deliberately the same
+  # gate the controller enforces (local_tool_enabled?), so the banner can never
+  # advertise a page that answers 404 — QA gets a status chip instead.
+  def self.local_inbox_reachable?(request_local:)
+    local_tool_enabled?(request_local: request_local)
+  end
+
+  def self.rails_env_name
+    return "development" unless defined?(Rails) && Rails.respond_to?(:env)
+
+    Rails.env.to_s
+  end
+
   def self.user_wallet_address(user)
     return nil unless user
 
@@ -278,7 +331,7 @@ module Studio
 
       See the USER_CONTRACT.md doc in the studio-engine repo for the full
       contract + a minimal compliant example:
-        https://github.com/amcritchie/studio-engine/blob/main/docs/USER_CONTRACT.md
+        https://github.com/McRitchie-Studio/studio-engine/blob/main/docs/USER_CONTRACT.md
 
       To bypass this check temporarily, set Studio.validate_user_contract = false
       in config/initializers/studio.rb.
@@ -309,6 +362,13 @@ module Studio
     entry ? "/#{entry[:file]}" : nil
   end
 
+  # Sidebar sections resolved for a view context: a callable config is called
+  # with the view, keys symbolize, and admin-only sections drop for non-admin
+  # viewers. Rendering gates on `.any?`, so [] keeps the navbar untouched.
+  def self.sidebar_sections_for(view)
+    SidebarSections.resolve(sidebar_sections, view)
+  end
+
   def self.env_truthy?(value)
     %w[1 true yes on].include?(value.to_s.strip.downcase)
   end

data/studio-engine.gemspec

@@ -7,15 +7,15 @@ Gem::Specification.new do |spec|
   spec.email       = ["studio-engine@mcritchie.studio"]
   spec.summary     = "Shared Rails engine providing auth, SSO, error logging, theming, and S3-backed image caching"
   spec.description = "Studio Engine is a non-isolated Rails engine that ships an opinionated authentication + SSO contract, a polymorphic ErrorLog model, a Sluggable concern, a 7-role dynamic theme system with CSS-custom-property generation, and an S3-backed ImageCache. Used in production across the McRitchie Studio + Turf Monster apps."
-  spec.homepage    = "https://github.com/amcritchie/studio-engine"
+  spec.homepage    = "https://github.com/McRitchie-Studio/studio-engine"
   spec.license     = "MIT"
   spec.required_ruby_version = ">= 3.0"
 
   spec.metadata = {
-    "homepage_uri"    => "https://github.com/amcritchie/studio-engine",
-    "source_code_uri" => "https://github.com/amcritchie/studio-engine/tree/main",
-    "bug_tracker_uri" => "https://github.com/amcritchie/studio-engine/issues",
-    "changelog_uri"   => "https://github.com/amcritchie/studio-engine/blob/main/CHANGELOG.md"
+    "homepage_uri"    => "https://github.com/McRitchie-Studio/studio-engine",
+    "source_code_uri" => "https://github.com/McRitchie-Studio/studio-engine/tree/main",
+    "bug_tracker_uri" => "https://github.com/McRitchie-Studio/studio-engine/issues",
+    "changelog_uri"   => "https://github.com/McRitchie-Studio/studio-engine/blob/main/CHANGELOG.md"
   }
 
   spec.files = Dir["lib/**/*", "app/**/*", "config/**/*", "db/**/*", "tailwind/**/*", "Gemfile", "studio-engine.gemspec", "README.md", "CHANGELOG.md", "LICENSE"]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.29.1
+  version: 0.30.0
 platform: ruby
 authors:
 - Alex McRitchie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-31 00:00:00.000000000 Z
+date: 2026-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -201,6 +201,7 @@ files:
 - app/controllers/theme_settings_controller.rb
 - app/helpers/studio/admin_models_table_helper.rb
 - app/helpers/studio_email_delivery_helper.rb
+- app/helpers/studio_sidebar_helper.rb
 - app/helpers/studio_theme_helper.rb
 - app/jobs/error_log_cleanup_job.rb
 - app/jobs/studio/email_delivery_job.rb
@@ -232,7 +233,10 @@ files:
 - app/views/components/_google_logo.html.erb
 - app/views/components/_input.html.erb
 - app/views/components/_json_debug.html.erb
+- app/views/components/_link_sidebar.html.erb
+- app/views/components/_link_sidebar_trigger.html.erb
 - app/views/components/_progress_bar.html.erb
+- app/views/components/_sidebar_panel.html.erb
 - app/views/components/_theme_toggle.html.erb
 - app/views/components/_theme_toggle_morph.html.erb
 - app/views/components/_user_nav.html.erb
@@ -330,11 +334,13 @@ files:
 - lib/studio/email.rb
 - lib/studio/email_smoke.rb
 - lib/studio/engine.rb
+- lib/studio/environment_banner.rb
 - lib/studio/image_cache.rb
 - lib/studio/link_token.rb
 - lib/studio/mail_transport.rb
 - lib/studio/redis.rb
 - lib/studio/s3.rb
+- lib/studio/sidebar_sections.rb
 - lib/studio/theme_resolver.rb
 - lib/studio/ui_primitives.rb
 - lib/studio/username_generator.rb
@@ -343,14 +349,14 @@ files:
 - lib/tasks/studio_ses.rake
 - studio-engine.gemspec
 - tailwind/studio.tailwind.config.js
-homepage: https://github.com/amcritchie/studio-engine
+homepage: https://github.com/McRitchie-Studio/studio-engine
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/amcritchie/studio-engine
-  source_code_uri: https://github.com/amcritchie/studio-engine/tree/main
-  bug_tracker_uri: https://github.com/amcritchie/studio-engine/issues
-  changelog_uri: https://github.com/amcritchie/studio-engine/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/McRitchie-Studio/studio-engine
+  source_code_uri: https://github.com/McRitchie-Studio/studio-engine/tree/main
+  bug_tracker_uri: https://github.com/McRitchie-Studio/studio-engine/issues
+  changelog_uri: https://github.com/McRitchie-Studio/studio-engine/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths: