railspress-engine 0.1.2 → 1.2.0

data/app/views/railspress/admin/shared/_image_section_editor.html.erb

@@ -0,0 +1,171 @@
+<%#
+  Image Section Editor
+  ====================
+  Expanded focal point editor with its own form.
+  Loads via Turbo Frame, saves independently of parent form.
+
+  All actions (Change, Remove, Save) submit to the focal_points controller
+  to avoid nested form issues.
+
+  Required locals:
+    record - The record with HasFocalPoint concern
+    attachment_name - Symbol for the attachment (e.g., :header_image)
+
+  Optional locals:
+    label - Section label (default: "Main Image")
+    contexts - Hash of context configs for previews
+    error_message - Error message to display
+%>
+
+<% label ||= "Main Image" %>
+<% contexts ||= Railspress.image_contexts %>
+<% error_message ||= nil %>
+<% attachment = record.send(attachment_name) %>
+<% focal_point = record.focal_point(attachment_name) %>
+<% focal_point_record = record.send("#{attachment_name}_focal_point") %>
+<% frame_id = dom_id(record, "image_section_#{attachment_name}") %>
+
+<%# Build cancel URL based on record type %>
+<%
+  if record.is_a?(Railspress::Post)
+    cancel_url = image_editor_admin_post_path(record, attachment: attachment_name, compact: true)
+  elsif record.is_a?(Railspress::ContentElement)
+    cancel_url = image_editor_admin_content_element_path(record, compact: true)
+  else
+    entity_type = record.class.railspress_config.route_key
+    cancel_url = admin_entity_image_editor_path(entity_type: entity_type, id: record.id, attachment: attachment_name, compact: true)
+  end
+%>
+
+<%= content_tag "turbo-frame", id: frame_id do %>
+  <div class="rp-image-section">
+    <div class="rp-image-section__label">
+      <label class="rp-label"><%= label %></label>
+    </div>
+
+    <% if error_message %>
+      <div class="rp-flash rp-flash--error" style="margin-bottom: var(--rp-space-sm);">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" width="16" height="16">
+          <circle cx="12" cy="12" r="10"/>
+          <line x1="15" y1="9" x2="9" y2="15"/>
+          <line x1="9" y1="9" x2="15" y2="15"/>
+        </svg>
+        <%= error_message %>
+      </div>
+    <% end %>
+
+    <div class="rp-image-section__details">
+      <%# Single form for all actions - submits to focal_points controller %>
+      <%= form_with model: focal_point_record,
+                    url: admin_focal_point_path(focal_point_record),
+                    method: :patch,
+                    multipart: true,
+                    data: {
+                      controller: "railspress--focal-point",
+                      railspress__focal_point_x_value: focal_point[:x],
+                      railspress__focal_point_y_value: focal_point[:y]
+                    },
+                    class: "rp-image-section__editor" do |form| %>
+
+        <div class="rp-image-section__editor-header">
+          <span class="rp-image-section__editor-title"><%= label %> Settings</span>
+          <div class="rp-image-section__editor-actions">
+            <%# Change image - file input that auto-submits %>
+            <label class="rp-btn rp-btn--outline rp-btn--sm">
+              Change
+              <%= file_field_tag :image, accept: "image/*", class: "rp-sr-only", onchange: "this.form.submit()" %>
+            </label>
+
+            <%# Remove image - button that sets hidden field and submits %>
+            <button type="button"
+                    class="rp-btn rp-btn--outline rp-btn--sm rp-btn--danger"
+                    onclick="if(confirm('Remove this image?')) { this.form.querySelector('[name=remove_image]').value = '1'; this.form.submit(); }">
+              Remove
+            </button>
+            <%= hidden_field_tag :remove_image, "0" %>
+
+            <%= link_to "Cancel", cancel_url,
+                  class: "rp-btn rp-btn--outline rp-btn--sm",
+                  data: { turbo_frame: frame_id } %>
+            <%= form.submit "Save",
+                  class: "rp-btn rp-btn--primary rp-btn--sm" %>
+          </div>
+        </div>
+
+        <div class="rp-image-section__editor-body">
+          <div class="rp-focal-editor__layout">
+            <%# Source image with crosshair %>
+            <div class="rp-focal-editor__source">
+              <div class="rp-focal-editor__image-wrap"
+                   data-action="click->railspress--focal-point#pick
+                                touchstart->railspress--focal-point#touch
+                                keydown->railspress--focal-point#keydown"
+                   tabindex="0">
+                <% if attachment.attached? %>
+                  <%= image_tag main_app.url_for(attachment.variant(resize_to_limit: [1200, 800])),
+                        data: { railspress__focal_point_target: "image" },
+                        class: "rp-focal-editor__image",
+                        alt: "Source image for focal point selection" %>
+                <% end %>
+                <div data-railspress--focal-point-target="crosshair"
+                     class="rp-focal-editor__crosshair"
+                     style="left: <%= focal_point[:x] * 100 %>%; top: <%= focal_point[:y] * 100 %>%;"></div>
+              </div>
+
+              <div class="rp-focal-editor__hint">
+                <span>Click to set focal point</span>
+                <span class="rp-focal-editor__coords" data-railspress--focal-point-target="coordsDisplay">
+                  <%= "#{(focal_point[:x] * 100).round}%, #{(focal_point[:y] * 100).round}%" %>
+                </span>
+              </div>
+
+              <div class="rp-focal-editor__actions">
+                <button type="button"
+                        class="rp-btn rp-btn--outline rp-btn--sm"
+                        data-action="railspress--focal-point#reset">
+                  Reset to Center
+                </button>
+              </div>
+            </div>
+
+            <%# Live previews %>
+            <% if contexts.any? %>
+              <div class="rp-focal-editor__previews">
+                <span class="rp-focal-editor__previews-title">Live Preview</span>
+
+                <% contexts.each do |name, config| %>
+                  <% aspect = config[:aspect] %>
+                  <% aspect_ratio = aspect.is_a?(Array) ? "#{aspect[0]} / #{aspect[1]}" : aspect %>
+                  <% ratio_label = aspect.is_a?(Array) ? "#{aspect[0]}:#{aspect[1]}" : aspect.to_s %>
+
+                  <div class="rp-focal-editor__preview">
+                    <div class="rp-focal-editor__preview-image" style="aspect-ratio: <%= aspect_ratio %>;">
+                      <% if attachment.attached? %>
+                        <%= image_tag main_app.url_for(attachment.variant(resize_to_limit: [400, 300])),
+                              data: { railspress__focal_point_target: "preview" },
+                              style: record.image_css_for(name, attachment_name),
+                              alt: "#{name.to_s.titleize} preview" %>
+                      <% end %>
+                    </div>
+                    <div class="rp-focal-editor__preview-label">
+                      <span class="rp-focal-editor__preview-name"><%= name.to_s.titleize %></span>
+                      <span class="rp-focal-editor__preview-ratio"><%= ratio_label %></span>
+                    </div>
+                  </div>
+                <% end %>
+              </div>
+            <% end %>
+          </div>
+
+          <%# Hidden inputs for focal point values %>
+          <%= form.hidden_field :focal_x,
+                value: focal_point[:x],
+                data: { railspress__focal_point_target: "xInput" } %>
+          <%= form.hidden_field :focal_y,
+                value: focal_point[:y],
+                data: { railspress__focal_point_target: "yInput" } %>
+        </div>
+      <% end %>
+    </div>
+  </div>
+<% end %>

data/app/views/railspress/admin/shared/_image_section_v2.html.erb

@@ -0,0 +1,205 @@
+<%#
+  Image Section V2 Partial
+  ========================
+  Improved image section with Stimulus-powered expand/collapse.
+  Located in main column (not sidebar) with better UX.
+
+  Required locals:
+    has_image - Boolean, whether an image is attached
+
+  Optional locals (when has_image is true):
+    image_url - URL of the image to display
+    filename - Original filename
+    filesize - Human-readable file size
+    focal_point - Hash with :x and :y (0.0-1.0)
+    contexts - Hash of context configs for previews
+
+  Optional locals (for form integration):
+    form - Rails form builder (enables form fields)
+    record - The record with HasFocalPoint concern
+    attachment_name - Symbol for the attachment (e.g., :header_image)
+
+  Optional locals (always):
+    label - Section label (default: "Main Image")
+%>
+
+<% label ||= "Main Image" %>
+<% contexts ||= {} %>
+<% focal_point ||= { x: 0.5, y: 0.5 } %>
+<% has_form = local_assigns[:form].present? %>
+<% attachment_name ||= :header_image %>
+<% focal_point_record = has_form && local_assigns[:record] ? record.send("#{attachment_name}_focal_point") : nil %>
+
+<div class="rp-image-section-v2"
+     data-controller="railspress--image-section"
+     data-railspress--image-section-expanded-value="false">
+
+  <%# Header row with label and action %>
+  <div class="rp-image-section-v2__header">
+    <label class="rp-label"><%= label %></label>
+    <% if local_assigns[:has_image] %>
+      <button type="button"
+              class="rp-btn rp-btn--outline rp-btn--sm"
+              data-railspress--image-section-target="editButton"
+              data-action="railspress--image-section#toggle">
+        Edit
+      </button>
+    <% end %>
+  </div>
+
+  <% if local_assigns[:has_image] %>
+    <%# Compact view (shown when collapsed) %>
+    <div class="rp-image-section-v2__compact"
+         data-railspress--image-section-target="compact"
+         data-action="click->railspress--image-section#expand">
+      <div class="rp-image-section-v2__thumb">
+        <img src="<%= image_url %>"
+             style="object-position: <%= focal_point[:x] * 100 %>% <%= focal_point[:y] * 100 %>%;"
+             alt="">
+      </div>
+      <div class="rp-image-section-v2__info">
+        <span class="rp-image-section-v2__filename"><%= filename %></span>
+        <span class="rp-image-section-v2__meta"><%= filesize %></span>
+        <% if focal_point[:x] != 0.5 || focal_point[:y] != 0.5 %>
+          <span class="rp-image-section-v2__focal-indicator">
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" width="14" height="14">
+              <circle cx="12" cy="12" r="3"/>
+              <path d="M12 2v4m0 12v4m10-10h-4M6 12H2"/>
+            </svg>
+            Focal point set
+          </span>
+        <% end %>
+      </div>
+    </div>
+
+    <%# Expanded editor (hidden by default) %>
+    <div class="rp-image-section-v2__editor"
+         data-railspress--image-section-target="editor"
+         hidden>
+      <div class="rp-image-section-v2__editor-header">
+        <span class="rp-image-section-v2__editor-title"><%= label %> Settings</span>
+        <div class="rp-image-section-v2__editor-actions">
+          <% if has_form %>
+            <label class="rp-btn rp-btn--outline rp-btn--sm">
+              Change
+              <%= form.file_field attachment_name,
+                    accept: "image/*",
+                    class: "rp-sr-only",
+                    direct_upload: true %>
+            </label>
+            <label class="rp-btn rp-btn--outline rp-btn--sm">
+              <%= form.check_box :"remove_#{attachment_name}", { class: "rp-sr-only" }, "1", "0" %>
+              Remove
+            </label>
+          <% else %>
+            <button type="button" class="rp-btn rp-btn--outline rp-btn--sm">Change</button>
+            <button type="button" class="rp-btn rp-btn--outline rp-btn--sm">Remove</button>
+          <% end %>
+          <button type="button"
+                  class="rp-btn rp-btn--primary rp-btn--sm"
+                  data-action="railspress--image-section#collapse">
+            Done
+          </button>
+        </div>
+      </div>
+
+      <div class="rp-image-section-v2__editor-body">
+        <%# Focal point editor %>
+        <div class="rp-focal-editor"
+             data-controller="railspress--focal-point"
+             data-railspress--focal-point-x-value="<%= focal_point[:x] %>"
+             data-railspress--focal-point-y-value="<%= focal_point[:y] %>">
+
+          <div class="rp-focal-editor__layout">
+            <%# Source image with crosshair %>
+            <div class="rp-focal-editor__source">
+              <div class="rp-focal-editor__image-wrap"
+                   data-action="click->railspress--focal-point#pick
+                                touchstart->railspress--focal-point#touch"
+                   tabindex="0"
+                   data-action="keydown->railspress--focal-point#keydown">
+                <img src="<%= image_url %>"
+                     data-railspress--focal-point-target="image"
+                     class="rp-focal-editor__image"
+                     alt="Source image for focal point selection">
+                <div data-railspress--focal-point-target="crosshair"
+                     class="rp-focal-editor__crosshair"
+                     style="left: <%= focal_point[:x] * 100 %>%; top: <%= focal_point[:y] * 100 %>%;"></div>
+              </div>
+
+              <div class="rp-focal-editor__hint">
+                <span>Click to set focal point</span>
+                <span class="rp-focal-editor__coords" data-railspress--focal-point-target="coordsDisplay">
+                  <%= "#{(focal_point[:x] * 100).round}%, #{(focal_point[:y] * 100).round}%" %>
+                </span>
+              </div>
+
+              <div class="rp-focal-editor__actions">
+                <button type="button"
+                        class="rp-btn rp-btn--outline rp-btn--sm"
+                        data-action="railspress--focal-point#reset">
+                  Reset to Center
+                </button>
+              </div>
+            </div>
+
+            <%# Live previews %>
+            <% if contexts.any? %>
+              <div class="rp-focal-editor__previews">
+                <span class="rp-focal-editor__previews-title">Live Preview</span>
+
+                <% contexts.each do |name, config| %>
+                  <% aspect = config[:aspect] %>
+                  <% aspect_ratio = aspect.is_a?(Array) ? "#{aspect[0]} / #{aspect[1]}" : aspect %>
+                  <% ratio_label = aspect.is_a?(Array) ? "#{aspect[0]}:#{aspect[1]}" : aspect.to_s %>
+
+                  <div class="rp-focal-editor__preview">
+                    <div class="rp-focal-editor__preview-image" style="aspect-ratio: <%= aspect_ratio %>;">
+                      <img src="<%= image_url %>"
+                           data-railspress--focal-point-target="preview"
+                           style="object-position: <%= focal_point[:x] * 100 %>% <%= focal_point[:y] * 100 %>%;"
+                           alt="<%= name.to_s.titleize %> preview">
+                    </div>
+                    <div class="rp-focal-editor__preview-label">
+                      <span class="rp-focal-editor__preview-name"><%= name.to_s.titleize %></span>
+                      <span class="rp-focal-editor__preview-ratio"><%= ratio_label %></span>
+                    </div>
+                  </div>
+                <% end %>
+              </div>
+            <% end %>
+          </div>
+
+          <%# Hidden inputs for form submission %>
+          <% if has_form && focal_point_record %>
+            <%= form.fields_for "#{attachment_name}_focal_point_attributes", focal_point_record do |fp_form| %>
+              <%= fp_form.hidden_field :focal_x, data: { railspress__focal_point_target: "inputX" } %>
+              <%= fp_form.hidden_field :focal_y, data: { railspress__focal_point_target: "inputY" } %>
+            <% end %>
+          <% end %>
+        </div>
+      </div>
+    </div>
+
+  <% else %>
+    <%# No image - show dropzone %>
+    <% if has_form %>
+      <%= render "railspress/admin/shared/dropzone",
+            form: form,
+            field_name: attachment_name,
+            prompt: "Click to upload #{label.downcase}" %>
+    <% else %>
+      <div class="rp-image-section-v2__dropzone">
+        <svg class="rp-image-section-v2__dropzone-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5">
+          <rect x="3" y="3" width="18" height="18" rx="2" ry="2"/>
+          <circle cx="8.5" cy="8.5" r="1.5"/>
+          <polyline points="21 15 16 10 5 21"/>
+        </svg>
+        <p class="rp-image-section-v2__dropzone-text">
+          <strong>Click to upload</strong> or drag and drop<br>
+          <span class="rp-hint">PNG, JPG, WebP up to 10MB</span>
+        </p>
+      </div>
+    <% end %>
+  <% end %>
+</div>

data/app/views/railspress/admin/shared/_sidebar.html.erb

@@ -1,5 +1,17 @@
 <div class="rp-sidebar-content">
-  <h1 class="rp-logo">RailsPress</h1>
+  <div class="rp-sidebar-header">
+    <h1 class="rp-logo">RailsPress</h1>
+    <button class="rp-sidebar-toggle" aria-label="Toggle sidebar">
+      <svg class="rp-sidebar-toggle-icon rp-sidebar-toggle-icon--collapse" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <polyline points="11 17 6 12 11 7"/>
+        <polyline points="18 17 13 12 18 7"/>
+      </svg>
+      <svg class="rp-sidebar-toggle-icon rp-sidebar-toggle-icon--expand" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <polyline points="13 17 18 12 13 7"/>
+        <polyline points="6 17 11 12 6 7"/>
+      </svg>
+    </button>
+  </div>
 
   <nav class="rp-nav">
     <%= link_to railspress.admin_root_path, class: "rp-nav-link #{current_page?(railspress.admin_root_path) ? 'rp-nav-link--active' : ''}" do %>
@@ -7,7 +19,7 @@
         <path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/>
         <polyline points="9 22 9 12 15 12 15 22"/>
       </svg>
-      Dashboard
+      <span class="rp-nav-text">Dashboard</span>
     <% end %>
 
     <%= link_to railspress.admin_posts_path, class: "rp-nav-link #{controller_name == 'posts' ? 'rp-nav-link--active' : ''}" do %>
@@ -17,14 +29,14 @@
         <line x1="16" y1="13" x2="8" y2="13"/>
         <line x1="16" y1="17" x2="8" y2="17"/>
       </svg>
-      Posts
+      <span class="rp-nav-text">Posts</span>
     <% end %>
 
     <%= link_to railspress.admin_categories_path, class: "rp-nav-link #{controller_name == 'categories' ? 'rp-nav-link--active' : ''}" do %>
       <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
         <path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/>
       </svg>
-      Categories
+      <span class="rp-nav-text">Categories</span>
     <% end %>
 
     <%= link_to railspress.admin_tags_path, class: "rp-nav-link #{controller_name == 'tags' ? 'rp-nav-link--active' : ''}" do %>
@@ -32,7 +44,63 @@
         <path d="M20.59 13.41l-7.17 7.17a2 2 0 0 1-2.83 0L2 12V2h10l8.59 8.59a2 2 0 0 1 0 2.82z"/>
         <line x1="7" y1="7" x2="7.01" y2="7"/>
       </svg>
-      Tags
+      <span class="rp-nav-text">Tags</span>
+    <% end %>
+
+    <% if Railspress.cms_enabled? %>
+      <div class="rp-nav-divider"></div>
+
+      <%= link_to railspress.admin_content_groups_path, class: "rp-nav-link #{controller_name == 'content_groups' ? 'rp-nav-link--active' : ''}" do %>
+        <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <rect x="2" y="2" width="20" height="8" rx="2" ry="2"/>
+          <rect x="2" y="14" width="20" height="8" rx="2" ry="2"/>
+        </svg>
+        <span class="rp-nav-text">Content Groups</span>
+      <% end %>
+
+      <%= link_to railspress.admin_content_elements_path, class: "rp-nav-link #{controller_name == 'content_elements' ? 'rp-nav-link--active' : ''}" do %>
+        <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <polyline points="4 7 4 4 20 4 20 7"/>
+          <line x1="9" y1="20" x2="15" y2="20"/>
+          <line x1="12" y1="4" x2="12" y2="20"/>
+        </svg>
+        <span class="rp-nav-text">Content Elements</span>
+      <% end %>
+
+      <%= link_to railspress.admin_cms_transfer_path, class: "rp-nav-link #{controller_name == 'cms_transfers' ? 'rp-nav-link--active' : ''}" do %>
+        <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path d="M12 3v6m0 0l3-3m-3 3L9 6"/>
+          <path d="M12 21v-6m0 0l3 3m-3-3l-3 3"/>
+          <rect x="3" y="9" width="18" height="6" rx="2"/>
+        </svg>
+        <span class="rp-nav-text">CMS Transfer</span>
+      <% end %>
+    <% end %>
+
+    <% if Railspress.registered_entities.any? %>
+      <div class="rp-nav-divider"></div>
+
+      <% Railspress.registered_entities.each do |route_key, config| %>
+        <%= link_to railspress.admin_entity_index_path(entity_type: route_key),
+            class: "rp-nav-link #{controller_name == 'entities' && params[:entity_type] == route_key ? 'rp-nav-link--active' : ''}" do %>
+          <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <rect x="3" y="3" width="18" height="18" rx="2" ry="2"/>
+            <line x1="3" y1="9" x2="21" y2="9"/>
+            <line x1="9" y1="21" x2="9" y2="9"/>
+          </svg>
+          <span class="rp-nav-text"><%= config.label %></span>
+        <% end %>
+      <% end %>
+    <% end %>
+
+    <div class="rp-nav-divider"></div>
+    <%= link_to "/", class: "rp-nav-link" do %>
+      <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <circle cx="12" cy="12" r="10"/>
+        <line x1="2" y1="12" x2="22" y2="12"/>
+        <path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/>
+      </svg>
+      <span class="rp-nav-text">Main Site</span>
     <% end %>
   </nav>
 </div>

data/app/views/railspress/admin/tags/index.html.erb

@@ -1,11 +1,6 @@
 <% content_for :title, "Tags" %>
 
-<div class="rp-page-header">
-  <h1 class="rp-page-title">Tags</h1>
-  <div class="rp-page-actions">
-    <%= link_to "New Tag", new_admin_tag_path, class: "rp-btn rp-btn--primary" %>
-  </div>
-</div>
+<%= rp_page_header "Tags", "New Tag" => new_admin_tag_path %>
 
 <div class="rp-card">
   <% if @tags.any? %>
@@ -13,10 +8,10 @@
       <table class="rp-table">
         <thead>
           <tr>
-            <th>Name</th>
-            <th>Slug</th>
-            <th>Posts</th>
-            <th class="rp-table-actions">Actions</th>
+            <th><%= rp_table_header("Name") %></th>
+            <th><%= rp_table_header("Slug") %></th>
+            <th><%= rp_table_header("Usage") %></th>
+            <th class="rp-table-actions"><%= rp_table_header("Actions") %></th>
           </tr>
         </thead>
         <tbody>
@@ -24,12 +19,13 @@
             <tr>
               <td class="rp-table-primary"><%= tag.name %></td>
               <td class="rp-table-secondary"><%= tag.slug %></td>
-              <td><%= tag.posts.count %></td>
+              <td><%= tag.taggings.count %></td>
               <td class="rp-table-actions">
-                <%= link_to "Edit", edit_admin_tag_path(tag), class: "rp-link" %>
-                <%= button_to "Delete", admin_tag_path(tag), method: :delete,
-                    data: { turbo_confirm: "Delete this tag?" },
-                    class: "rp-link rp-link--danger" %>
+                <%= rp_table_action_icons(
+                      edit_path: edit_admin_tag_path(tag),
+                      delete_path: admin_tag_path(tag),
+                      confirm: "Delete this tag?"
+                    ) %>
               </td>
             </tr>
           <% end %>
@@ -37,6 +33,6 @@
       </table>
     </div>
   <% else %>
-    <p class="rp-empty-state">No tags yet. <%= link_to "Create your first tag", new_admin_tag_path, class: "rp-link" %>.</p>
+    <%= rp_empty_state "No tags yet.", link_text: "Create your first tag", link_path: new_admin_tag_path %>
   <% end %>
 </div>

data/config/brakeman.ignore

@@ -0,0 +1,18 @@
+{
+  "ignored_warnings": [
+    {
+      "fingerprint": "63b49bb226efb52aff46bf077f8feded65c3d627b29de6ee403b37d2b08cfe23",
+      "note": "Attachment name is validated against entity_config.fields before use"
+    },
+    {
+      "fingerprint": "bb7ad80d40c0237746aced9b06bdfc144d6e3052b53647f09b1738005326de38",
+      "note": "Attachment name is validated in entities_controller#image_editor before rendering this partial"
+    },
+    {
+      "fingerprint": "1d94979921177aefb3064de87b6032a5f2760ef30946a52e3015b54af6150e35",
+      "note": "Attachment name is validated in entities_controller#image_editor before rendering this partial"
+    }
+  ],
+  "updated": "2026-02-14",
+  "brakeman_version": "8.0.2"
+}

data/config/importmap.rb

@@ -0,0 +1,23 @@
+# RailsPress Engine Importmap Configuration
+#
+# This file is automatically loaded by host applications using importmap-rails.
+#
+# Usage in host app (add to app/javascript/application.js):
+#
+#   import "railspress"
+#
+# This auto-registers all RailsPress Stimulus controllers.
+
+# Lexxy rich text editor (hard dependency — auto-pinned so host apps don't need to)
+pin "lexxy", to: "lexxy.js"
+
+# Turbo for Turbo Frames support
+pin "@hotwired/turbo-rails", to: "turbo.min.js"
+
+# Main entry point - auto-registers all controllers
+pin "railspress", to: "railspress/index.js"
+
+# Individual controllers (for advanced use cases)
+pin_all_from Railspress::Engine.root.join("app/javascript/railspress/controllers"),
+             under: "railspress/controllers",
+             to: "railspress/controllers"

data/config/routes.rb

@@ -4,6 +4,67 @@ Railspress::Engine.routes.draw do
     root "dashboard#index"
     resources :categories, except: [ :show ]
     resources :tags, except: [ :show ]
-    resources :posts
+
+    # Content Element CMS (opt-in via config.enable_cms)
+    if Railspress.cms_enabled?
+      resources :content_groups
+      resources :content_elements do
+        member do
+          get :inline
+          get :image_editor
+        end
+      end
+      resources :content_element_versions, only: [ :show ]
+
+      # CMS Content Transfer (export/import)
+      resource :cms_transfer, only: [ :show ] do
+        post :export, on: :member
+        post :import, on: :member
+      end
+    end
+
+    resources :posts do
+      member do
+        get "image_editor/:attachment", action: :image_editor, as: :image_editor
+      end
+    end
+
+    # Standalone focal point updates (works outside parent form)
+    resources :focal_points, only: [ :update ]
+    resources :imports, only: [ :create ] do
+      collection do
+        get ":type", action: :show, as: :typed
+      end
+    end
+    resources :exports, only: [ :create ] do
+      collection do
+        get ":type", action: :show, as: :typed
+      end
+      member do
+        get :download
+      end
+    end
+
+    # UI/UX Prototypes (development only)
+    resources :prototypes, only: [] do
+      collection do
+        get :image_section
+      end
+    end
+
+    # Dynamic entity routes for host-defined CMS models
+    scope "entities" do
+      scope ":entity_type", constraints: ->(req) { Railspress.entity_registered?(req.params[:entity_type]) } do
+        get "/", to: "entities#index", as: :entity_index
+        get "/new", to: "entities#new", as: :new_entity
+        post "/", to: "entities#create"
+        get "/:id", to: "entities#show", as: :entity
+        get "/:id/edit", to: "entities#edit", as: :edit_entity
+        get "/:id/image_editor/:attachment", to: "entities#image_editor", as: :entity_image_editor
+        patch "/:id", to: "entities#update"
+        put "/:id", to: "entities#update"
+        delete "/:id", to: "entities#destroy"
+      end
+    end
   end
 end

data/db/migrate/20241218000004_create_railspress_post_tags.rb

@@ -7,6 +7,6 @@ class CreateRailspressPostTags < ActiveRecord::Migration[8.0]
       t.timestamps
     end
 
-    add_index :railspress_post_tags, [:post_id, :tag_id], unique: true
+    add_index :railspress_post_tags, [ :post_id, :tag_id ], unique: true
   end
 end