iron-cms 0.17.3 → 0.18.0

data/app/views/iron/entries/fields/_text_field.html.erb

@@ -6,22 +6,15 @@
   <%= builder.hidden_field :definition_type %>
   <%= builder.hidden_field :type %>
 
-  <%= builder.label :value_string do %>
-    <%= field.definition.name %>
-    <% if field.definition.required %>
-      <span class="text-red-500 ml-1">*</span>
-    <% end %>
-  <% end %>
+  <%= render "iron/entries/fields/field_label", builder: builder, field: field, attribute: :value_string %>
   <% if field.definition.allowed_values.present? %>
     <%= builder.select :value_string,
                    field.definition.allowed_values,
                    { include_blank: "Select #{field.definition.name}" } %>
   <% else %>
-    <%= builder.text_field :value_string %>
-  <% end %>
-  <% if field.errors.any? %>
-    <div class="text-red-500 text-sm font-medium mt-1">
-      <%= field.errors.full_messages.join(", ") %>
-    </div>
+    <%= builder.text_field :value_string,
+                       minlength: field.definition.min_length,
+                       maxlength: field.definition.max_length %>
   <% end %>
+  <%= render "iron/entries/fields/field_errors", field: field %>
 </div>

data/app/views/iron/field_definitions/_field_definition.html.erb

@@ -1,26 +1,51 @@
-<li
-  id="<%= dom_id field_definition %>"
-  class="group field-definition-row"
-  data-field-color="<%= field_definition_color(field_definition) %>"
-  data-sortable-list-target="item"
->
-  <%= form_with model: field_definition.becomes(Iron::FieldDefinition),
-    data: { controller: "form", action: "change->form#submit" } do |form| %>
-
-    <%= form.hidden_field :rank, data: { sortable_list_target: "rank" } %>
-
-    <button
-      type="button"
-      class="flex items-center justify-center w-10 shrink-0 self-stretch text-stone-400 hover:text-stone-500 dark:text-stone-500 dark:hover:text-stone-400 transition-colors cursor-grab"
-      data-sortable-list-target="handle"
-    >
-      <%= icon "grip-vertical", class: "size-4" %>
-    </button>
-
-    <%= link_to edit_field_definition_path(field_definition),
-      class: "flex-1 flex items-center gap-3 px-3 py-3 hover:bg-stone-50 dark:hover:bg-stone-800/50 rounded-lg transition-colors",
-      data: { turbo_frame: :drawer } do %>
+<% if Iron::Schema.editable? %>
+  <li
+    id="<%= dom_id field_definition %>"
+    class="group field-definition-row"
+    data-field-color="<%= field_definition_color(field_definition) %>"
+    data-sortable-list-target="item"
+  >
+    <%= form_with model: field_definition.becomes(Iron::FieldDefinition),
+      data: { controller: "form", action: "change->form#submit" } do |form| %>
 
+      <%= form.hidden_field :rank, data: { sortable_list_target: "rank" } %>
+
+      <button
+        type="button"
+        class="flex items-center justify-center w-10 shrink-0 self-stretch text-stone-400 hover:text-stone-500 dark:text-stone-500 dark:hover:text-stone-400 transition-colors cursor-grab"
+        data-sortable-list-target="handle"
+      >
+        <%= icon "grip-vertical", class: "size-4" %>
+      </button>
+
+      <%= link_to edit_field_definition_path(field_definition),
+        class: "flex-1 flex items-center gap-3 px-3 py-3 hover:bg-stone-50 dark:hover:bg-stone-800/50 rounded-lg transition-colors",
+        data: { turbo_frame: :drawer } do %>
+
+        <div class="field-icon">
+          <%= icon field_definition_icon(field_definition), class: "size-5" %>
+        </div>
+
+        <div class="flex-1 min-w-0">
+          <h3 class="text-sm font-semibold text-stone-900 dark:text-white truncate">
+            <%= field_definition.name %>
+          </h3>
+        </div>
+
+        <div class="flex items-center gap-3">
+          <span class="field-badge"><%= field_definition.humanized_type %></span>
+          <%= icon "chevron-right", class: "size-4 text-stone-400 dark:text-stone-500" %>
+        </div>
+      <% end %>
+    <% end %>
+  </li>
+<% else %>
+  <li
+    id="<%= dom_id field_definition %>"
+    class="field-definition-row"
+    data-field-color="<%= field_definition_color(field_definition) %>"
+  >
+    <div class="flex-1 flex items-center gap-3 px-3 py-3">
       <div class="field-icon">
         <%= icon field_definition_icon(field_definition), class: "size-5" %>
       </div>
@@ -31,10 +56,7 @@
         </h3>
       </div>
 
-      <div class="flex items-center gap-3">
-        <span class="field-badge"><%= field_definition.humanized_type %></span>
-        <%= icon "chevron-right", class: "size-4 text-stone-400 dark:text-stone-500" %>
-      </div>
-    <% end %>
-  <% end %>
-</li>
+      <span class="field-badge"><%= field_definition.humanized_type %></span>
+    </div>
+  </li>
+<% end %>

data/app/views/iron/field_definitions/date/_form.html.erb

@@ -1,2 +1,6 @@
 <%= render layout: "iron/field_definitions/layouts/form", locals: { field_definition: field_definition } do |form| %>
-<% end %>
+  <div class="field flex items-center justify-between">
+    <%= form.label :required, t("iron.field_definitions.form.required") %>
+    <%= form.toggle :required %>
+  </div>
+<% end %>

data/app/views/iron/field_definitions/edit.html.erb

@@ -16,12 +16,14 @@
     <%= render "iron/field_definitions/#{@field_definition.type_handle}/form", field_definition: @field_definition %>
   </div>
 
-  <div class="drawer-footer flex items-center gap-3">
-    <input type="submit" value="<%= t(".submit") %>" form="field-definition-form" class="button-primary flex-1">
-    <%= button_to t(".delete_action"), field_definition_path(@field_definition),
-      method: :delete,
-      class: "button-secondary justify-center w-full",
-      form_class: "flex-1",
-      data: { turbo_confirm: t(".delete_confirm") } %>
-  </div>
+  <% if Iron::Schema.editable? %>
+    <div class="drawer-footer flex items-center gap-3">
+      <input type="submit" value="<%= t(".submit") %>" form="field-definition-form" class="button-primary flex-1">
+      <%= button_to t(".delete_action"), field_definition_path(@field_definition),
+        method: :delete,
+        class: "button-secondary justify-center w-full",
+        form_class: "flex-1",
+        data: { turbo_confirm: t(".delete_confirm") } %>
+    </div>
+  <% end %>
 <% end %>

data/app/views/iron/field_definitions/file/_form.html.erb

@@ -1,4 +1,9 @@
 <%= render layout: "iron/field_definitions/layouts/form", locals: { field_definition: field_definition } do |form| %>
+  <div class="field flex items-center justify-between">
+    <%= form.label :required, t("iron.field_definitions.form.required") %>
+    <%= form.toggle :required %>
+  </div>
+
   <fieldset class="field">
     <legend class="text-sm/6 font-medium text-stone-950 dark:text-white">
       <%= t("iron.field_definitions.file.accepted_file_types") %>
@@ -44,5 +49,6 @@
         </label>
       </div>
     </div>
+    <%= form.error_for :selected_presets %>
   </fieldset>
 <% end %>

data/app/views/iron/field_definitions/new.html.erb

@@ -15,7 +15,9 @@
     </section>
   </div>
 
-  <div class="drawer-footer">
-    <input type="submit" value="<%= t(".submit") %>" form="field-definition-form" class="button-primary w-full">
-  </div>
+  <% if Iron::Schema.editable? %>
+    <div class="drawer-footer">
+      <input type="submit" value="<%= t(".submit") %>" form="field-definition-form" class="button-primary w-full">
+    </div>
+  <% end %>
 <% end %>

data/app/views/iron/field_definitions/number/_form.html.erb

@@ -1,2 +1,24 @@
-<%= render layout: "iron/field_definitions/layouts/form", locals: { field_definition: field_definition } do %>
+<%= render layout: "iron/field_definitions/layouts/form", locals: { field_definition: field_definition } do |form| %>
+  <div class="field flex items-center justify-between">
+    <%= form.label :required, t("iron.field_definitions.form.required") %>
+    <%= form.toggle :required %>
+  </div>
+
+  <div class="grid grid-cols-2 gap-4">
+    <div class="field">
+      <%= form.label :min, t("iron.field_definitions.form.min") %>
+      <div>
+        <%= form.number_field :min, step: "any" %>
+        <%= form.error_for :min %>
+      </div>
+    </div>
+
+    <div class="field">
+      <%= form.label :max, t("iron.field_definitions.form.max") %>
+      <div>
+        <%= form.number_field :max, step: "any" %>
+        <%= form.error_for :max %>
+      </div>
+    </div>
+  </div>
 <% end %>

data/app/views/iron/field_definitions/reference/_form.html.erb

@@ -1,4 +1,9 @@
 <%= render layout: "iron/field_definitions/layouts/form", locals: { field_definition: field_definition } do |form| %>
+  <div class="field flex items-center justify-between">
+    <%= form.label :required, t("iron.field_definitions.form.required") %>
+    <%= form.toggle :required %>
+  </div>
+
   <div class="field">
     <%= form.label :supported_content_type_ids, t("iron.field_definitions.reference.supported_content_types") %>
     <div class="selection-list">

data/app/views/iron/field_definitions/rich_text_area/_form.html.erb

@@ -1,4 +1,9 @@
 <%= render layout: "iron/field_definitions/layouts/form", locals: { field_definition: field_definition } do |form| %>
+  <div class="field flex items-center justify-between">
+    <%= form.label :required, t("iron.field_definitions.form.required") %>
+    <%= form.toggle :required %>
+  </div>
+
   <div class="field flex items-center justify-between">
     <%= form.label :searchable, t("iron.field_definitions.rich_text_area.searchable") %>
     <%= form.toggle :searchable %>

data/app/views/iron/field_definitions/text_area/_form.html.erb

@@ -1,6 +1,29 @@
 <%= render layout: "iron/field_definitions/layouts/form", locals: { field_definition: field_definition } do |form| %>
+  <div class="field flex items-center justify-between">
+    <%= form.label :required, t("iron.field_definitions.form.required") %>
+    <%= form.toggle :required %>
+  </div>
+
   <div class="field flex items-center justify-between">
     <%= form.label :searchable, t("iron.field_definitions.text_area.searchable") %>
     <%= form.toggle :searchable %>
   </div>
+
+  <div class="grid grid-cols-2 gap-4">
+    <div class="field">
+      <%= form.label :min_length, t("iron.field_definitions.form.min_length") %>
+      <div>
+        <%= form.number_field :min_length, min: 1 %>
+        <%= form.error_for :min_length %>
+      </div>
+    </div>
+
+    <div class="field">
+      <%= form.label :max_length, t("iron.field_definitions.form.max_length") %>
+      <div>
+        <%= form.number_field :max_length, min: 1 %>
+        <%= form.error_for :max_length %>
+      </div>
+    </div>
+  </div>
 <% end %>

data/app/views/iron/field_definitions/text_field/_form.html.erb

@@ -1,6 +1,6 @@
 <%= render layout: "iron/field_definitions/layouts/form", locals: { field_definition: field_definition } do |form| %>
   <div class="field flex items-center justify-between">
-    <%= form.label :required, t("iron.field_definitions.text_field.required") %>
+    <%= form.label :required, t("iron.field_definitions.form.required") %>
     <%= form.toggle :required %>
   </div>
 
@@ -17,6 +17,25 @@
                      rows: 3,
                      class: "input" %>
       <p class="text-xs text-stone-500"><%= t("iron.field_definitions.text_field.allowed_values_help") %></p>
+      <%= form.error_for :allowed_values %>
+    </div>
+  </div>
+
+  <div class="grid grid-cols-2 gap-4">
+    <div class="field">
+      <%= form.label :min_length, t("iron.field_definitions.form.min_length") %>
+      <div>
+        <%= form.number_field :min_length, min: 1 %>
+        <%= form.error_for :min_length %>
+      </div>
+    </div>
+
+    <div class="field">
+      <%= form.label :max_length, t("iron.field_definitions.form.max_length") %>
+      <div>
+        <%= form.number_field :max_length, min: 1 %>
+        <%= form.error_for :max_length %>
+      </div>
     </div>
   </div>
 <% end %>

data/app/views/iron/home/_content_types.html.erb

@@ -7,7 +7,7 @@
       <% @content_types.each do |content_type| %>
         <div class="card flex items-center gap-3 px-4 py-3.5" data-type="<%= content_type.humanized_type.downcase %>">
           <div class="content-type-icon">
-            <%= icon content_type.icon.presence || "file-text", class: "size-4" %>
+            <%= icon content_type.display_icon, class: "size-4" %>
           </div>
           <div class="flex-1 min-w-0">
             <%= link_to content_type.name, content_type_sidebar_url(content_type), class: "card-link block text-sm font-medium text-stone-900 dark:text-white truncate" %>

data/app/views/iron/locales/_form.html.erb

@@ -19,7 +19,9 @@
     </div>
   </div>
 
-  <div class="mt-4">
-    <%= form.submit t("iron.actions.save"), class: "button-primary" %>
-  </div>
+  <% if Iron::Schema.editable? %>
+    <div class="mt-4">
+      <%= form.submit t("iron.actions.save"), class: "button-primary" %>
+    </div>
+  <% end %>
 <% end %>

data/app/views/iron/locales/edit.html.erb

@@ -5,7 +5,7 @@
     <div class="flex items-center justify-between mb-6">
       <%= link_to t(".breadcrumb"), locales_path, class: "breadcrumb" %>
 
-      <% unless @locale.default? %>
+      <% if Iron::Schema.editable? && !@locale.default? %>
         <el-dropdown class="inline-block">
           <button type="button" class="button-ghost button-sm p-2">
             <%= icon "ellipsis", class: "size-5" %>

data/app/views/iron/locales/index.html.erb

@@ -10,9 +10,13 @@
         </p>
       </div>
 
-      <%= link_to new_locale_path, class: "button-primary self-start" do %>
-        <%= icon "plus", class: "size-4" %>
-        <%= t(".new_locale") %>
+      <% if Iron::Schema.editable? %>
+        <%= link_to new_locale_path, class: "button-primary self-start" do %>
+          <%= icon "plus", class: "size-4" %>
+          <%= t(".new_locale") %>
+        <% end %>
+      <% else %>
+        <%= render "iron/shared/schema_lock_badge" %>
       <% end %>
     </div>
 
@@ -31,9 +35,11 @@
         </div>
         <h3 class="text-sm font-medium text-stone-900 dark:text-white mb-1"><%= t(".empty_title") %></h3>
         <p class="text-sm text-stone-500 dark:text-stone-400 mb-4"><%= t(".empty_description") %></p>
-        <%= link_to new_locale_path, class: "button-primary" do %>
-          <%= icon "plus", class: "size-4" %>
-          <%= t(".new_locale") %>
+        <% if Iron::Schema.editable? %>
+          <%= link_to new_locale_path, class: "button-primary" do %>
+            <%= icon "plus", class: "size-4" %>
+            <%= t(".new_locale") %>
+          <% end %>
         <% end %>
       </div>
     </div>

data/app/views/iron/shared/_schema_lock_badge.html.erb

@@ -0,0 +1,19 @@
+<div class="group relative inline-flex self-start">
+  <span
+    tabindex="0"
+    role="note"
+    aria-describedby="schema_lock_details"
+    class="inline-flex cursor-default items-center gap-1.5 rounded-full border border-amber-300/70 bg-amber-50 px-3 py-1.5 text-xs font-medium text-amber-900 transition hover:bg-amber-100 focus:outline-none focus-visible:ring-2 focus-visible:ring-amber-400/60 dark:border-amber-400/20 dark:bg-amber-400/10 dark:text-amber-200 dark:hover:bg-amber-400/15"
+  >
+    <%= icon "lock", class: "size-3.5" %>
+    <%= t("iron.schema.locked.badge") %>
+  </span>
+
+  <div
+    id="schema_lock_details"
+    role="tooltip"
+    class="pointer-events-none absolute right-0 top-full z-20 mt-2 w-80 rounded-xl border border-stone-200 bg-white p-3.5 text-left text-xs leading-relaxed text-stone-600 opacity-0 shadow-xl ring-1 ring-black/5 transition duration-150 group-hover:opacity-100 group-focus-within:opacity-100 dark:border-stone-700 dark:bg-stone-800 dark:text-stone-300 dark:ring-white/10"
+  >
+    <%= t("iron.schema.locked.details") %>
+  </div>
+</div>

data/config/locales/en.yml

@@ -31,6 +31,8 @@ en:
           attributes:
             base:
               cannot_deactivate_self: "You cannot delete your own account while logged in"
+              cannot_deactivate_system: "The system account cannot be deactivated"
+              cannot_destroy_system: "The system account cannot be deleted"
             role:
               cannot_change_own_role: "cannot be changed for your own account"
   iron:
@@ -201,6 +203,11 @@ en:
         specific_file_types: "Specific file types"
       form:
         handle_help: "The API identifier for this field"
+        max: "Maximum value"
+        max_length: "Maximum length"
+        min: "Minimum value"
+        min_length: "Minimum length"
+        required: "Required"
       new:
         settings_title: "Field Settings"
         submit: "Create field"
@@ -214,7 +221,6 @@ en:
       text_field:
         allowed_values: "Allowed values"
         allowed_values_help: "One value per line, leave blank to allow any value"
-        required: "Required"
         searchable: "Searchable"
     first_runs:
       show:
@@ -336,6 +342,12 @@ en:
         body_text: "You can reset your password within the next 15 minutes on this password reset page:\n%{url}"
         link_text: "this password reset page"
         subject: "Reset your password"
+    schema:
+      locked:
+        alert: "The schema is managed in code and can't be edited here."
+        api_error: "is managed in code and cannot be edited on this environment"
+        badge: "Managed in code"
+        details: "Content types, blocks, fields, and locales are defined in db/cms/schema.json and applied on deploy. Editing is disabled on this environment — change the schema in development, commit it, and run bin/rails iron:schema:apply."
     sessions:
       new:
         email_address: "Email address"

data/config/locales/it.yml

@@ -70,6 +70,8 @@ it:
           attributes:
             base:
               cannot_deactivate_self: "Non puoi eliminare il tuo account mentre sei autenticato"
+              cannot_deactivate_system: "L'account di sistema non può essere disattivato"
+              cannot_destroy_system: "L'account di sistema non può essere eliminato"
             role:
               cannot_change_own_role: "non può essere cambiato per il tuo account"
   iron:
@@ -240,16 +242,25 @@ it:
         specific_file_types: "Tipi di file specifici"
       form:
         handle_help: "L'identificativo API per questo campo"
+        max: "Valore massimo"
+        max_length: "Lunghezza massima"
+        min: "Valore minimo"
+        min_length: "Lunghezza minima"
+        required: "Obbligatorio"
       new:
         settings_title: "Impostazioni campo"
         submit: "Crea campo"
         title: "Nuovo campo"
       reference:
         supported_content_types: "Tipi di contenuto supportati"
+      rich_text_area:
+        searchable: "Ricercabile"
+      text_area:
+        searchable: "Ricercabile"
       text_field:
         allowed_values: "Valori consentiti"
         allowed_values_help: "Un valore per riga, lascia vuoto per consentire qualsiasi valore"
-        required: "Obbligatorio"
+        searchable: "Ricercabile"
     first_runs:
       show:
         description: "Inizia a gestire i tuoi contenuti con Iron CMS"
@@ -370,6 +381,12 @@ it:
         body_text: "Puoi reimpostare la password entro i prossimi 15 minuti su questa pagina di reimpostazione:\n%{url}"
         link_text: "questa pagina di reimpostazione"
         subject: "Reimposta la password"
+    schema:
+      locked:
+        alert: "Lo schema è gestito nel codice e non può essere modificato qui."
+        api_error: "è gestito nel codice e non può essere modificato in questo ambiente"
+        badge: "Gestito nel codice"
+        details: "Tipi di contenuto, blocchi, campi e lingue sono definiti in db/cms/schema.json e applicati al deploy. La modifica è disabilitata in questo ambiente — modifica lo schema in sviluppo, esegui il commit e lancia bin/rails iron:schema:apply."
     sessions:
       new:
         email_address: "Indirizzo email"

data/config/routes.rb

@@ -36,6 +36,17 @@ Iron::Engine.routes.draw do
     patch "content/:handle/:id", to: "content#update"
     delete "content/:handle/:id", to: "content#destroy"
     resource :search, only: :show, controller: "search"
+
+    namespace :schema do
+      resources :content_types, only: %i[ index create show update destroy ] do
+        resources :field_definitions, only: :create
+      end
+      resources :block_definitions, only: %i[ index create show update destroy ] do
+        resources :field_definitions, only: :create
+      end
+      resources :field_definitions, only: %i[ show update destroy ]
+      resources :locales, only: %i[ index create show update destroy ]
+    end
   end
 
   resource :settings, only: %i[ show update ]

data/db/migrate/20260612131538_create_iron_systems.rb

@@ -0,0 +1,9 @@
+class CreateIronSystems < ActiveRecord::Migration[8.1]
+  def change
+    create_table :iron_systems do |t|
+      t.string :name, null: false, default: "System"
+
+      t.timestamps
+    end
+  end
+end

data/exe/iron

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "iron/cli"
+
+Iron::CLI.start(ARGV)

data/lib/generators/iron/agents/agents_generator.rb

@@ -0,0 +1,52 @@
+require "rails/generators"
+
+module Iron
+  module Generators
+    class AgentsGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      IRON_SECTION_HEADING = "## Iron CMS".freeze
+
+      class_option :quiet, type: :boolean, default: false,
+        desc: "Suppress the closing instructions (set when composed by iron:install)"
+
+      def create_skill
+        copy_file "SKILL.md", ".claude/skills/iron-cms/SKILL.md"
+      end
+
+      def update_agents_md
+        if File.exist?(agents_md_path)
+          append_to_file "AGENTS.md", "\n#{iron_section}" unless iron_section_present?
+        else
+          create_file "AGENTS.md", iron_section
+        end
+      end
+
+      def display_instructions
+        return if options[:quiet]
+
+        say "\n=== Iron CMS Agent Setup Complete ===\n", :green
+        say "Created:"
+        say "  - .claude/skills/iron-cms/SKILL.md (the full Iron CMS workflow for coding agents)"
+        say "  - AGENTS.md with an Iron CMS section (command crib sheet)"
+        say "\nNext steps:"
+        say "1. Run bin/rails iron:schema:dump to materialize db/cms/schema.json."
+        say "2. Read .claude/skills/iron-cms/SKILL.md for the schema and content workflow."
+      end
+
+      private
+
+        def agents_md_path
+          File.join(destination_root, "AGENTS.md")
+        end
+
+        def iron_section_present?
+          File.read(agents_md_path).include?(IRON_SECTION_HEADING)
+        end
+
+        def iron_section
+          @iron_section ||= File.read(find_in_source_paths("AGENTS.md"))
+        end
+    end
+  end
+end

data/lib/generators/iron/agents/templates/AGENTS.md

@@ -0,0 +1,24 @@
+## Iron CMS
+
+This app's CMS is powered by Iron. The content model (content types, block definitions,
+fields, locales) lives declaratively in `db/cms/schema.json`; content (entries) lives in
+the database. Model by editing the schema file and applying it; create and edit content
+through the `iron:content` tasks. The full workflow — schema file format, payload formats,
+field types — is documented in `.claude/skills/iron-cms/SKILL.md`.
+
+### Commands
+
+- `bin/rails iron:schema:dump` — write the current database schema to `db/cms/schema.json`
+- `bin/rails iron:schema:diff` — show drift between the schema file and the database
+- `bin/rails iron:schema:apply` — upsert the schema file into the database (`PRUNE=1` also deletes)
+- `bin/rails iron:content:list HANDLE=<type>` — list entries of a content type
+- `bin/rails iron:content:get HANDLE=<type> [ID=|ROUTE=]` — fetch one entry as JSON
+- `bin/rails iron:content:create HANDLE=<type> [ROUTE=]` — create an entry (payload via `PAYLOAD=`, `FILE=`, or stdin)
+- `bin/rails iron:content:update HANDLE=<type> [ID=|ROUTE=]` — update an entry (partial; singles need no ID)
+- `bin/rails iron:content:delete HANDLE=<type> ID=|ROUTE=` — delete an entry
+- `bin/rails iron:seed:dump` — checkpoint schema + content to `db/seeds/iron.zip`
+- `bin/rails g iron:pages` — install the public pages controller (once per app)
+- `bin/rails g iron:template <handle>` — scaffold a view template for a content type
+
+Schema changes go through the file and `iron:schema:apply`, never through one-off code.
+Content changes go through the `iron:content` tasks. See the skill for details.