plutonium 0.49.1 → 0.50.0

data/docs/superpowers/plans/2026-05-07-ui-layout-overhaul.md.tasks.json

@@ -0,0 +1,103 @@
+{
+  "planPath": "docs/superpowers/plans/2026-05-07-ui-layout-overhaul.md",
+  "tasks": [
+    {
+      "id": 7,
+      "subject": "Task 0: Density tokens",
+      "status": "pending",
+      "description": "**Goal:** Codify balanced density scale.\n\n```json:metadata\n{\"files\":[\"src/css/tokens.css\",\"src/css/components.css\",\"lib/plutonium/ui/component/tokens.rb\"],\"verifyCommand\":\"yarn build && bundle exec appraisal rails-8.1 rake test\",\"acceptanceCriteria\":[\"density vars defined\",\"button/input sizes updated\",\"card padding 16px\",\"tests pass\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 8,
+      "subject": "Task 1: PageHeader redesign (Stripe-style)",
+      "status": "pending",
+      "blockedBy": [7],
+      "description": "**Goal:** Tighter Stripe-style PageHeader.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/page_header.rb\",\"lib/plutonium/ui/page/base.rb\",\"test/plutonium/ui/page_header_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/ui/page_header_test.rb -v\",\"acceptanceCriteria\":[\"title 18-20px\",\"description muted\",\"actions right-aligned\",\"tabs flush\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 9,
+      "subject": "Task 2: IconRail component",
+      "status": "pending",
+      "blockedBy": [7],
+      "description": "**Goal:** 56px icon-only nav.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/layout/icon_rail.rb\",\"test/plutonium/ui/layout/icon_rail_test.rb\",\"src/css/components.css\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/ui/layout/icon_rail_test.rb -v\",\"acceptanceCriteria\":[\"aside 56px\",\"slots present\",\"active styling\",\"mobile-hidden\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 10,
+      "subject": "Task 3: Topbar component",
+      "status": "pending",
+      "blockedBy": [7],
+      "description": "**Goal:** Sticky 48px topbar.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/layout/topbar.rb\",\"lib/plutonium/ui/breadcrumbs.rb\",\"test/plutonium/ui/layout/topbar_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/ui/layout/topbar_test.rb -v\",\"acceptanceCriteria\":[\"48px height\",\"breadcrumbs/search/actions slots\",\"hamburger wired\",\"empty-breadcrumbs handled\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 11,
+      "subject": "Task 4: Wire ResourceLayout to new shell",
+      "status": "pending",
+      "blockedBy": [9, 10],
+      "description": "**Goal:** Replace partials with IconRail+Topbar; drop legacy.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/layout/resource_layout.rb\",\"lib/plutonium/ui/layout/base.rb\",\"lib/plutonium/ui/layout/header.rb\",\"lib/plutonium/ui/layout/sidebar.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 rake test\",\"acceptanceCriteria\":[\"new shell wired\",\"old partials removed\",\"tests pass\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 12,
+      "subject": "Task 5: Index toolbar",
+      "status": "pending",
+      "blockedBy": [7, 8],
+      "description": "**Goal:** New Toolbar component (view switcher, filter, group, search, column-config, overflow).\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/table/components/toolbar.rb\",\"lib/plutonium/ui/table/components/view_switcher.rb\",\"lib/plutonium/ui/table/resource.rb\",\"test/plutonium/ui/table/components/toolbar_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/ui/table/components/toolbar_test.rb -v\",\"acceptanceCriteria\":[\"toolbar order\",\"search wired\",\"filter popover\",\"disabled segments\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 13,
+      "subject": "Task 6: Active filter pills + result count",
+      "status": "pending",
+      "blockedBy": [12],
+      "description": "**Goal:** Removable filter pills + result count strip.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/table/components/filter_pills.rb\",\"lib/plutonium/ui/table/resource.rb\",\"lib/plutonium/resource/query_object.rb\",\"test/plutonium/ui/table/components/filter_pills_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/ui/table/components/filter_pills_test.rb -v\",\"acceptanceCriteria\":[\"pill per filter\",\"add-filter pill\",\"clear URL\",\"result count\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 14,
+      "subject": "Task 7: Column-header sort with multi-sort + ⋯ menu",
+      "status": "pending",
+      "blockedBy": [12],
+      "description": "**Goal:** Sort in column headers, shift-click multi-sort, per-column ⋯ menu.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/resource/query_object.rb\",\"lib/plutonium/ui/table/resource.rb\",\"lib/plutonium/ui/table/theme.rb\",\"src/js/controllers/table_controller.js\",\"test/plutonium/resource/query_object_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/resource/query_object_test.rb -v\",\"acceptanceCriteria\":[\"sort_params_for has multi_url\",\"click vs shift-click\",\"priority badges\",\"column menu\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 15,
+      "subject": "Task 8: Floating bulk action bar",
+      "status": "pending",
+      "blockedBy": [13],
+      "description": "**Goal:** Bulk action bar replaces pills strip when rows selected.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/table/components/bulk_action_bar.rb\",\"lib/plutonium/ui/table/resource.rb\",\"src/js/controllers/bulk_actions_controller.js\",\"test/plutonium/ui/table/components/bulk_action_bar_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/ui/table/components/bulk_action_bar_test.rb -v\",\"acceptanceCriteria\":[\"bar/pills mutual exclusion\",\"selection count\",\"danger tone\",\"clear deselect\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 16,
+      "subject": "Task 9: Show page redesign",
+      "status": "pending",
+      "blockedBy": [8],
+      "description": "**Goal:** Single-column show + reserved aside slot.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/page/show.rb\",\"lib/plutonium/ui/page/base.rb\",\"lib/plutonium/ui/display/resource.rb\",\"lib/plutonium/ui/panel.rb\",\"test/plutonium/ui/page/show_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/ui/page/show_test.rb -v\",\"acceptanceCriteria\":[\"max-width 960\",\"card panels\",\"aside slot reserved\",\"tabs flush\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 17,
+      "subject": "Task 10: Form page redesign + sticky footer",
+      "status": "pending",
+      "blockedBy": [8],
+      "description": "**Goal:** Centered narrow form column + sticky footer + inline validation.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/ui/page/new.rb\",\"lib/plutonium/ui/page/edit.rb\",\"lib/plutonium/ui/page/interactive_action.rb\",\"lib/plutonium/ui/form/resource.rb\",\"lib/plutonium/ui/form/interaction.rb\",\"lib/plutonium/ui/form/theme.rb\",\"lib/plutonium/ui/form/components/sticky_footer.rb\",\"test/plutonium/ui/form/sticky_footer_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/ui/form -v\",\"acceptanceCriteria\":[\"580px centered\",\"sticky footer\",\"inline validation\",\"modal mode skips footer\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 18,
+      "subject": "Task 11: Slideover modal mode + per-interaction option",
+      "status": "pending",
+      "blockedBy": [17],
+      "description": "**Goal:** Add slideover mode; opt-in via interactive_action :name, modal: :slideover.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/resource/interaction.rb\",\"lib/plutonium/interaction/base.rb\",\"src/js/controllers/remote_modal_controller.js\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/interaction -v\",\"acceptanceCriteria\":[\"modal: kwarg accepted\",\"two outer containers\",\"slideover transition\",\"mobile full-screen\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 19,
+      "subject": "Task 12: Per-resource modal declaration",
+      "status": "pending",
+      "blockedBy": [18],
+      "description": "**Goal:** modal :slideover on resource definition for new/edit modal mode.\n\n```json:metadata\n{\"files\":[\"lib/plutonium/resource/definition.rb\",\"test/plutonium/resource/definition_test.rb\"],\"verifyCommand\":\"bundle exec appraisal rails-8.1 ruby -Itest test/plutonium/resource/definition_test.rb -v\",\"acceptanceCriteria\":[\"modal DSL on definition\",\"invalid raises\",\"modal frame uses declared mode\",\"page URLs unchanged\"],\"requiresUserVerification\":false}\n```"
+    },
+    {
+      "id": 20,
+      "subject": "Task 13: Documentation + changelog",
+      "status": "pending",
+      "blockedBy": [16, 19],
+      "description": "**Goal:** Document overhaul; update skills.\n\n```json:metadata\n{\"files\":[\"docs/guides/ui-overhaul-2026.md\",\"CHANGELOG.md\",\".claude/skills/plutonium-views.md\"],\"verifyCommand\":\"yarn docs:build\",\"acceptanceCriteria\":[\"upgrade guide written\",\"skills updated\",\"changelog entry\",\"docs build passes\"],\"requiresUserVerification\":false}\n```"
+    }
+  ],
+  "lastUpdated": "2026-05-07"
+}

data/docs/superpowers/specs/2026-05-07-ui-layout-overhaul-design.md

@@ -0,0 +1,270 @@
+# Plutonium UI Layout Overhaul — Design Spec
+
+**Date:** 2026-05-07
+**Scope:** Visual + structural redesign of Plutonium's app shell, page header, index/show/form pages. Code-level component refactoring (slot APIs, hook reduction, partial-to-Phlex conversion) is intentionally out of scope here — this spec captures the *target UI* only. A separate refactor pass can re-architect the Phlex internals to deliver this target.
+
+## Goals
+
+1. Modernize the look and feel to match contemporary admin tools (Linear, Stripe Dashboard, Vercel, Plane).
+2. Increase information density without sacrificing scannability.
+3. Establish a coherent visual vocabulary across all four page types (index / show / form / interactive-action).
+4. Leave clean extension points for upcoming features (metadata side panel, view switchers).
+
+## Non-Goals
+
+- Theming / token rebuild (deferred — current `--pu-*` token system stays).
+- Component API consolidation (separate effort).
+- Mobile-first redesign (mobile must work, but desktop is the optimization target).
+- New colors / typography (use existing tokens unless a decision below requires a new one).
+
+---
+
+## 1. App Shell — Icon Rail + Topbar
+
+A narrow icon-only left rail plus a topbar replaces the current expanded sidebar.
+
+**Left rail**
+- Width: ~56px, fixed.
+- Icon-only nav items with tooltips on hover.
+- Top: brand mark / portal switcher.
+- Middle: primary nav (resources grouped by section, dividers between groups).
+- Bottom: settings, theme toggle.
+- Active item: filled background, primary tone.
+- Mobile (<lg breakpoint): rail collapses to hamburger drawer.
+
+**Topbar**
+- Height: ~48px, sticky.
+- Left: breadcrumbs (resource path; replaces in-content breadcrumbs).
+- Center: global search input (filled, ~360px max).
+- Right: notifications, user menu.
+
+**Removed**
+- Current expanded sidebar (240px) — labels now live in tooltips and breadcrumbs.
+- In-page breadcrumbs above title — moved to topbar.
+
+---
+
+## 2. Page Header — Stripe-Style
+
+Every page renders a unified header below the topbar.
+
+```
+┌────────────────────────────────────────────────────┐
+│ Customers                              [Cancel] [Save] │
+│ Manage customer accounts and contact details        │
+├────────────────────────────────────────────────────┤
+│ Overview │ Orders │ Invoices │ Activity            │
+└────────────────────────────────────────────────────┘
+```
+
+- Title: 18–20px, semibold.
+- Description: 13px, muted, optional, sits directly below title.
+- Actions: right-aligned at title's vertical level. Primary as filled button, secondary as outline. Overflow into a `⋯` dropdown after 2 visible actions.
+- Tabs: connected strip directly under header (no gap), 1px bottom border becomes the active-tab indicator's baseline.
+
+The header is uniform across index / show / form / interactive-action.
+
+---
+
+## 3. Index Page — Hybrid Toolbar + Pills + Column Sort
+
+### Toolbar (single 36-40px row above the table)
+
+Order, left to right:
+1. **View switcher** — segmented control (Grid / Cards / Kanban — Cards/Kanban are placeholders for now; only Grid is wired initially).
+2. Vertical divider.
+3. **Filter** button (popover).
+4. **Group** button (popover).
+5. Spacer (`flex-grow`).
+6. **Search input** — visible, ~220px wide, expands on focus.
+7. Vertical divider.
+8. **Column config** icon button (`⊞`).
+9. **Overflow** icon button (`⋯`) — exports, advanced options.
+
+The "Sort" button is intentionally absent — sort is column-driven (see below).
+
+### Active Filter Strip (below toolbar, only when filters are active)
+
+- Each active filter renders as a removable pill: `<field> <op> <value>` with `✕`.
+- After the last pill: `+ Filter` dashed pill that opens the same popover as the toolbar Filter button.
+- Right-aligned: result count (e.g., "147 results").
+
+### Table — Column-Header Sort
+
+- Click a column header: sorts asc → desc → none (cycles).
+- Shift-click: adds a secondary/tertiary sort (multi-sort).
+- Active sort columns show: arrow (↑/↓) + small priority badge (1, 2, 3) when more than one column is active.
+- Each header has a `⋯` menu: Sort asc / Sort desc / Clear sort / Group by / Filter by / Hide column.
+- Row height: 32px (balanced density). Header height: 32px.
+- Selection: leftmost column is a 12px checkbox.
+
+### Bulk Action Bar
+
+- Appears as a 36px strip *replacing* the active-filter strip when ≥1 row is selected.
+- Tinted background (primary-50 light / primary-950/30 dark).
+- Left: count + "Clear selection".
+- After spacer: action buttons (Export, Archive, Delete) — Delete uses danger tone.
+
+### Pagination Footer
+
+- Sticky-ish strip below the table.
+- Left: "Showing N–M of Total".
+- Right: prev / page indicator / next.
+
+---
+
+## 4. Show Page — Single Column + Tabs
+
+A single content column under the page header. Nested resources render as tabs.
+
+### Structure
+
+```
+PageHeader (title, description, actions, tab strip)
+└── content
+    ├── [Aside slot — empty by default; reserved]
+    └── Main column
+        ├── Field panel: Details
+        ├── Field panel: Address
+        └── ...
+```
+
+- Field panels: card-styled (1px border, radius-md, white surface) with uppercase 9px section labels.
+- Default content max-width: ~960px, centered if rail+topbar leaves wider area.
+- Tabs render nested resources (the existing tab strip mechanism).
+
+### Reserved Aside Slot (Future Hook)
+
+The page layout reserves a `render_aside` slot that is empty by default. A future `metadata` DSL on resource definitions will populate this slot:
+
+```ruby
+class CustomerDefinition < Plutonium::Resource::Definition
+  metadata do
+    field :status, badge: true
+    field :owner
+    field :created_at
+  end
+end
+```
+
+When populated, the aside renders as a 200–240px right side panel with a sticky 16px-padded background-`surface-alt` column. Implementation of the DSL itself is a separate task — this spec only requires the layout to leave room.
+
+---
+
+## 5. Form Page — Centered Narrow + Sticky Footer
+
+For new / edit / interactive-action.
+
+### Structure
+
+```
+PageHeader (title, description; no actions in header)
+└── content (max-width ~580px, centered)
+    ├── Card: Section 1 (uppercase 9px label + fields)
+    ├── Card: Section 2
+    └── ...
+StickyFooter (full width, right-aligned [Cancel] [Save])
+```
+
+- Form column max-width: 580px.
+- Card-style sections, same chrome as show-page panels.
+- Inline validation: errors render as 12px danger text directly under each field. No toasts for field-level errors. Toast/flash only for form-level outcomes.
+- Sticky footer: 56px tall, white surface, top border, sticks to viewport bottom when form scrolls.
+- Cancel: outline button. Save: primary filled button. Right-aligned.
+
+### Modal Variant
+
+The same form can render in a modal when triggered as a quick-create / quick-edit (e.g., `+ New` from an index toolbar that targets the remote modal frame, or a row-edit action):
+- No sticky footer; the modal's own footer bar holds Cancel / Save.
+- Internal layout otherwise identical (card sections, inline validation).
+- Modal mode (`:centered` vs `:slideover`) is configurable per resource definition — see §7.
+- Page-level new/edit URLs always render the full page form (§5); modal rendering is invoked via the modal turbo frame.
+
+---
+
+## 6. Density
+
+**Balanced (Stripe / Vercel-class)** as the framework default.
+
+| Token            | Value         |
+|------------------|---------------|
+| Table row height | 32px          |
+| Body text        | 14px          |
+| Section gap      | 16px          |
+| Field gap        | 12px          |
+| Button (md)      | 32px height, 14px text, 12px horizontal padding |
+| Button (sm)      | 28px, 13px, 10px |
+| Input height     | 36px (forms), 32px (toolbars) |
+| Card padding     | 16px          |
+| Page side padding | 24px         |
+
+These values become the canonical scale; spot-deviations are allowed but should be rare.
+
+---
+
+## 7. Modals — Both Modes, Per-Action Opt-In
+
+Two modal modes ship as siblings.
+
+### Default: Centered Dialog
+- Max-width 520px, max-height 80vh, centered, dimmed backdrop.
+- Header: dialog title + close (✕).
+- Body: form / content with internal scroll.
+- Footer: 56px strip, right-aligned [Cancel] [Confirm].
+- Use cases: short forms, confirmations, most interactive actions.
+
+### Opt-In: Right Slide-Over Panel
+- Slides in from right, full height, 480px wide on desktop, full-screen on mobile.
+- Header / body / footer same as centered.
+- Underlying list visible (dimmed); user keeps context.
+### Configuration
+
+**Per interaction** — defaults to `:centered`, opt into `:slideover`:
+```ruby
+interactive_action :reschedule, modal: :slideover
+interactive_action :archive   # implicit modal: :centered
+```
+
+**Per resource (for quick-create / quick-edit modals)** — definition declares the mode used when new/edit is rendered through the modal turbo frame:
+```ruby
+class CustomerDefinition < Plutonium::Resource::Definition
+  modal :slideover   # default :centered
+end
+```
+
+The page-level new/edit URLs always render the full §5 page layout. Whether `+ New` opens a modal or navigates to the page is a per-context call-site choice (e.g., index toolbar can target the modal frame for quick-create; a "Create customer" landing CTA navigates to the full page).
+
+Both modal modes share the same Phlex modal component; only the outer container varies.
+
+---
+
+## 8. Compatibility & Migration Notes
+
+- **`Layout::ResourceLayout`** currently uses Rails partials for `resource_header` / `resource_sidebar`. Conversion to Phlex is implicit in this work — the icon rail and topbar must be Phlex components.
+- **`Page::Base` hook explosion** (~12 before/after hooks) — most apps don't use these. The redesign assumes apps that override `render_breadcrumbs` etc. continue to work; new slot APIs are additive. Hook deprecation is a future cleanup.
+- **Existing CSS classes** — `.pu-input`, `.pu-btn`, `.pu-card` keep their names; sizes shift to the density table above. Apps that hard-code Tailwind utilities on top will need cosmetic touch-ups but no breakage.
+- **Breadcrumbs** — moving from in-page to topbar means `Plutonium::UI::Breadcrumbs` becomes a topbar component. The definition-level `breadcrumbs` toggle stays; "off" means hidden in topbar (or replaced with title only).
+
+---
+
+## 9. Out-of-Scope Followups (referenced, not designed here)
+
+- **Metadata DSL** for show-page side panel (§4).
+- **View switcher** wiring beyond Grid (Cards, Kanban) — placeholders in toolbar; implementation deferred.
+- **Code-level Phlex refactor** — slot API, hook reduction, asset registry — separate spec.
+- **Token / theme rebuild** — separate spec.
+
+---
+
+## 10. Acceptance Checklist
+
+- [ ] Icon rail (56px) replaces expanded sidebar; topbar adds breadcrumbs + search + user.
+- [ ] Page header is a single component (`PageHeader`) used by every page type, supporting title / description / actions / tabs.
+- [ ] Index page renders the toolbar in the order of §3 with no Sort button.
+- [ ] Active filters render as removable pills below the toolbar with a result count.
+- [ ] Column headers sort on click (asc/desc/none) with shift-click multi-sort and priority badges.
+- [ ] Bulk action bar replaces the filter strip when rows are selected.
+- [ ] Show page is single-column with tab strip; an empty aside slot is reserved.
+- [ ] Form pages use a 580px centered column with sticky footer; modal variant uses dialog footer.
+- [ ] Density tokens (§6) are codified in CSS / Phlex constants and used consistently.
+- [ ] Modal component supports both `:centered` (default) and `:slideover` via per-action / per-form opt-in.

data/gemfiles/rails_8.1.gemfile.lock

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

data/lib/generators/pu/core/install/templates/config/initializers/plutonium.rb

@@ -3,5 +3,6 @@
 Plutonium.configure do |config|
   config.load_defaults 1.0
 
+  config.shell = :modern
   # Configure plutonium above.
 end

data/lib/generators/pu/core/update/update_generator.rb

@@ -9,10 +9,14 @@ module Pu
 
       desc "Update Plutonium gem and npm package to the latest version"
 
+      SHELL_PIN_THRESHOLD = "0.49.1"
+
       def start
+        @previous_gem_version = installed_gem_version
         update_gem
         update_npm_package
         sync_skills_if_present
+        pin_shell_to_classic
       rescue => e
         exception "#{self.class} failed:", e
       end
@@ -26,6 +30,22 @@ module Pu
         Rails::Generators.invoke("pu:skills:sync", [], destination_root: Rails.root)
       end
 
+      # Pin the shell config to :classic on apps upgrading from a version
+      # that predates the shell change so the upgrade is invisible. Newer
+      # apps installed after the shell change get :modern from the install
+      # template and shouldn't be flipped.
+      def pin_shell_to_classic
+        return unless @previous_gem_version
+        return unless SemanticRange.satisfies?(@previous_gem_version, "<=#{SHELL_PIN_THRESHOLD}")
+
+        initializer = Rails.root.join("config", "initializers", "plutonium.rb")
+        return unless File.file?(initializer)
+        return if File.read(initializer).match?(/^\s*config\.shell\s*=/)
+
+        say_status :update, "Pinning Plutonium shell to :classic...", :green
+        configure_plutonium "config.shell = :classic"
+      end
+
       def update_gem
         say_status :update, "Updating plutonium gem...", :green
         run "bundle update plutonium"

data/lib/generators/pu/lite/rails_pulse/rails_pulse_generator.rb

@@ -70,21 +70,70 @@ module Pu
 
       def setup_recurring_tasks
         recurring_file = "config/recurring.yml"
-        return unless File.exist?(File.expand_path(recurring_file, destination_root))
+        full_path = File.expand_path(recurring_file, destination_root)
+        return unless File.exist?(full_path)
         return if file_includes?(recurring_file, "rails_pulse")
 
-        recurring_tasks = <<~YAML
+        content = File.read(full_path)
+        env_keys = %w[production development staging test]
+        env_scoped = content.lines.any? { |l| l.match?(/^(#{env_keys.join("|")}):\s*$/) }
 
+        if env_scoped
+          create_file recurring_file, inject_rails_pulse_under_envs(content, env_keys), force: true
+        else
+          append_to_file recurring_file, "\n" + rails_pulse_tasks_yaml(0)
+        end
+      end
+
+      def rails_pulse_tasks_yaml(indent)
+        pad = " " * indent
+        <<~YAML.gsub(/^(?=.)/, pad)
           rails_pulse_summary:
             class: RailsPulse::SummaryJob
-            schedule: "5 * * * *" # 5 minutes past every hour
+            queue: default
+            schedule: every hour at minute 5
+            description: "Roll up Rails Pulse raw records into summary tables"
 
           rails_pulse_cleanup:
             class: RailsPulse::CleanupJob
-            schedule: "0 1 * * *" # Daily at 1am
+            queue: default
+            schedule: every day at 1am
+            description: "Archive/purge old Rails Pulse data"
         YAML
+      end
+
+      def inject_rails_pulse_under_envs(content, env_keys)
+        lines = content.lines
+        env_re = /^(#{env_keys.join("|")}):\s*$/
+
+        env_starts = lines.each_with_index.select { |l, _| env_re.match?(l) }.map(&:last)
+
+        env_starts.reverse_each do |start|
+          end_idx = lines.length
+          ((start + 1)...lines.length).each do |i|
+            if lines[i].match?(/^[^\s#]/)
+              end_idx = i
+              break
+            end
+          end
+
+          indent = 2
+          ((start + 1)...end_idx).each do |i|
+            if (m = lines[i].match(/^(\s+)\S/))
+              indent = m[1].length
+              break
+            end
+          end
+
+          insert_at = end_idx
+          while insert_at > start + 1 && lines[insert_at - 1].strip.empty?
+            insert_at -= 1
+          end
+
+          lines.insert(insert_at, "\n", rails_pulse_tasks_yaml(indent))
+        end
 
-        append_to_file recurring_file, recurring_tasks
+        lines.join
       end
     end
   end

data/lib/plutonium/action/base.rb

@@ -16,7 +16,7 @@ module Plutonium
     # @attr_reader [Symbol, nil] category The category of the action.
     # @attr_reader [Integer] position The position of the action within its category.
     class Base
-      attr_reader :name, :label, :description, :icon, :route_options, :confirmation, :turbo, :turbo_frame, :color, :category, :position, :return_to
+      attr_reader :name, :label, :description, :icon, :route_options, :confirmation, :turbo, :turbo_frame, :color, :category, :position, :return_to, :modal
 
       # Initialize a new action.
       #
@@ -57,6 +57,8 @@ module Plutonium
         @resource_action = options[:resource_action] || false
         @category = ActiveSupport::StringInquirer.new((options[:category] || :secondary).to_s)
         @position = options[:position] || 50
+        @modal = options[:modal] || :centered
+        validate_modal!
 
         freeze
       end
@@ -85,8 +87,49 @@ module Plutonium
         policy.allowed_to?(:"#{name}?")
       end
 
+      # Returns a new Action with the given options merged over this one.
+      # Used by the resource definition to derive variants (e.g. dropping
+      # `turbo_frame` when `modal false` is configured) without mutating
+      # the frozen original.
+      def with(**overrides)
+        self.class.new(name, **to_options.merge(overrides))
+      end
+
+      protected
+
+      # Canonical representation for reconstruction via `with`. Every
+      # attribute set in `initialize` MUST appear here; otherwise
+      # `with(**overrides)` would silently drop it on round-trip.
+      # `category` is exposed as a Symbol since `initialize` re-wraps
+      # it in StringInquirer.
+      def to_options
+        {
+          label: @label,
+          description: @description,
+          icon: @icon,
+          color: @color,
+          confirmation: @confirmation,
+          route_options: @route_options,
+          turbo: @turbo,
+          turbo_frame: @turbo_frame,
+          return_to: @return_to,
+          bulk_action: @bulk_action,
+          collection_record_action: @collection_record_action,
+          record_action: @record_action,
+          resource_action: @resource_action,
+          category: @category.to_sym,
+          position: @position,
+          modal: @modal
+        }
+      end
+
       private
 
+      def validate_modal!
+        return if [:centered, :slideover].include?(@modal)
+        raise ArgumentError, "modal must be :centered or :slideover, got #{@modal.inspect}"
+      end
+
       # Build RouteOptions from the provided options
       #
       # @param [RouteOptions, Hash, nil] options The routing options

data/lib/plutonium/action/interactive.rb

@@ -22,7 +22,7 @@ module Plutonium
         options[:label] ||= interaction.label
         options[:description] ||= interaction.description
         options[:icon] ||= interaction.icon
-        options[:turbo_frame] = "remote_modal" unless options.key?(:turbo_frame)
+        options[:turbo_frame] = Plutonium::REMOTE_MODAL_FRAME unless options.key?(:turbo_frame)
 
         super(name, **options)
       end

data/lib/plutonium/configuration.rb

@@ -27,6 +27,9 @@ module Plutonium
     # @return [Float] the current defaults version
     attr_reader :defaults_version
 
+    # @return [Symbol] :classic (legacy Header/Sidebar) or :modern (Topbar/IconRail)
+    attr_accessor :shell
+
     # Map of version numbers to their default configurations
     VERSION_DEFAULTS = {
       1.0 => proc do |config|
@@ -48,6 +51,7 @@ module Plutonium
       @development = parse_boolean_env("PLUTONIUM_DEV")
       @cache_discovery = !Rails.env.development?
       @enable_hotreload = Rails.env.development?
+      @shell = :modern
     end
 
     # Load default configuration for a specific version

data/lib/plutonium/definition/actions.rb

@@ -32,6 +32,9 @@ module Plutonium
 
         # standard CRUD actions
 
+        # turbo_frame for :new and :edit is set by
+        # Resource::Definition.configure_crud_modal_targets! based on the
+        # `modal` config. Don't hard-code it here.
         action(:new, route_options: {action: :new},
           resource_action: true, category: :primary,
           icon: Phlex::TablerIcons::Plus, position: 10)

data/lib/plutonium/definition/base.rb

@@ -33,6 +33,8 @@ module Plutonium
       include Scoping
       include Search
       include NestedInputs
+      include Views
+      include Metadata
 
       class IndexPage < Plutonium::UI::Page::Index; end
 
@@ -48,6 +50,8 @@ module Plutonium
 
       class Table < Plutonium::UI::Table::Resource; end
 
+      class Grid < Plutonium::UI::Grid::Resource; end
+
       class Display < Plutonium::UI::Display::Resource; end
 
       class QueryForm < Plutonium::UI::Form::Query; end
@@ -114,6 +118,10 @@ module Plutonium
         self.class::Table
       end
 
+      def grid_class
+        self.class::Grid
+      end
+
       def detail_class
         self.class::Display
       end