plum-cms 0.1.2 → 0.2.1

data/app/views/plum/cp/entries/_form.html.erb

@@ -29,64 +29,90 @@
         </div>
 
         <!-- Dynamic fields based on blueprint -->
-        <div class="bg-white shadow rounded-lg p-6 space-y-6">
+        <div class="bg-white shadow rounded-lg p-6">
           <h3 class="text-lg font-medium text-gray-900">Content</h3>
+          <div class="mt-6 grid grid-cols-12 gap-6" data-controller="plum--conditional-fields">
           <% @content_type.fields.each do |field| %>
             <% field_handle = field["handle"].to_s %>
             <% field_id = "entry_data_#{field_handle.parameterize}" %>
-            <div>
-              <label for="<%= field_id %>" class="block text-sm font-medium text-gray-700"><%= field["label"] || field_handle.titleize %></label>
+            <% field_value = entry.data&.dig(field_handle) %>
+            <% field_value = field["default"] if entry.new_record? && field_value.nil? && field.key?("default") %>
+            <% condition = field["condition"].presence %>
+            <div class="<%= 'border-b border-gray-200 pb-2 pt-4' if field['type'] == 'section' %>" style="grid-column: span <%= field['type'] == 'section' ? 12 : (field['width'].presence || 12) %> / span <%= field['type'] == 'section' ? 12 : (field['width'].presence || 12) %>;"<% if condition %> data-field-condition="<%= condition.to_json %>"<% end %>>
+              <label for="<%= field_id %>" class="block <%= field['type'] == 'section' ? 'text-lg font-semibold text-gray-900' : 'text-sm font-medium text-gray-700' %>"><%= field["label"] || field_handle.titleize %></label>
+              <% if field["instructions"].present? %><p class="mt-1 text-sm text-gray-500"><%= field["instructions"] %></p><% end %>
               <% case field["type"] %>
+              <% when "section" %>
               <% when "text" %>
-                <%= text_field_tag "entry[data][#{field_handle}]", entry.data&.dig(field_handle), id: field_id,
+                <%= text_field_tag "entry[data][#{field_handle}]", field_value, id: field_id, placeholder: field["placeholder"], required: field["required"],
                     class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
               <% when "textarea" %>
-                <%= text_area_tag "entry[data][#{field_handle}]", entry.data&.dig(field_handle), id: field_id, rows: 4,
+                <%= text_area_tag "entry[data][#{field_handle}]", field_value, id: field_id, rows: 4, placeholder: field["placeholder"], required: field["required"],
                     class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
               <% when "rich_text" %>
                 <div class="mt-1">
-                  <%= hidden_field_tag "entry[data][#{field_handle}]", entry.data&.dig(field_handle), id: "#{field_id}_hidden" %>
-                  <lexxy-editor value="<%= entry.data&.dig(field_handle) %>"
+                  <%= hidden_field_tag "entry[data][#{field_handle}]", field_value, id: "#{field_id}_hidden" %>
+                  <lexxy-editor value="<%= field_value %>"
                                 data-direct-upload-url="<%= main_app.rails_direct_uploads_url %>"
                                 data-blob-url-template="<%= main_app.rails_service_blob_url(":signed_id", ":filename") %>"
                                 data-hidden-field="<%= field_id %>_hidden"
                                 class="lexxy-content min-h-48 rounded-lg border border-gray-300 bg-white shadow-sm"
-                                placeholder="Write something…"></lexxy-editor>
+                                placeholder="<%= field['placeholder'].presence || 'Write something…' %>"></lexxy-editor>
                 </div>
               <% when "number" %>
-                <%= number_field_tag "entry[data][#{field_handle}]", entry.data&.dig(field_handle), id: field_id,
-                    class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
+                <div class="mt-1 flex items-center gap-2">
+                  <%= number_field_tag "entry[data][#{field_handle}]", field_value, id: field_id, placeholder: field["placeholder"], required: field["required"],
+                      min: field["min"], max: field["max"], step: field["number_kind"] == "integer" ? 1 : (field["step"].presence || "any"),
+                      class: "block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
+                  <% if field["unit"].present? %><span class="text-sm font-medium text-gray-500"><%= field["unit"] %></span><% end %>
+                </div>
               <% when "boolean" %>
                 <div class="mt-1">
                   <%= hidden_field_tag "entry[data][#{field_handle}]", "false" %>
-                  <%= check_box_tag "entry[data][#{field_handle}]", "true", ActiveModel::Type::Boolean.new.cast(entry.data&.dig(field_handle)), id: field_id %>
+                  <%= check_box_tag "entry[data][#{field_handle}]", "true", ActiveModel::Type::Boolean.new.cast(field_value), id: field_id %>
                 </div>
               <% when "date" %>
-                <%= date_field_tag "entry[data][#{field_handle}]", entry.data&.dig(field_handle), id: field_id,
-                    class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
+                <% date_options = { id: field_id, required: field["required"], min: field["min"], max: field["max"], class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" } %>
+                <% if field["date_mode"] == "time" %>
+                  <%= time_field_tag "entry[data][#{field_handle}]", field_value, date_options %>
+                <% elsif field["date_mode"] == "datetime" %>
+                  <%= datetime_local_field_tag "entry[data][#{field_handle}]", field_value, date_options %>
+                <% else %>
+                  <%= date_field_tag "entry[data][#{field_handle}]", field_value, date_options %>
+                <% end %>
               <% when "select" %>
-                <% options = Array(field["options"]) %>
+                <% options = Plum::FieldOptions.pairs(field["options"]) %>
                 <%= select_tag "entry[data][#{field_handle}]",
-                    options_for_select([["— Select —", ""]] + options.map { |o| [o, o] }, entry.data&.dig(field_handle)),
-                    id: field_id,
+                    options_for_select([["— Select —", ""]] + options, field_value),
+                    id: field_id, required: field["required"],
                     class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
+              <% when "radio", "button_group" %>
+                <% options = Plum::FieldOptions.pairs(field["options"]) %>
+                <div class="mt-2 flex flex-wrap gap-2">
+                  <% options.each do |label, value| %>
+                    <label class="relative cursor-pointer">
+                      <%= radio_button_tag "entry[data][#{field_handle}]", value, field_value.to_s == value, required: field["required"], class: "peer sr-only" %>
+                      <span class="block rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-700 peer-checked:border-purple-500 peer-checked:bg-purple-50 peer-checked:text-purple-700 peer-focus:ring-2 peer-focus:ring-purple-500"><%= label %></span>
+                    </label>
+                  <% end %>
+                </div>
               <% when "checkboxes" %>
-                <% options = Array(field["options"]) %>
-                <% selected = Array(entry.data&.dig(field_handle)) %>
+                <% options = Plum::FieldOptions.pairs(field["options"]) %>
+                <% selected = Array(field_value) %>
                 <div class="mt-1 space-y-2">
-                  <% options.each do |option| %>
+                  <% options.each do |label, value| %>
                     <label class="flex items-center gap-2 text-sm text-gray-700">
-                      <%= check_box_tag "entry[data][#{field_handle}][]", option, selected.include?(option),
+                      <%= check_box_tag "entry[data][#{field_handle}][]", value, selected.include?(value),
                           class: "h-4 w-4 text-purple-600 focus:ring-purple-500 border-gray-300 rounded" %>
-                      <%= option %>
+                      <%= label %>
                     </label>
                   <% end %>
                 </div>
               <% when "color" %>
                 <div class="mt-1 flex items-center gap-3">
-                  <%= color_field_tag "entry[data][#{field_handle}]", entry.data&.dig(field_handle) || "#000000", id: field_id,
+                  <%= color_field_tag "entry[data][#{field_handle}]", field_value || "#000000", id: field_id,
                       class: "h-10 w-14 p-0 border border-gray-300 rounded-md cursor-pointer" %>
-                  <span class="text-sm text-gray-500 font-mono"><%= entry.data&.dig(field_handle) %></span>
+                  <span class="text-sm text-gray-500 font-mono"><%= field_value %></span>
                 </div>
               <% when "taxonomy" %>
                 <% taxonomy_handle = field["taxonomy"].to_s %>
@@ -105,23 +131,62 @@
                   <% end %>
                 </div>
               <% when "url" %>
-                <%= url_field_tag "entry[data][#{field_handle}]", entry.data&.dig(field_handle), id: field_id,
-                    placeholder: "https://",
+                <%= url_field_tag "entry[data][#{field_handle}]", field_value, id: field_id,
+                    placeholder: field["placeholder"].presence || "https://", required: field["required"],
                     class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
               <% when "image" %>
                 <%= render "plum/cp/shared/image_picker",
                     input_name: "entry[data][#{field_handle}]",
-                    value: entry.data&.dig(field_handle).to_s,
+                    value: field_value.to_s,
                     field_id: field_id,
                     save_url: entry.persisted? ? "#{cp_content_type_entry_path(@content_type, entry)}/image_field" : nil,
                     field_handle: field_handle %>
+              <% when "images" %>
+                <% selected_asset_ids = Array(field_value).map(&:to_i) %>
+                <div class="mt-2 space-y-3" data-controller="plum--asset-collection" <% if field['max_items'].present? %>data-plum--asset-collection-max-value="<%= field['max_items'] %>"<% end %>>
+                  <%= hidden_field_tag "entry[data][#{field_handle}][]", "" %>
+                  <div class="flex items-center justify-between">
+                    <p class="text-xs text-gray-500">Choose images from the asset library.</p>
+                    <span class="text-xs font-medium text-gray-600" data-plum--asset-collection-target="count"></span>
+                  </div>
+                  <div class="grid grid-cols-2 gap-3 sm:grid-cols-4">
+                    <% @assets.each do |asset| %>
+                      <label class="group relative cursor-pointer overflow-hidden rounded-lg border border-gray-200 bg-gray-50 p-2 has-checked:border-purple-500 has-checked:ring-2 has-checked:ring-purple-500">
+                        <%= check_box_tag "entry[data][#{field_handle}][]", asset.id, selected_asset_ids.include?(asset.id), class: "sr-only", data: { "plum--asset-collection-target": "checkbox", action: "change->plum--asset-collection#refresh" } %>
+                        <%= image_tag asset.url, alt: asset.alt_text.to_s, class: "aspect-square w-full rounded-md object-cover" %>
+                        <span class="mt-1 block truncate text-xs text-gray-600"><%= asset.filename %></span>
+                      </label>
+                    <% end %>
+                  </div>
+                  <% if @assets.empty? %><p class="text-sm text-gray-500">No images available. <%= link_to "Upload images", cp_assets_path, class: "text-purple-600" %>.</p><% end %>
+                </div>
               <% when "relationship" %>
-                <% selected_entry_id = entry.data&.dig(field_handle).to_s %>
                 <% relationship_entries = (@relationship_entries_by_field || {}).fetch(field_handle, []) %>
-                <%= select_tag "entry[data][#{field_handle}]",
-                    options_for_select([["No entry", ""]] + relationship_entries.map { |related_entry| ["#{related_entry.title} (#{related_entry.content_type.name})", related_entry.id] }, selected_entry_id),
-                    id: field_id,
-                    class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
+                <% relationship_options = relationship_entries.map { |related_entry| ["#{related_entry.title} (#{related_entry.content_type.name})", related_entry.id] } %>
+                <% if field["multiple"] %>
+                  <%= select_tag "entry[data][#{field_handle}][]", options_for_select(relationship_options, Array(field_value).map(&:to_s)), multiple: true,
+                      id: field_id, required: field["required"], size: [relationship_options.length, 8].min,
+                      class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
+                <% else %>
+                  <%= select_tag "entry[data][#{field_handle}]", options_for_select([["No entry", ""]] + relationship_options, field_value.to_s),
+                      id: field_id, required: field["required"], class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
+                <% end %>
+              <% when "list", "group", "repeater" %>
+                <% structured_value = field_value || (field["type"] == "group" ? {} : []) %>
+                <div class="mt-2 space-y-3" data-controller="plum--structured-field"
+                     data-plum--structured-field-type-value="<%= field['type'] %>"
+                     data-plum--structured-field-fields-value="<%= Array(field['fields']).to_json %>"
+                     <% if field['min_items'].present? %>data-plum--structured-field-min-items-value="<%= field['min_items'] %>"<% end %>
+                     <% if field['max_items'].present? %>data-plum--structured-field-max-items-value="<%= field['max_items'] %>"<% end %>>
+                  <%= hidden_field_tag "entry[data][#{field_handle}]", structured_value.to_json,
+                      data: { "plum--structured-field-target": "input" } %>
+                  <p class="hidden text-sm text-gray-500" data-plum--structured-field-target="empty">No items yet.</p>
+                  <div class="space-y-3" data-plum--structured-field-target="rows"></div>
+                  <% unless field["type"] == "group" %>
+                    <button type="button" data-action="plum--structured-field#add" data-plum--structured-field-target="add"
+                            class="rounded-md border border-gray-300 bg-white px-3 py-2 text-sm font-medium text-gray-700 shadow-sm hover:bg-gray-50 disabled:cursor-not-allowed disabled:opacity-40">+ Add <%= field["type"] == "list" ? "item" : "row" %></button>
+                  <% end %>
+                </div>
               <% when "blocks" %>
                 <% editor_config = Plum::BlockEditorConfig.new(@theme, allowed: field["blocks"]) %>
                 <% current_blocks = entry.data&.dig(field_handle) %>
@@ -150,9 +215,15 @@
                     </div>
                   </div>
                 <% end %>
+              <% else %>
+                <% definition = Plum::FieldTypeRegistry.find(field["type"]) %>
+                <% if definition&.partial.present? %>
+                  <%= render definition.partial, field: field, field_handle: field_handle, field_id: field_id, field_value: field_value, entry: entry %>
+                <% end %>
               <% end %>
             </div>
           <% end %>
+          </div>
           <% if @content_type.fields.empty? %>
             <p class="text-sm text-gray-500">No fields defined. <%= link_to "Edit content type", edit_cp_content_type_path(@content_type), class: "text-purple-600 hover:text-purple-900" %> to add fields.</p>
           <% end %>
@@ -164,6 +235,12 @@
         <div class="bg-white shadow rounded-lg p-6 space-y-4">
           <h3 class="text-lg font-medium text-gray-900">Publishing</h3>
 
+          <div>
+            <%= f.label :locale, class: "block text-sm font-medium text-gray-700" %>
+            <%= f.select :locale, current_site.locales.map { |locale| [locale, locale] }, {},
+                class: "mt-1 block w-full rounded-md border border-gray-300 px-3 py-2 shadow-sm focus:border-purple-500 focus:ring-purple-500" %>
+          </div>
+
           <div>
             <%= f.label :status, class: "block text-sm font-medium text-gray-700" %>
             <%= f.select :status, Plum::Entry.statuses.keys.map { |s| [s.titleize, s] }, {},

data/app/views/plum/cp/entries/edit.html.erb

@@ -1,9 +1,25 @@
 <div class="flex items-center justify-between mb-8">
   <h1 class="text-2xl font-bold text-gray-900">Edit <%= @entry.title %></h1>
+  <div class="flex items-center gap-3">
+    <%= link_to "History (#{@entry.revisions.count})", cp_content_type_entry_revisions_path(@content_type, @entry),
+        class: "inline-flex items-center px-4 py-2 border border-gray-300 rounded-md shadow-sm text-sm font-medium text-gray-700 bg-white hover:bg-gray-50" %>
   <% if @entry.published? %>
     <%= link_to "View", "#{root_path.chomp('/')}/#{@entry.slug}", target: "_blank",
         class: "inline-flex items-center px-4 py-2 border border-gray-300 rounded-md shadow-sm text-sm font-medium text-gray-700 bg-white hover:bg-gray-50" %>
   <% end %>
+  </div>
 </div>
 
 <%= render "form", entry: @entry %>
+
+<div class="mt-6 rounded-lg bg-white p-6 shadow">
+  <h2 class="text-lg font-semibold text-gray-900">Translations</h2>
+  <div class="mt-3 flex flex-wrap gap-2">
+    <% @entry.translation_group.each do |translation| %>
+      <%= link_to translation.locale, edit_cp_content_type_entry_path(@content_type, translation), class: "rounded-md border border-gray-300 px-3 py-2 text-sm font-medium #{translation == @entry ? 'bg-purple-50 text-purple-700' : 'bg-white text-gray-700'}" %>
+    <% end %>
+    <% (current_site.locales - @entry.translation_group.map(&:locale)).each do |locale| %>
+      <%= button_to "+ #{locale}", translate_cp_content_type_entry_path(@content_type, @entry), params: { locale: locale }, class: "rounded-md border border-dashed border-purple-300 px-3 py-2 text-sm font-medium text-purple-700" %>
+    <% end %>
+  </div>
+</div>

data/app/views/plum/cp/entry_revisions/index.html.erb

@@ -0,0 +1,25 @@
+<div class="mb-8 flex items-center justify-between gap-4">
+  <div>
+    <h1 class="text-2xl font-bold text-gray-900">Revision history</h1>
+    <p class="mt-1 text-sm text-gray-500"><%= @entry.title %></p>
+  </div>
+  <%= link_to "Back to entry", edit_cp_content_type_entry_path(@content_type, @entry), class: "rounded-md border border-gray-300 bg-white px-4 py-2 text-sm font-medium text-gray-700 shadow-sm hover:bg-gray-50" %>
+</div>
+
+<div class="overflow-hidden rounded-lg bg-white shadow">
+  <ul class="divide-y divide-gray-200">
+    <% @revisions.each_with_index do |revision, index| %>
+      <li class="flex flex-wrap items-center justify-between gap-4 px-6 py-4">
+        <div>
+          <p class="text-sm font-semibold text-gray-900"><%= index.zero? ? "Current saved version" : revision.created_at.to_fs(:long) %></p>
+          <p class="mt-1 text-xs text-gray-500"><%= revision.editor_label %> · <%= revision.snapshot["status"].to_s.titleize %></p>
+        </div>
+        <% unless index.zero? %>
+          <%= button_to "Restore", restore_cp_content_type_entry_revision_path(@content_type, @entry, revision), method: :post,
+              form: { data: { turbo_confirm: "Restore this version? The current version will remain in history." } },
+              class: "rounded-md border border-purple-200 bg-purple-50 px-3 py-2 text-sm font-semibold text-purple-700 hover:bg-purple-100" %>
+        <% end %>
+      </li>
+    <% end %>
+  </ul>
+</div>

data/app/views/plum/cp/fieldsets/index.html.erb

@@ -0,0 +1,30 @@
+<div class="mb-8">
+  <h1 class="text-2xl font-bold text-gray-900">Fieldsets</h1>
+  <p class="mt-1 text-sm text-gray-500">Save a content type's fields, then reuse them in other blueprints.</p>
+</div>
+
+<div class="grid gap-6 lg:grid-cols-3">
+  <section class="rounded-lg bg-white p-6 shadow lg:col-span-2">
+    <h2 class="text-lg font-semibold text-gray-900">Saved fieldsets</h2>
+    <div class="mt-4 divide-y divide-gray-200">
+      <% @fieldsets.each do |fieldset| %>
+        <div class="flex items-center justify-between gap-4 py-4">
+          <div><p class="text-sm font-semibold text-gray-900"><%= fieldset.name %></p><p class="text-xs text-gray-500"><%= fieldset.handle %> · <%= fieldset.fields.length %> fields</p></div>
+          <%= button_to "Delete", cp_fieldset_path(fieldset), method: :delete, form: { data: { turbo_confirm: "Delete this fieldset? Existing blueprints are unaffected." } }, class: "text-sm font-medium text-red-600" %>
+        </div>
+      <% end %>
+      <% if @fieldsets.empty? %><p class="py-6 text-sm text-gray-500">No saved fieldsets yet.</p><% end %>
+    </div>
+  </section>
+
+  <section class="rounded-lg bg-white p-6 shadow">
+    <h2 class="text-lg font-semibold text-gray-900">Create from content type</h2>
+    <%= form_with url: cp_fieldsets_path, scope: :fieldset, class: "mt-4 space-y-4" do |form| %>
+      <%= form.text_field :name, value: @fieldset&.name, required: true, placeholder: "SEO fields", class: "block w-full rounded-md border border-gray-300 px-3 py-2 text-sm" %>
+      <%= form.text_field :handle, value: @fieldset&.handle, placeholder: "Generated from name", class: "block w-full rounded-md border border-gray-300 px-3 py-2 font-mono text-sm" %>
+      <%= form.collection_select :content_type_id, @content_types, :id, :name, { prompt: "Choose source content type" }, required: true, class: "block w-full rounded-md border border-gray-300 px-3 py-2 text-sm" %>
+      <% if @fieldset&.errors&.any? %><p class="text-sm text-red-600"><%= @fieldset.errors.full_messages.to_sentence %></p><% end %>
+      <%= form.submit "Save fieldset", class: "rounded-md bg-purple-600 px-4 py-2 text-sm font-semibold text-white hover:bg-purple-700" %>
+    <% end %>
+  </section>
+</div>

data/app/views/plum/cp/site_settings/edit.html.erb

@@ -60,6 +60,18 @@
       <%= f.email_field :support_email,
           class: "mt-1 block w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-purple-500 focus:border-purple-500" %>
     </div>
+
+    <div class="grid gap-4 sm:grid-cols-2">
+      <div>
+        <%= f.label :locales, "Locales", class: "block text-sm font-medium text-gray-700" %>
+        <%= text_field_tag "site_setting[locales]", current_site.locales.join(", "), class: "mt-1 block w-full rounded-md border border-gray-300 px-3 py-2 shadow-sm", placeholder: "en, es, fr-CA" %>
+        <p class="mt-1 text-xs text-gray-500">Comma-separated language or language-region codes.</p>
+      </div>
+      <div>
+        <%= f.label :default_locale, "Default locale", class: "block text-sm font-medium text-gray-700" %>
+        <%= text_field_tag "site_setting[default_locale]", current_site.default_locale, class: "mt-1 block w-full rounded-md border border-gray-300 px-3 py-2 shadow-sm" %>
+      </div>
+    </div>
   </div>
 
   <div class="bg-white shadow rounded-lg p-6 space-y-6">

data/config/plum_routes.rb

@@ -6,10 +6,16 @@ Plum::Engine.routes.draw do
   namespace :cp do
     root "dashboard#show"
     resources :content_types do
+      post :apply_fieldset, on: :member
       resources :entries do
         patch :image_field, on: :member
+        post :translate, on: :member
+        resources :revisions, controller: "entry_revisions", only: [ :index ] do
+          post :restore, on: :member
+        end
       end
     end
+    resources :fieldsets, only: [ :index, :create, :destroy ]
     resources :assets, except: [ :show ]
     resources :globals
     resources :nav_menus do
@@ -28,10 +34,19 @@ Plum::Engine.routes.draw do
   end
 
   post "forms/:handle", to: "form_submissions#create", as: :form
+  namespace :api do
+    namespace :v1 do
+      get "collections/:collection_handle/entries", to: "entries#index", as: :collection_entries
+      get "collections/:collection_handle/entries/:slug", to: "entries#show", as: :collection_entry
+    end
+  end
   get "theme_assets/:theme_handle/*path", to: "theme_assets#show", as: :theme_asset, format: false
 
   get "search", to: "pages#search", as: :search
 
+  get ":locale", to: "pages#localized_home", constraints: { locale: /[a-z]{2}(?:-[A-Z]{2})?/ }, as: :localized_root
+  get ":locale/*slug", to: "pages#show", constraints: { locale: /[a-z]{2}(?:-[A-Z]{2})?/ }, as: :localized_page
+
   root "pages#home"
   get "*slug", to: "pages#show", constraints: ->(req) { !req.path.start_with?("/rails/") }
 end

data/db/engine_migrate/20260807130000_create_plum_entry_revisions.rb

@@ -0,0 +1,16 @@
+class CreatePlumEntryRevisions < ActiveRecord::Migration[8.0]
+  def change
+    create_table :plum_entry_revisions do |t|
+      t.references :site, null: false, foreign_key: { to_table: :plum_sites }
+      t.references :entry, null: false, foreign_key: { to_table: :plum_entries }
+      t.references :editor, null: true, foreign_key: { to_table: :plum_users }
+      t.string :editor_name
+      t.string :editor_email
+      t.string :editor_gid
+      t.json :snapshot, null: false, default: {}
+      t.timestamps
+    end
+
+    add_index :plum_entry_revisions, [ :entry_id, :created_at ]
+  end
+end

data/db/engine_migrate/20260807140000_create_plum_fieldsets.rb

@@ -0,0 +1,13 @@
+class CreatePlumFieldsets < ActiveRecord::Migration[8.0]
+  def change
+    create_table :plum_fieldsets do |t|
+      t.references :site, null: false, foreign_key: { to_table: :plum_sites }
+      t.string :name, null: false
+      t.string :handle, null: false
+      t.json :fields, null: false, default: []
+      t.timestamps
+    end
+
+    add_index :plum_fieldsets, [ :site_id, :handle ], unique: true
+  end
+end

data/db/engine_migrate/20260807150000_add_focal_point_to_plum_assets.rb

@@ -0,0 +1,6 @@
+class AddFocalPointToPlumAssets < ActiveRecord::Migration[8.0]
+  def change
+    add_column :plum_assets, :focal_x, :integer, null: false, default: 50
+    add_column :plum_assets, :focal_y, :integer, null: false, default: 50
+  end
+end

data/db/engine_migrate/20260807160000_add_localization_to_plum_entries.rb

@@ -0,0 +1,9 @@
+class AddLocalizationToPlumEntries < ActiveRecord::Migration[8.0]
+  def change
+    add_column :plum_entries, :locale, :string, null: false, default: "en"
+    add_reference :plum_entries, :origin, null: true, foreign_key: { to_table: :plum_entries }
+    remove_index :plum_entries, [ :site_id, :slug ], if_exists: true
+    add_index :plum_entries, [ :site_id, :locale, :slug ], unique: true
+    add_index :plum_entries, [ :origin_id, :locale ], unique: true
+  end
+end

data/docs/blueprint-fields.md

@@ -0,0 +1,55 @@
+# Blueprint fields
+
+Plum stores a content type blueprint as JSON with a `fields` array. Field
+handles are stable template and storage keys: lowercase letters, numbers, and
+underscores, beginning with a letter.
+
+## Shared configuration
+
+Every data field accepts `handle`, `type`, `label`, `instructions`, `required`,
+`default`, `placeholder`, and `width`. Width is a grid span from 1 through 12.
+A `section` organizes the entry form but stores no value.
+
+`condition` controls visibility using another field:
+
+```json
+{ "field": "format", "operator": "equals", "value": "feature" }
+```
+
+Operators: `equals`, `not_equals`, `contains`, `empty`, and `not_empty`.
+
+## Type-specific configuration
+
+| Type | Configuration | Stored value |
+|---|---|---|
+| `text`, `textarea`, `rich_text`, `url`, `color` | Shared options | String |
+| `number` | `number_kind`, `min`, `max`, `step`, `unit` | Number |
+| `boolean` | Shared options | Boolean |
+| `date` | `date_mode`, `min`, `max` | ISO date/time string |
+| `select`, `radio`, `button_group` | `options` | Option value |
+| `checkboxes` | `options` | Option-value array |
+| `taxonomy` | `taxonomy` | Entry-term associations |
+| `image` | Optional `folder` | Asset ID |
+| `images` | `min_items`, `max_items` | Asset-ID array |
+| `relationship` | `content_type`, `multiple`, item limits | Entry ID or ID array |
+| `blocks` | Optional `blocks` allowlist | Block array |
+| `list` | `min_items`, `max_items`, `unique` | String array |
+| `group` | Nested `fields` | Object |
+| `repeater` | Nested `fields`, item limits | Object array |
+| `section` | Shared presentation options | Nothing |
+
+Options may be strings or `{ "label": "Human label", "value": "stable_value" }`
+objects. Existing string options remain supported.
+
+## Theme values
+
+Liquid receives expanded assets and relationships. An `image` becomes an asset
+object, `images` becomes an array of asset objects, and relationships become an
+entry object or ordered array. Stored IDs remain internal to the editor.
+
+## Compatibility policy
+
+Blueprint additions are backward compatible. Plum continues to read legacy
+string options and single-value relationship/image fields. Changing a field's
+type or handle is a content migration and should be performed in application
+code before deploying the new blueprint.

data/docs/extensions.md

@@ -0,0 +1,32 @@
+# Extending Plum
+
+Plum exposes Rails-native extension points for host applications and gems. An
+initializer can register a field type with its control-panel partial and value
+pipeline:
+
+```ruby
+Plum.register_field_type(
+  handle: :postal_code,
+  label: "Postal Code",
+  partial: "my_engine/fields/postal_code",
+  normalizer: ->(value:, **) { value.to_s.upcase.delete(" ") },
+  validator: ->(value:, **) { "is invalid" unless value.to_s.match?(/\A\d{5}\z/) },
+  expander: ->(value:, **) { { "value" => value, "country" => "US" } }
+)
+```
+
+The partial receives `field`, `field_handle`, `field_id`, `field_value`, and
+`entry`. Its submitted input must use `entry[data][HANDLE]`.
+
+The normalizer runs before persistence and receives `value`, `field`, `entry`,
+and `controller`. The validator runs on the normalized entry value and returns
+one message, multiple messages, or `nil`. The expander controls the value sent
+to Liquid and the JSON content API and receives `value`, `field`, `site`, and
+`expander`.
+
+Registration rejects invalid or duplicate handles. Custom types automatically
+appear in the visual blueprint type picker and participate in normal required,
+default, instruction, conditional-visibility, and field-width behavior.
+
+Plum also supports registered content sources and host-owned authorization; see
+the corresponding README sections for those APIs.

data/docs/portability.md

@@ -0,0 +1,40 @@
+# Site export, import, backup, and restore
+
+Plum 0.3 archives are versioned ZIP files containing a JSON manifest and the
+original bytes of every attached asset. The manifest carries schemas, entries,
+relationships, translations, taxonomies, navigation, globals, forms, fieldsets,
+settings, revisions, and submissions. Import remaps database identifiers so an
+archive can be restored into a different database without collisions.
+
+## Export and import
+
+```sh
+bin/rails plum:site:export ARCHIVE=/safe/location/site.plum.zip SITE_ID=1
+bin/rails plum:site:import ARCHIVE=/safe/location/site.plum.zip NAME="Imported site" DOMAIN=example.com
+```
+
+`SITE_ID` is optional when exporting and defaults to the first site. `NAME` and
+`DOMAIN` are optional import overrides. Import always creates a new site; it
+never overwrites an existing site.
+
+## Backup and restore
+
+```sh
+bin/rails plum:backup:create SITE_ID=1 DIRECTORY=/var/backups/plum
+bin/rails plum:backup:restore ARCHIVE=/var/backups/plum/plum-site-1-TIMESTAMP.plum.zip
+```
+
+The backup task writes a timestamped archive. Restore uses the same safe,
+new-site import path. Assets are checked against their recorded byte size and
+checksum before the database transaction commits. Missing, corrupt, or
+unsupported archives fail without leaving a partially imported site.
+
+Backups must be copied off the application host and tested regularly. An archive
+does not include application code, environment secrets, users, or the host
+database outside the selected Plum site.
+
+## Archive compatibility
+
+The manifest currently uses format version `1`. Plum rejects archive versions
+it does not understand instead of guessing. Future format changes will either
+remain readable or ship an explicit migration path.

data/docs/product-principles.md

@@ -0,0 +1,73 @@
+# Product Principles
+
+These principles guide product and architectural decisions in Plum.
+
+## Rails Owns the Application
+
+The host application has the final say. Plum should integrate with its users,
+authorization, tenancy, models, jobs, mail, storage, routes, and deployment
+instead of creating parallel systems.
+
+## The First Useful Result Is Fast
+
+Installation must lead to an editable, published page in less than ten minutes.
+Defaults should be good enough to ship and understandable enough to replace.
+
+## The Escape Hatches Are Ruby
+
+When a project exceeds Plum's conventions, developers should extend it with
+ordinary Ruby, Rails configuration, models, controllers, helpers, and views.
+Plum should not require a proprietary plugin runtime.
+
+## Editors Do Not Need to Know Rails
+
+Developers define content structure and presentation. Editors should receive a
+clear, forgiving interface with preview, validation, history, and recovery.
+
+## Content Is Structured and Portable
+
+Content should be reusable across templates and exportable with its schema and
+assets. A site owner must be able to leave without scraping rendered HTML or
+depending on a Plum service.
+
+## One Stack Is a Feature
+
+Plum should not require Node services, a remote CMS database, webhooks, API
+tokens, or a separate frontend. Optional integrations may add capability, but
+the complete product must work as a conventional Rails application.
+
+## SQLite Is a First-Class Production Path
+
+Small content sites should run reliably with SQLite and persistent storage.
+Plum must also remain database-agnostic for embedded and higher-scale uses.
+
+## Sites Are Operationally Independent
+
+For agency work, one client site should be one portable application, container,
+database, and backup unit. For SaaS products, site scoping should support many
+tenants inside one host application. Plum should document both patterns rather
+than forcing one onto the other.
+
+## Deployment Tools Have Clear Boundaries
+
+Plum creates and manages content applications. A Plum CLI may scaffold, inspect,
+export, import, upgrade, and package them. ONCE, Kamal, and other deployment
+tools operate the resulting containers and servers. Plum should integrate
+cleanly without becoming an infrastructure orchestrator.
+
+## Documentation Is Part of the Product
+
+Every public capability needs an example and a clear contract. If a feature is
+difficult to explain, its design is not finished.
+
+## Dogfood Without Special Cases
+
+The Plum marketing and documentation site must run on the public product. Any
+general improvement it needs belongs in Plum; site-specific behavior belongs in
+the site's application or theme.
+
+## Prefer Coherence Over Feature Count
+
+Plum should excel at the everyday path from modeling content to publishing a
+site. Features that strengthen installation, authoring confidence, portability,
+and Rails integration take priority over breadth for its own sake.