Version 0.1.4

Author: Job Hammer

CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.1.4] - 2026-03-23
+
+- Improve visual editor and settings admin UX
+- Update sidebar branding to use the new RubyCMS logo
+- Refresh README with project logo
+
 ## [0.1.3] - 2026-03-23
 
 - Update analytics pages (dashboard/detail views)

README.md

@@ -1,5 +1,7 @@
 # RubyCMS
 
+![RubyCMS logo](docs/assets/ruby_cms_logo.png)
+
 Reusable Rails engine for a CMS-style admin: permissions, admin UI shell, content blocks, and a visual editor.
 
 Vision: your app owns product features (pages, models, business logic); RubyCMS manages content workflows and admin screens.

app/assets/images/ruby_cms/logo.png

@@ -22,7 +22,7 @@ def page_preview
         return render_invalid_page unless template
 
         load_preview_data(@page_key)
-        render template: template, layout: "ruby_cms/minimal"
+        render template: template, layout: "admin/minimal"
       end
 
       def quick_update
@@ -186,7 +186,13 @@ def available_pages
         pages = {}
         add_config_pages(pages)
         add_auto_detected_pages(pages) if pages.empty?
-        pages
+        prioritize_home_page(pages)
+      end
+
+      def prioritize_home_page(pages)
+        return pages unless pages.key?("home")
+
+        { "home" => pages["home"] }.merge(pages.except("home"))
       end
 
       def add_auto_detected_pages(pages)
@@ -273,7 +279,10 @@ def skip_directory?(dir_name, relative_path)
         %w[
           layouts shared mailers components
           admin
-        ].include?(dir_name) || relative_path.start_with?("admin")
+        ].include?(dir_name) ||
+          dir_name.end_with?("_mailer") ||
+          dir_name.end_with?("_mailers") ||
+          relative_path.start_with?("admin")
       end
 
       def depth_exceeded?(relative_path)

app/controllers/ruby_cms/admin/visual_editor_controller.rb

@@ -3,10 +3,11 @@
   <div class="px-5 py-5 flex-shrink-0 bg-[#FAF9F5]">
     <div class="flex items-center gap-3" data-ruby-cms--mobile-menu-target="sidebarContent">
       <% if respond_to?(:image_tag, true) %>
-        <div class="w-7 h-7 flex-shrink-0 rounded-sm bg-gray-900 flex items-center justify-center text-white font-bold text-sm">
-          <% if respond_to?(:main_app, true) && main_app.respond_to?(:image_path) %>
-            <%= image_tag main_app.image_path("logo.png"), alt: "Logo", onerror: "this.style.display='none'", class: "w-full h-full object-contain" rescue nil %>
-          <% end %>
+        <div class="w-9 h-9 flex-shrink-0 rounded-md bg-white border border-gray-200 overflow-hidden">
+          <%= image_tag "ruby_cms/logo.png",
+                        alt: "RubyCMS logo",
+                        class: "w-full h-full object-contain",
+                        onerror: "this.style.display='none'; this.parentElement.classList.add('bg-gray-900','text-white','font-bold','text-xs','flex','items-center','justify-center'); this.parentElement.innerHTML='R';" %>
         </div>
       <% end %>
       <p class="text-base font-semibold text-gray-900 m-0">RubyCMS</p>

app/views/layouts/ruby_cms/_admin_sidebar.html.erb

@@ -22,10 +22,10 @@
 
 <%# Single card: category rail | separator | content (Todoist-like) %>
 <div class="rounded-2xl border border-border bg-card shadow-sm ring-1 ring-black/[0.03] overflow-hidden">
-  <div class="flex flex-col lg:flex-row lg:min-h-[min(100vh-12rem,52rem)]">
+  <div class="flex flex-col lg:flex-row lg:h-[min(100vh-12rem,64rem)]">
     <%# Left: sections (icons from TAB_CONFIG) %>
     <aside class="shrink-0 border-b border-border lg:w-56 lg:border-b-0 lg:border-r bg-muted/25">
-      <div class="p-3 sm:p-4">
+      <div class="p-3 sm:p-4 lg:h-full lg:overflow-y-auto">
         <p class="mb-3 text-[11px] font-semibold uppercase tracking-wider text-muted-foreground">
           <%= t("ruby_cms.admin.settings.categories_title", default: "Sections") %>
         </p>
@@ -50,7 +50,7 @@
     </aside>
 
     <%# Right: active section %>
-    <div class="flex min-w-0 flex-1 flex-col bg-background">
+    <div class="flex min-w-0 flex-1 flex-col bg-background min-h-0">
       <% tab_description = settings_tab_description(@active_tab) %>
 
       <div class="border-b border-border/80 px-5 py-4 sm:px-6 sm:py-5">
@@ -88,7 +88,7 @@
         <% end %>
       </div>
 
-      <div class="flex flex-1 flex-col px-5 py-5 sm:px-6 sm:py-6">
+      <div class="flex flex-1 flex-col px-5 py-5 sm:px-6 sm:py-6 min-h-0 overflow-y-auto">
         <% if is_navigation %>
           <% if nav_sub == "order" %>
             <%= form_with url: settings_url, method: :patch, local: true, html: { id: "nav_order_form", class: "flex flex-1 flex-col space-y-6", data: { turbo: false } } do %>

app/views/ruby_cms/admin/settings/index.html.erb

@@ -5,16 +5,29 @@
     <!-- Header -->
     <div class="flex flex-wrap items-center justify-between gap-4">
       <h1 class="text-lg font-semibold tracking-tight text-gray-900">Visual Editor</h1>
-      <%= form_with url: ruby_cms_admin_visual_editor_path, method: :get, class: "flex items-center gap-2", data: { turbo: false } do %>
+      <%= form_with url: ruby_cms_admin_visual_editor_path, method: :get, class: "flex items-center gap-2", data: { turbo: false, controller: "visual-editor-page-select" } do %>
         <%= hidden_field_tag :edit_mode, @edit_mode %>
 
         <% if @available_pages && @available_pages.size > 1 %>
-          <%= select_tag(
-            :page,
-            options_for_select(@available_pages.map { |k, v| [v[:name], k] }, @current_page),
-            class: "h-9 rounded-md border border-gray-200 bg-white px-3 text-sm shadow-sm focus:outline-none focus:ring-2 focus:ring-teal-200",
-            onchange: "this.form.requestSubmit()"
-          ) %>
+          <% selected_page_name = @available_pages.dig(@current_page, :name) || @current_page.to_s.humanize %>
+          <%= Select(class: "min-w-56") do %>
+            <%= SelectInput(name: :page, value: @current_page, data: { action: "change->visual-editor-page-select#submit" }) %>
+            <%= SelectTrigger(class: "h-9 bg-white font-medium") do %>
+              <%= SelectValue(placeholder: selected_page_name) { selected_page_name } %>
+            <% end %>
+            <%= SelectContent do %>
+              <%= SelectGroup do %>
+                <% @available_pages.each do |key, page| %>
+                    <% is_selected = key.to_s == @current_page.to_s %>
+                    <%= SelectItem(
+                      value: key,
+                      aria_selected: is_selected.to_s,
+                      class: (is_selected ? "bg-primary/10 text-primary ring-1 ring-primary/20" : nil)
+                    ) { page[:name] } %>
+                <% end %>
+              <% end %>
+            <% end %>
+          <% end %>
         <% else %>
           <%= hidden_field_tag :page, @current_page %>
         <% end %>

app/views/ruby_cms/admin/visual_editor/index.html.erb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyCms
-  VERSION = "0.1.3.1"
+  VERSION = "0.1.4"
 end