macron-cms 1.0.0

data/app/views/macron/cms/dashboard/index.html.erb

@@ -0,0 +1,81 @@
+<% content_for :title, "Dashboard - Macron CMS" %>
+<% cms_breadcrumb "Dashboard" %>
+
+<div class="space-y-8">
+  <!-- Page Header -->
+  <div class="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-4 border-b border-zinc-200 pb-6">
+    <div>
+      <h1 class="text-2xl font-bold tracking-tight text-zinc-900 sm:text-3xl">CMS Dashboard</h1>
+      <p class="mt-1 text-sm text-zinc-500">Overview of your published content, system health, and quick actions.</p>
+    </div>
+    <div class="flex items-center gap-3">
+      <%= link_to new_article_path, class: "inline-flex items-center gap-2 rounded-lg bg-zinc-900 px-4 py-2.5 text-sm font-semibold text-white shadow-sm hover:bg-zinc-800 transition-colors" do %>
+        <svg class="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor">
+          <path stroke-linecap="round" stroke-linejoin="round" d="M12 4.5v15m7.5-7.5h-15" />
+        </svg>
+        New Article
+      <% end %>
+    </div>
+  </div>
+
+  <!-- Metric Stat Cards -->
+  <div class="grid grid-cols-1 gap-5 sm:grid-cols-3">
+    <!-- Stat 1: Total Articles -->
+    <div class="overflow-hidden rounded-xl bg-white p-6 border border-zinc-200 shadow-xs">
+      <div class="flex items-center justify-between">
+        <dt class="truncate text-sm font-medium text-zinc-500">Total Articles</dt>
+        <span class="rounded-md bg-zinc-100 p-2 text-zinc-700">
+          <svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M19.5 14.25v-2.625a3.375 3.375 0 0 0-3.375-3.375h-1.5A1.125 1.125 0 0 1 13.5 7.125v-1.5a3.375 3.375 0 0 0-3.375-3.375H8.25m0 12.75h7.5m-7.5 3H12M10.5 2.25H5.625c-.621 0-1.125.504-1.125 1.125v17.25c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 0 0-9-9Z" />
+          </svg>
+        </span>
+      </div>
+      <dd class="mt-3 text-3xl font-bold tracking-tight text-zinc-900"><%= @articles_count %></dd>
+      <p class="mt-1 text-xs text-zinc-500">Managed via Macron CMS</p>
+    </div>
+
+    <!-- Stat 2: Engine Version -->
+    <div class="overflow-hidden rounded-xl bg-white p-6 border border-zinc-200 shadow-xs">
+      <div class="flex items-center justify-between">
+        <dt class="truncate text-sm font-medium text-zinc-500">Engine Version</dt>
+        <span class="rounded-md bg-zinc-100 p-2 text-zinc-700">
+          <svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M9.594 3.94c.09-.542.56-.94 1.11-.94h2.593c.55 0 1.02.398 1.11.94l.213 1.281c.063.374.313.686.645.87.074.04.147.083.22.127.324.196.72.257 1.075.124l1.217-.456a1.125 1.125 0 0 1 1.37.49l1.296 2.247a1.125 1.125 0 0 1-.26 1.431l-1.003.827c-.293.24-.438.613-.431.992a6.759 6.759 0 0 1 0 .255c-.007.378.138.75.43.99l1.005.828c.424.35.534.954.26 1.43l-1.298 2.247a1.125 1.125 0 0 1-1.369.491l-1.217-.456c-.355-.133-.75-.072-1.076.124a6.57 6.57 0 0 1-.22.128c-.331.183-.581.495-.644.869l-.213 1.28c-.09.543-.56.941-1.11.941h-2.594c-.55 0-1.02-.398-1.11-.94l-.213-1.281c-.062-.374-.312-.686-.644-.87a6.52 6.52 0 0 1-.22-.127c-.325-.196-.72-.257-1.076-.124l-1.217.456a1.125 1.125 0 0 1-1.369-.49l-1.297-2.247a1.125 1.125 0 0 1 .26-1.431l1.004-.827c.292-.24.437-.613.43-.992a6.932 6.932 0 0 1 0-.255c.007-.378-.138-.75-.43-.99l-1.004-.828a1.125 1.125 0 0 1-.26-1.43l1.297-2.247a1.125 1.125 0 0 1 1.37-.491l1.216.456c.356.133.751.072 1.076-.124.072-.044.146-.087.22-.128.332-.183.582-.495.644-.869l.214-1.281Z" />
+            <path stroke-linecap="round" stroke-linejoin="round" d="M15 12a3 3 0 1 1-6 0 3 3 0 0 1 6 0Z" />
+          </svg>
+        </span>
+      </div>
+      <dd class="mt-3 text-3xl font-bold tracking-tight text-zinc-900 font-mono">v<%= Macron::Cms::VERSION %></dd>
+      <p class="mt-1 text-xs text-zinc-500">Standalone Tailwind Enabled</p>
+    </div>
+
+    <!-- Stat 3: Access Guard -->
+    <div class="overflow-hidden rounded-xl bg-white p-6 border border-zinc-200 shadow-xs">
+      <div class="flex items-center justify-between">
+        <dt class="truncate text-sm font-medium text-zinc-500">Access Guard</dt>
+        <span class="rounded-md bg-emerald-50 p-2 text-emerald-700">
+          <svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M9 12.75 11.25 15 15 9.75m-3-7.036A11.959 11.959 0 0 1 3.598 6 11.99 11.99 0 0 0 3 9.749c0 5.592 3.824 10.29 9 11.623 5.176-1.332 9-6.03 9-11.622 0-1.31-.21-2.571-.598-3.751h-.152c-3.196 0-6.1-1.248-8.25-3.285Z" />
+          </svg>
+        </span>
+      </div>
+      <dd class="mt-3 text-3xl font-bold tracking-tight text-zinc-900">Protected</dd>
+      <p class="mt-1 text-xs text-zinc-500">Devise <%= Macron::Cms.configuration.user_class %> (<%= Macron::Cms.configuration.admin_flag %>: true)</p>
+    </div>
+  </div>
+
+  <!-- Recent Articles Section -->
+  <div class="space-y-4">
+    <div class="flex items-center justify-between">
+      <div>
+        <h2 class="text-lg font-semibold text-zinc-900">Recent Articles</h2>
+        <p class="text-xs text-zinc-500">Latest content items updated or created in the engine.</p>
+      </div>
+      <% if @articles_count > 0 %>
+        <%= link_to "View all articles &rarr;".html_safe, articles_path, class: "text-sm font-medium text-zinc-700 hover:text-zinc-900 transition-colors" %>
+      <% end %>
+    </div>
+
+    <%= render "macron/cms/articles/table", articles: @recent_articles %>
+  </div>
+</div>

data/app/views/macron/cms/fields/_string.html.erb

@@ -0,0 +1,14 @@
+<div class="space-y-1.5">
+  <label for="<%= input_id %>" class="block text-xs font-mono font-semibold text-zinc-700">
+    <%= field_name %>
+    <span class="ml-1 text-[10px] font-normal text-zinc-400">(string)</span>
+  </label>
+  <input
+    type="text"
+    name="<%= input_name %>"
+    id="<%= input_id %>"
+    value="<%= value %>"
+    class="block w-full rounded-lg border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 shadow-2xs placeholder:text-zinc-400 focus:border-zinc-900 focus:outline-none focus:ring-1 focus:ring-zinc-900"
+    placeholder="Enter <%= field_name.to_s.humanize.downcase %>..."
+  />
+</div>

data/app/views/macron/cms/fields/_text.html.erb

@@ -0,0 +1,13 @@
+<div class="space-y-1.5">
+  <label for="<%= input_id %>" class="block text-xs font-mono font-semibold text-zinc-700">
+    <%= field_name %>
+    <span class="ml-1 text-[10px] font-normal text-zinc-400">(text)</span>
+  </label>
+  <textarea
+    name="<%= input_name %>"
+    id="<%= input_id %>"
+    rows="4"
+    class="block w-full rounded-lg border border-zinc-300 bg-white px-3 py-2 text-sm text-zinc-900 shadow-2xs placeholder:text-zinc-400 focus:border-zinc-900 focus:outline-none focus:ring-1 focus:ring-zinc-900"
+    placeholder="Enter <%= field_name.to_s.humanize.downcase %>..."
+  ><%= value %></textarea>
+</div>

data/app/views/macron/cms/shared/_breadcrumbs.html.erb

@@ -0,0 +1,14 @@
+<% if cms_breadcrumbs.any? %>
+  <% cms_breadcrumbs.each_with_index do |crumb, index| %>
+    <% if index > 0 %>
+      <span class="text-zinc-400 select-none">/</span>
+    <% end %>
+    <% if index == cms_breadcrumbs.size - 1 || crumb[:path].blank? %>
+      <span class="font-medium text-zinc-900 truncate max-w-xs sm:max-w-md"><%= crumb[:label] %></span>
+    <% else %>
+      <%= link_to crumb[:label], crumb[:path], class: "hover:text-zinc-900 transition-colors" %>
+    <% end %>
+  <% end %>
+<% else %>
+  <span class="font-medium text-zinc-900"><%= content_for(:header_title) || "Overview" %></span>
+<% end %>

data/config/routes.rb

@@ -0,0 +1,14 @@
+Macron::Cms::Engine.routes.draw do
+  root to: "dashboard#index"
+  resources :articles do
+    resources :article_contents, only: %i[create update destroy] do
+      member do
+        patch :move
+      end
+      collection do
+        patch :reorder
+      end
+    end
+  end
+  resources :content_types, only: %i[index show]
+end

data/db/migrate/20261028000001_create_macron_cms_articles.rb

@@ -0,0 +1,9 @@
+class CreateMacronCmsArticles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :macron_cms_articles do |t|
+      t.string :title, null: false
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20261028000002_add_name_and_slug_to_macron_cms_articles.rb

@@ -0,0 +1,8 @@
+class AddNameAndSlugToMacronCmsArticles < ActiveRecord::Migration[8.0]
+  def change
+    add_column :macron_cms_articles, :name, :string, null: false
+    add_column :macron_cms_articles, :slug, :string, null: false
+    add_index :macron_cms_articles, :name, unique: true
+    add_index :macron_cms_articles, :slug, unique: true
+  end
+end

data/db/migrate/20261028000003_add_seo_metadata_to_macron_cms_articles.rb

@@ -0,0 +1,6 @@
+class AddSeoMetadataToMacronCmsArticles < ActiveRecord::Migration[8.1]
+  def change
+    add_column :macron_cms_articles, :meta_title, :string
+    add_column :macron_cms_articles, :meta_description, :text
+  end
+end

data/db/migrate/20261028000004_create_macron_cms_contents.rb

@@ -0,0 +1,13 @@
+class CreateMacronCmsContents < ActiveRecord::Migration[8.0]
+  def change
+    create_table :macron_cms_contents do |t|
+      t.string :name, null: false
+      t.jsonb :fields, default: {}, null: false
+      t.jsonb :payload, default: {}, null: false
+
+      t.timestamps
+    end
+
+    add_index :macron_cms_contents, :name, unique: true
+  end
+end

data/db/migrate/20261028000005_create_macron_cms_article_contents.rb

@@ -0,0 +1,13 @@
+class CreateMacronCmsArticleContents < ActiveRecord::Migration[8.0]
+  def change
+    create_table :macron_cms_article_contents do |t|
+      t.references :article, null: false, foreign_key: { to_table: :macron_cms_articles }
+      t.references :content, null: false, foreign_key: { to_table: :macron_cms_contents }
+      t.integer :sort_order, default: 0, null: false
+
+      t.timestamps
+    end
+
+    add_index :macron_cms_article_contents, [ :article_id, :sort_order ]
+  end
+end

data/db/migrate/20261028000006_move_payload_to_macron_cms_article_contents.rb

@@ -0,0 +1,6 @@
+class MovePayloadToMacronCmsArticleContents < ActiveRecord::Migration[8.0]
+  def change
+    add_column :macron_cms_article_contents, :payload, :jsonb, default: {}, null: false
+    remove_column :macron_cms_contents, :payload, :jsonb, default: {}, null: false
+  end
+end

data/db/seeds.rb

@@ -0,0 +1,83 @@
+articles = [
+  {
+    title: "Getting Started with MacronCMS",
+    meta_title: "Getting Started with MacronCMS | Rails 8 Content Engine",
+    meta_description: "Discover how to install, configure, and build interactive content architectures with MacronCMS on Rails 8."
+  },
+  {
+    title: "Designing Content Structures with Rails 8",
+    meta_title: "Designing Content Structures with Rails 8 | MacronCMS Guide",
+    meta_description: "A comprehensive guide to modeling content hierarchies, flexible attributes, and schema migrations in Rails 8."
+  },
+  {
+    title: "The wp_loop Architecture: Clean Content Iteration",
+    meta_title: "Understanding The wp_loop Architecture in Rails | MacronCMS",
+    meta_description: "Explore the wp_loop-inspired data pattern for declarative, clean, and decoupled content iteration in Ruby on Rails."
+  },
+  {
+    title: "Hydrating React and Three.js in Modern Server-Rendered Views",
+    meta_title: "Hydrating React and Three.js in Rails Views | MacronCMS",
+    meta_description: "Seamlessly integrate interactive React components and Three.js 3D scenes into server-rendered Rails templates."
+  },
+  {
+    title: "Tailwind CSS Layouts for Dynamic Content",
+    meta_title: "Tailwind CSS Layouts for Dynamic Content Publishing | MacronCMS",
+    meta_description: "Master modern utility-first typography, fluid layouts, and responsive components for publishing with Tailwind CSS."
+  },
+  {
+    title: "High-Performance Publishing with Hotwire and Turbo",
+    meta_title: "High-Performance Publishing with Hotwire & Turbo | MacronCMS",
+    meta_description: "Boost site speed and user experience by leveraging Turbo Drive, Turbo Frames, and Turbo Streams in your CMS."
+  },
+  {
+    title: "Migrating Legacy Content into MacronCMS with AI Agents",
+    meta_title: "Migrating Legacy Content with AI Agents | MacronCMS",
+    meta_description: "How to use autonomous AI agents to transform, clean, and import unstructured legacy datasets into MacronCMS."
+  },
+  {
+    title: "Building Accessible Digital Experiences with Rails",
+    meta_title: "Building Accessible Web Experiences with Rails | MacronCMS",
+    meta_description: "Best practices and strategies for building WCAG-compliant, accessible content layouts and UI controls in Rails."
+  },
+  {
+    title: "Optimizing Content Queries and Asset Pipelines",
+    meta_title: "Optimizing Content Queries and Asset Pipelines | MacronCMS",
+    meta_description: "Techniques for eliminating N+1 queries, optimizing cache keys, and streamlining modern asset delivery pipelines."
+  },
+  {
+    title: "The Future of Developer-First Content Management Systems",
+    meta_title: "The Future of Developer-First CMS Platforms | MacronCMS",
+    meta_description: "An editorial on modularity, headless workflows, AI integration, and the evolution of developer-first CMS platforms."
+  }
+]
+
+articles.each do |data|
+  article = Macron::Cms::Article.find_or_initialize_by(name: data[:title].parameterize)
+  article.title = data[:title]
+  article.meta_title = data[:meta_title]
+  article.meta_description = data[:meta_description]
+  article.save!
+end
+
+puts "Seeded #{Macron::Cms::Article.count} Macron::Cms articles."
+
+user_class_name = Macron::Cms.configuration.user_class
+user_class = user_class_name.safe_constantize
+
+if user_class
+  admin_flag = Macron::Cms.configuration.admin_flag
+
+  admin_user = user_class.find_or_initialize_by(email: "admin@example.com")
+  admin_user.password = "password" if admin_user.respond_to?(:password=)
+  admin_user.password_confirmation = "password" if admin_user.respond_to?(:password_confirmation=)
+  admin_user.public_send(:"#{admin_flag}=", true) if admin_user.respond_to?(:"#{admin_flag}=")
+  admin_user.save!
+
+  regular_user = user_class.find_or_initialize_by(email: "user@example.com")
+  regular_user.password = "password" if regular_user.respond_to?(:password=)
+  regular_user.password_confirmation = "password" if regular_user.respond_to?(:password_confirmation=)
+  regular_user.public_send(:"#{admin_flag}=", false) if regular_user.respond_to?(:"#{admin_flag}=")
+  regular_user.save!
+
+  puts "Seeded test users (admin: admin@example.com, regular: user@example.com)."
+end

data/lib/generators/macron/cms/content_type/content_type_generator.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require "rails/generators/named_base"
+
+module Macron
+  module Cms
+    module Generators
+      class ContentTypeGenerator < ::Rails::Generators::NamedBase
+        desc "Generates a Macron CMS content type YAML definition file and a matching ViewComponent widget in app/components/widgets/."
+
+        argument :fields, type: :array, default: [], banner: "field:kind field:kind"
+
+        def create_content_type_file
+          parsed = parse_and_validate_fields
+          target_path = File.join(base_directory.to_s, "#{file_name}.yml")
+          create_file target_path, build_yaml(parsed)
+        end
+
+        def create_widget_component_files
+          parsed = parse_and_validate_fields
+          component_path = File.join("app/components/widgets", "#{file_name}_component.rb")
+          template_path = File.join("app/components/widgets", "#{file_name}_component.html.erb")
+
+          create_file component_path, build_widget_ruby
+          create_file template_path, build_widget_template(parsed)
+        end
+
+        private
+
+        def base_directory
+          Macron::Cms.configuration.content_types_path || "config/content_types"
+        end
+
+        def parse_and_validate_fields
+          @parsed_fields ||= fields.map do |field|
+            parts = field.split(":", 2)
+            if parts.length != 2 || parts[0].blank? || parts[1].blank?
+              raise Thor::Error, "Invalid field '#{field}'. Fields must be in the format 'name:kind' (e.g. title:string)."
+            end
+
+            { "name" => parts[0], "kind" => parts[1] }
+          end
+        end
+
+        def build_yaml(parsed_fields)
+          if parsed_fields.empty?
+            "fields: []\n"
+          else
+            lines = [ "fields:" ]
+            parsed_fields.each do |f|
+              lines << "  - name: '#{f['name']}'"
+              lines << "    kind: '#{f['kind']}'"
+            end
+            "#{lines.join("\n")}\n"
+          end
+        end
+
+        def build_widget_ruby
+          <<~RUBY
+            module Widgets
+              class #{file_name.camelize}Component < Macron::Cms::WidgetComponent
+              end
+            end
+          RUBY
+        end
+
+        def build_widget_template(parsed_fields)
+          if parsed_fields.empty?
+            <<~ERB
+              <div class="my-4">
+                <!-- #{file_name.camelize} Widget -->
+              </div>
+            ERB
+          else
+            field_tags = parsed_fields.map do |f|
+              "  <p><%= #{f['name']} %></p>"
+            end
+            <<~ERB
+              <div class="my-4">
+              #{field_tags.join("\n")}
+              </div>
+            ERB
+          end
+        end
+      end
+    end
+  end
+end

data/lib/macron/cms/configuration.rb

@@ -0,0 +1,25 @@
+module Macron
+  module Cms
+    class Configuration
+      attr_accessor :user_class, :admin_flag, :content_types_path
+
+      def initialize
+        @user_class = "User"
+        @admin_flag = :admin
+        @content_types_path = nil
+      end
+
+      def devise_scope
+        user_class.to_s.underscore.to_sym
+      end
+
+      def authenticate_method
+        :"authenticate_#{devise_scope}!"
+      end
+
+      def current_user_method
+        :"current_#{devise_scope}"
+      end
+    end
+  end
+end

data/lib/macron/cms/engine.rb

@@ -0,0 +1,20 @@
+module Macron
+  module Cms
+    class Engine < ::Rails::Engine
+      isolate_namespace Macron::Cms
+
+      initializer :append_migrations do |app|
+        config.paths["db/migrate"].expanded.each do |expanded_path|
+          app.config.paths["db/migrate"] << expanded_path
+        end
+      end
+
+      initializer "macron_cms.helpers" do
+        ActiveSupport.on_load(:action_view) do
+          include Macron::Cms::SeoHelper
+          include Macron::Cms::ContentHelper
+        end
+      end
+    end
+  end
+end

data/lib/macron/cms/version.rb

@@ -0,0 +1,5 @@
+module Macron
+  module Cms
+    VERSION = "1.0.0"
+  end
+end

data/lib/macron/cms.rb

@@ -0,0 +1,26 @@
+require "friendly_id"
+require "devise"
+require "view_component"
+require "macron/cms/version"
+require "macron/cms/configuration"
+require "macron/cms/engine"
+
+module Macron
+  module Cms
+    class MissingWidgetError < StandardError; end
+
+    class << self
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      def configure
+        yield(configuration)
+      end
+
+      def reset_configuration!
+        @configuration = Configuration.new
+      end
+    end
+  end
+end

data/lib/tasks/macron/cms_tasks.rake

@@ -0,0 +1,75 @@
+namespace :macron do
+  namespace :cms do
+    desc "Import content types from YAML files into Macron::Cms::Content"
+    task import_content_types: :environment do
+      require "yaml"
+
+      base_path = Macron::Cms.configuration.content_types_path ||
+                  (defined?(Rails.root) && Rails.root ? Rails.root.join("config", "content_types") : File.expand_path("config/content_types"))
+      directory = Pathname.new(base_path)
+
+      unless directory.exist?
+        puts "Content types directory '#{directory}' does not exist. Skipping import."
+        next
+      end
+
+      files = Dir.glob(directory.join("*.{yml,yaml}")).sort
+
+      if files.empty?
+        puts "No YAML content types found in #{directory}."
+        next
+      end
+
+      files.each do |file|
+        content_type_name = File.basename(file, ".*")
+        data = YAML.safe_load_file(file, permitted_classes: [ Symbol ], aliases: true) || {}
+        fields = data["fields"] || data[:fields] || {}
+
+        content = Macron::Cms::Content.find_or_initialize_by(name: content_type_name)
+        content.fields = fields
+        content.save!
+
+        puts "Imported content type: #{content_type_name}"
+      end
+    end
+
+    namespace :content do
+      desc "Alias for macron:cms:import_content_types"
+      task import: :"macron:cms:import_content_types"
+    end
+
+    namespace :tailwind do
+      def tailwind_executable
+        require "tailwindcss/ruby"
+        Tailwindcss::Ruby.executable
+      rescue LoadError
+        "tailwindcss"
+      end
+
+      desc "Build Macron CMS Tailwind CSS"
+      task :build do
+        engine_root = File.expand_path("../../..", __dir__)
+        input = File.join(engine_root, "app/assets/tailwind/macron/cms/application.css")
+        output = File.join(engine_root, "app/assets/stylesheets/macron/cms/application.css")
+
+        exe = tailwind_executable
+        cmd = [ exe, "-i", input, "-o", output, "--minify" ]
+        puts "Building Macron CMS Tailwind CSS..."
+        success = system(*cmd, chdir: engine_root)
+        abort("Tailwind build failed") unless success
+      end
+
+      desc "Watch Macron CMS Tailwind CSS for changes"
+      task :watch do
+        engine_root = File.expand_path("../../..", __dir__)
+        input = File.join(engine_root, "app/assets/tailwind/macron/cms/application.css")
+        output = File.join(engine_root, "app/assets/stylesheets/macron/cms/application.css")
+
+        exe = tailwind_executable
+        cmd = [ exe, "-i", input, "-o", output, "-w" ]
+        puts "Watching Macron CMS Tailwind CSS..."
+        system(*cmd, chdir: engine_root)
+      end
+    end
+  end
+end