plutonium 0.56.2 → 0.57.0

data/docs/.vitepress/theme/components/HomeCta.vue

@@ -21,7 +21,7 @@
       </div>
 
       <div class="hc-term-wrap">
-        <pre class="pu-term hc-term"><span class="prompt">$</span> rails new my_app -m {{ activeUrl }}<span class="pu-term-cursor"></span></pre>
+        <pre class="pu-term hc-term"><span class="prompt">$</span> {{ activeCommand }}<span class="pu-term-cursor"></span></pre>
         <button class="hc-copy" :class="{ 'hc-copy--ok': copied }" @click="copy" :title="copied ? 'Copied' : 'Copy command'" :aria-label="copied ? 'Copied' : 'Copy command'">
           <component :is="copied ? IconCheck : IconCopy" :size="16" :stroke-width="2" />
         </button>
@@ -49,7 +49,7 @@ const options = [
 ]
 const selected = ref("plutonium")
 const activeUrl = computed(() => options.find(o => o.id === selected.value).url)
-const activeCommand = computed(() => `rails new my_app -m ${activeUrl.value}`)
+const activeCommand = computed(() => `rails new my_app -a propshaft -j esbuild -c tailwind -m ${activeUrl.value}`)
 const copied = ref(false)
 
 async function copy() {

data/docs/public/templates/base.rb

@@ -10,5 +10,5 @@ after_bundle do
   generate "pu:core:install"
 
   git add: "."
-  git commit: %( -m 'install plutonium' )
+  git commit: %( -m 'chore: install plutonium' )
 end

data/docs/public/templates/lite.rb

@@ -2,51 +2,51 @@ after_bundle do
   # SQLite infrastructure (replaces Redis/Postgres for simple deployments)
   generate "pu:lite:setup"
   git add: "."
-  git commit: %( -m 'setup sqlite') if `git status --porcelain`.present?
+  git commit: %( -m 'chore: setup sqlite') if `git status --porcelain`.present?
 
   generate "pu:lite:tune"
   git add: "."
-  git commit: %( -m 'tune sqlite pragmas') if `git status --porcelain`.present?
+  git commit: %( -m 'chore: tune sqlite pragmas') if `git status --porcelain`.present?
 
   unless ENV["SKIP_SOLID_QUEUE"]
     generate "pu:lite:solid_queue"
     git add: "."
-    git commit: %( -m 'add solid_queue') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add solid_queue') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_SOLID_CACHE"]
     generate "pu:lite:solid_cache"
     git add: "."
-    git commit: %( -m 'add solid_cache') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add solid_cache') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_SOLID_CABLE"]
     generate "pu:lite:solid_cable"
     git add: "."
-    git commit: %( -m 'add solid_cable') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add solid_cable') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_SOLID_ERRORS"]
     generate "pu:lite:solid_errors"
     git add: "."
-    git commit: %( -m 'add solid_errors') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add solid_errors') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_LITESTREAM"]
     generate "pu:lite:litestream"
     git add: "."
-    git commit: %( -m 'add litestream') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add litestream') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_RAILS_PULSE"]
     generate "pu:lite:rails_pulse"
     git add: "."
-    git commit: %( -m 'add rails_pulse') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add rails_pulse') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_SQLITE_MAINTENANCE"]
     generate "pu:lite:maintenance"
     git add: "."
-    git commit: %( -m 'add sqlite maintenance job') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add sqlite maintenance job') if `git status --porcelain`.present?
   end
 end

data/docs/public/templates/plutonium.rb

@@ -1,6 +1,6 @@
 after_bundle do
   # We just installed Rails, let's create a commit
-  git(add: ".") && git(commit: %( -m 'initial commit' ))
+  git(add: ".") && git(commit: %( -m 'chore: initial commit' ))
 
   # Run the base install
   template_location = if ENV["LOCAL"]
@@ -12,20 +12,23 @@ after_bundle do
 
   # Add development tools
   generate "pu:gem:dotenv"
-  git(add: ".") && git(commit: %( -m 'add dotenv' ))
+  git(add: ".") && git(commit: %( -m 'chore: add dotenv' ))
 
   generate "pu:gem:annotated"
-  git(add: ".") && git(commit: %( -m 'add annotate' ))
+  git(add: ".") && git(commit: %( -m 'chore: add annotate' ))
 
   generate "pu:gem:standard"
-  git(add: ".") && git(commit: %( -m 'add standardrb' ))
+  git(add: ".") && git(commit: %( -m 'chore: add standardrb' ))
 
   generate "pu:gem:letter_opener"
-  git(add: ".") && git(commit: %( -m 'add letter_opener' ))
+  git(add: ".") && git(commit: %( -m 'chore: add letter_opener' ))
 
   generate "pu:gem:actual_db_schema"
-  git(add: ".") && git(commit: %( -m 'add actual_db_schema' ))
+  git(add: ".") && git(commit: %( -m 'chore: add actual_db_schema' ))
 
   generate "pu:core:assets"
-  git(add: ".") && git(commit: %( -m 'integrate assets' ))
+  git(add: ".") && git(commit: %( -m 'chore: integrate assets' ))
+
+  generate "pu:skills:sync"
+  git(add: ".") && git(commit: %( -m 'chore: sync plutonium skills' ))
 end

data/docs/reference/resource/query.md

@@ -214,6 +214,26 @@ When a default is set:
 - The default scope button is highlighted (not "All").
 - Clicking "All" shows the unscoped collection.
 
+### Conditional visibility — `condition:`
+
+Like `condition:` on [actions](./actions), a scope can be **defined but only render its button when a runtime proc is truthy**. The scope (and its URL) stays live either way — `condition:` only toggles the button.
+
+```ruby
+scope :admin_only,   condition: -> { current_user.admin? }
+scope :beta_feature, condition: -> { params[:beta] == "1" }
+
+# Expose a scope's URL (API/programmatic) without surfacing a button
+scope :internal, condition: -> { false }
+```
+
+The proc is evaluated against the view context so `current_user`, `params`, `request`, and `allowed_to?` are all available directly. There is no `object`/`record` — scopes have no single-record context.
+
+::: danger `condition:` is NOT authorization
+A hidden scope button still has a **live URL** anyone can navigate to. `condition:` decides whether the *button renders*, not whether the *records are accessible*.
+
+Use `condition:` for UI relevance ("show this tab to admins only"). Use the policy's `relation_scope` to restrict which records a user can see at all.
+:::
+
 ## Sorting
 
 ```ruby

data/gemfiles/rails_7.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.56.0)
+    plutonium (0.57.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 43.0)

data/gemfiles/rails_8.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.56.0)
+    plutonium (0.57.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 43.0)

data/gemfiles/rails_8.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.56.0)
+    plutonium (0.57.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 43.0)

data/lib/generators/pu/core/assets/assets_generator.rb

@@ -12,6 +12,7 @@ module Pu
       desc "Setup plutonium assets"
 
       def start
+        verify_prerequisites
         install_dependencies
         copy_tailwind_config
         configure_application
@@ -24,6 +25,22 @@ module Pu
 
       private
 
+      # The asset pipeline assumes the app was generated with esbuild + Tailwind.
+      # Without those, `application.tailwind.css` doesn't exist and the generator
+      # later crashes with a cryptic inject_into_file error. Fail early with a fix.
+      def verify_prerequisites
+        return if File.exist?("app/assets/stylesheets/application.tailwind.css")
+
+        error <<~MSG
+          Plutonium assets require a Rails app generated with esbuild and Tailwind.
+          Expected app/assets/stylesheets/application.tailwind.css, but it is missing.
+
+          Re-create the app with the required flags:
+            rails new myapp -a propshaft -j esbuild -c tailwind \\
+              -m https://radioactive-labs.github.io/plutonium-core/templates/plutonium.rb
+        MSG
+      end
+
       def copy_tailwind_config
         copy_file "tailwind.config.js", force: true
         copy_file "postcss.config.js", force: true

data/lib/plutonium/core/controllers/entity_scoping.rb

@@ -115,7 +115,10 @@ module Plutonium
         def remember_scoped_entity
           return unless scoped_to_entity?
 
-          session[scoped_entity_session_key] = current_scoped_entity.to_global_id.to_s
+          entity = current_scoped_entity
+          return unless entity
+
+          session[scoped_entity_session_key] = entity.to_global_id.to_s
         end
 
         # Retrieves the remembered scoped entity from the session.

data/lib/plutonium/resource/query_object.rb

@@ -31,9 +31,11 @@ module Plutonium
       #
       # @param name [Symbol] The name of the scope.
       # @param body [Proc, nil] The body of the scope.
-      def define_scope(name, body = nil, **)
+      # @param condition [Proc, nil] Display-only visibility gate (same semantics as condition: on actions).
+      def define_scope(name, body = nil, condition: nil, **)
         body ||= name
         scope_definitions[name] = build_query(body)
+        scope_conditions[name] = condition if condition
       end
 
       # Defines a sort with the given name and body.
@@ -118,6 +120,16 @@ module Plutonium
 
       def scope_definitions = @scope_definitions ||= {}.with_indifferent_access
 
+      def scope_conditions = @scope_conditions ||= {}.with_indifferent_access
+
+      # Display-only visibility gate for a scope, mirroring condition: on actions.
+      # Returns true when no condition is set.
+      def scope_visible?(name, view_context)
+        condition = scope_conditions[name]
+        return true if condition.nil?
+        Plutonium::Action::ConditionContext.new(view_context, nil).instance_exec(&condition)
+      end
+
       # Returns true if user explicitly selected "All" scope (no filtering)
       def all_scope_selected? = @all_scope_selected
 

data/lib/plutonium/ui/layout/base.rb

@@ -44,11 +44,12 @@ module Plutonium
         # preferences read from localStorage:
         # - Color mode: applies `dark` class on <html> so dark theme renders
         #   from the first frame instead of flashing light.
-        # - Rail-pin: applies `pu-rail-pinned` on <body> (when present) and
-        #   on every incoming body via turbo:before-render, so a
-        #   Turbo.visit (e.g. the redirect after a form submit) doesn't
-        #   flash the rail into its collapsed state before the
-        #   icon-rail Stimulus controller can restore it.
+        # - Rail-pin: the rail is pinned by default, so this applies
+        #   `pu-rail-pinned` on <body> (when present) and on every incoming
+        #   body via turbo:before-render unless the user explicitly collapsed
+        #   it (localStorage "false"), so a Turbo.visit (e.g. the redirect
+        #   after a form submit) doesn't flash the rail into its collapsed
+        #   state before the icon-rail Stimulus controller can restore it.
         def render_pre_paint_scripts
           script do
             raw(safe(<<~JS))
@@ -62,10 +63,10 @@ module Plutonium
                 } catch (e) {}
 
                 try {
-                  if (localStorage.getItem("pu_rail_pinned") !== "true") return;
+                  if (localStorage.getItem("pu_rail_pinned") === "false") return;
                   if (document.body) document.body.classList.add("pu-rail-pinned");
                   document.addEventListener("turbo:before-render", function (event) {
-                    if (localStorage.getItem("pu_rail_pinned") === "true") {
+                    if (localStorage.getItem("pu_rail_pinned") !== "false") {
                       event.detail.newBody.classList.add("pu-rail-pinned");
                     }
                   });

data/lib/plutonium/ui/layout/icon_rail.rb

@@ -39,7 +39,7 @@ module Plutonium
             id: "sidebar-navigation",
             data: {controller: "sidebar icon-rail"},
             aria: {label: "Sidebar Navigation"},
-            class: "fixed top-0 left-0 z-40 h-screen " \
+            class: "fixed top-0 left-0 z-40 h-dvh " \
                    "bg-[var(--pu-surface)] border-r border-[var(--pu-border)] " \
                    "flex flex-col transition-[width] duration-200 overflow-x-hidden " \
                    "-translate-x-full lg:translate-x-0"
@@ -54,7 +54,11 @@ module Plutonium
 
         def render_brand_section
           div(class: "h-12 flex items-center justify-center border-b border-[var(--pu-border)] shrink-0") do
-            render brand_slot if brand_slot?
+            next unless brand_slot?
+
+            a(href: root_path, aria: {label: "Home"}, class: "flex items-center justify-center") do
+              render brand_slot
+            end
           end
         end
 

data/lib/plutonium/ui/layout/sidebar.rb

@@ -18,7 +18,7 @@ module Plutonium
             data: {controller: "sidebar"},
             id: "sidebar-navigation",
             aria: {label: "Sidebar Navigation"},
-            class: "fixed top-0 left-0 z-40 w-64 h-screen pt-14 transition-transform -translate-x-full lg:translate-x-0"
+            class: "fixed top-0 left-0 z-40 w-64 h-dvh pt-14 transition-transform -translate-x-full lg:translate-x-0"
           ) do
             div(
               id: "sidebar-navigation-content",

data/lib/plutonium/ui/modal/slideover.rb

@@ -33,7 +33,7 @@ module Plutonium
           # showModal() and is dropped when the dialog leaves the top layer
           # on close(), so it still covers the panel's slide-out. Mirrors
           # the .pu-dialog::backdrop rule in components.css.
-          "fixed top-0 right-0 bottom-0 left-auto m-0 h-screen max-w-full max-h-screen " \
+          "fixed top-0 right-0 bottom-0 left-auto m-0 h-dvh max-w-full max-h-dvh " \
             "bg-[var(--pu-surface)] border-l border-[var(--pu-border)] " \
             "backdrop:bg-black/60 backdrop:backdrop-blur-sm " \
             "rounded-none p-0 " \

data/lib/plutonium/ui/table/components/scopes_bar.rb

@@ -14,6 +14,7 @@ module Plutonium
               div(class: "flex flex-wrap items-center gap-2") do
                 render_all_scope_button
                 current_query_object.scope_definitions.each_key do |name|
+                  next unless current_query_object.scope_visible?(name, view_context)
                   render_scope_button(name)
                 end
               end
@@ -60,7 +61,7 @@ module Plutonium
           end
 
           def render?
-            current_query_object.scope_definitions.present?
+            current_query_object.scope_definitions.any? { |name, _| current_query_object.scope_visible?(name, view_context) }
           end
         end
       end

data/lib/plutonium/ui/table/components/scopes_pills.rb

@@ -10,7 +10,8 @@ module Plutonium
 
             nav(role: "tablist",
               aria: {label: "Scope"},
-              class: "flex items-center gap-1 px-4 py-2 border-b border-[var(--pu-border)]") do
+              class: "flex flex-nowrap items-center gap-1 px-4 py-2 border-b border-[var(--pu-border)] " \
+                     "overflow-x-auto whitespace-nowrap [scrollbar-width:none] [&::-webkit-scrollbar]:hidden") do
               render_all_pill
               scopes.each_key { |key| render_pill(key) }
             end
@@ -43,7 +44,7 @@ module Plutonium
           end
 
           def pill_classes(active)
-            base = "px-3 py-1 rounded-md text-sm transition-colors"
+            base = "shrink-0 px-3 py-1 rounded-md text-sm transition-colors"
             state = if active
               "bg-primary-100 text-primary-700 dark:bg-primary-950/40 dark:text-primary-300"
             else
@@ -58,7 +59,7 @@ module Plutonium
           end
 
           def scopes
-            @scopes ||= current_query_object.scope_definitions
+            @scopes ||= current_query_object.scope_definitions.select { |name, _| current_query_object.scope_visible?(name, view_context) }
           end
         end
       end

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.56.2"
+  VERSION = "0.57.0"
   NEXT_MAJOR_VERSION = VERSION.split(".").tap { |v|
     v[1] = v[1].to_i + 1
     v[2] = 0

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radioactive-labs/plutonium",
-  "version": "0.56.2",
+  "version": "0.57.0",
   "description": "Build production-ready Rails apps in minutes, not days. Convention-driven, fully customizable, AI-ready.",
   "type": "module",
   "main": "src/js/core.js",

data/src/css/components.css

@@ -780,8 +780,11 @@ body.pu-rail-pinned .icon-rail-pin-expand {
   box-shadow: var(--pu-shadow-lg);
   padding: 6px;
   animation: pu-rail-flyout-in 120ms ease-out;
-  /* Cap to the viewport so long menus scroll instead of overflowing. */
+  /* Cap to the viewport so long menus scroll instead of overflowing.
+     dvh tracks the visible viewport so the cap holds on mobile (where
+     100vh sits behind the browser chrome); 100vh is the fallback. */
   max-height: calc(100vh - 16px);
+  max-height: calc(100dvh - 16px);
   overflow-y: auto;
   overscroll-behavior: contain;
 }

data/src/js/controllers/icon_rail_controller.js

@@ -9,10 +9,9 @@ export default class extends Controller {
   }
 
   connect() {
-    const pinned = localStorage.getItem(this.storageKeyValue) === "true"
-    if (pinned) {
-      document.body.classList.add("pu-rail-pinned")
-    }
+    // Pinned is the default; only an explicit "false" collapses the rail.
+    const pinned = localStorage.getItem(this.storageKeyValue) !== "false"
+    document.body.classList.toggle("pu-rail-pinned", pinned)
   }
 
   togglePin() {

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.56.2
+  version: 0.57.0
 platform: ruby
 authors:
 - Stefan Froelich
 bindir: exe
 cert_chain: []
-date: 2026-06-05 00:00:00.000000000 Z
+date: 2026-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk