RubyGems - social_construct - Versions diffs - 0.1.0 - Mend

social_construct 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 10cb6057e914282f135714277ab5459c5794e1892a4a2a0825c24cc64ec6259c
+  data.tar.gz: 239310809089b66d572365265074e18a32d1ddc7c693374d60090276a38d793f
+SHA512:
+  metadata.gz: f269fe451a28fae49d20e8c78953b810fe39c7db26559c80d8f555a8cc03ec9f0d80ce811ff6aa94466ba815fd6b4dfe4c19542477878729201b52f70dfbf4aa
+  data.tar.gz: 868aa2dd22efbae1a7e105c8d10f0cfb2bbeee80f71386acdc44c1205b8672a279eefbca334255255230808863d5bde084de1b3ab5c936da39359d5da5dd4f32

data/README.md ADDED Viewed

@@ -0,0 +1,190 @@
+# SocialConstruct
+A Rails engine for generating social media preview cards (Open Graph images) with built-in preview functionality.
+## Installation
+Add to your Gemfile:
+```ruby
+gem "social_construct"
+```
+Run the installation generator:
+```bash
+bundle install
+bin/rails generate social_construct:install
+```
+This will:
+- Create a configuration initializer
+- Set up ApplicationSocialCard base class
+- Create an example social card with template
+- Add a shared layout for social cards
+- Mount the preview interface in development
+- Create example preview classes
+## Usage
+### 1. Create your base social card class
+```ruby
+# app/social_cards/application_social_card.rb
+class ApplicationSocialCard < SocialConstruct::BaseCard
+  include SocialConstruct::CardConcerns
+  # Set the logo path for your application
+  self.logo_path = Rails.root.join("app/assets/images/logo.png")
+end
+```
+### 2. Create specific social card classes
+```ruby
+# app/social_cards/item_social_card.rb
+class ItemSocialCard < ApplicationSocialCard
+  def initialize(item)
+    super()
+    @item = item
+  end
+  private
+  def template_assigns
+    {
+      item: @item,
+      cover_image_data_url: image_to_data_url(@item.cover_image, resize_to_limit: [480, 630], saver: {quality: 75}),
+      logo_data_url: logo_data_url
+    }
+  end
+end
+```
+### 3. Create templates
+Templates go in `app/views/social_cards/` and should match your class names:
+```erb
+<!-- app/views/social_cards/item_social_card.html.erb -->
+<div class="card">
+  <h1><%= item.title %></h1>
+  <!-- Your card HTML -->
+</div>
+```
+### 4. Optional: Use a shared layout
+Create `app/views/layouts/social_cards.html.erb` for shared HTML structure:
+```erb
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+    <style>
+      /* Shared styles */
+    </style>
+    <%= yield :head %>
+  </head>
+  <body>
+    <%= yield %>
+  </body>
+</html>
+```
+### 5. Create preview classes for development
+```ruby
+# app/social_cards/previews/item_social_card_preview.rb
+class ItemSocialCardPreview
+  def default
+    item = Item.first || Item.new(title: "Example Item")
+    ItemSocialCard.new(item)
+  end
+  def with_long_title
+    item = Item.new(title: "This is a very long title that will test text wrapping")
+    ItemSocialCard.new(item)
+  end
+end
+```
+Visit `/rails/social_cards` in development to see all your previews.
+### 6. Use in your controllers
+Include the controller concern:
+```ruby
+class ItemsController < ApplicationController
+  include SocialConstruct::Controller
+  def og
+    @item = Item.find(params[:id])
+    render ItemSocialCard.new(@item)
+  end
+end
+```
+The `render` method automatically handles both formats:
+- `.png` - Generates the actual PNG image
+- `.html` - Shows the HTML preview (useful for debugging)
+Or with caching:
+```ruby
+def og
+  @item = Item.find(params[:id])
+  cache_key = [
+    "social-cards",
+    "item",
+    @item.id,
+    @item.updated_at.to_i
+  ]
+  render ItemSocialCard.new(@item), cache_key: cache_key
+end
+```
+Alternative API:
+```ruby
+def og
+  @item = Item.find(params[:id])
+  card = ItemSocialCard.new(@item)
+  send_social_card(card,
+    cache_key: ["social-cards", @item.id, @item.updated_at.to_i],
+    expires_in: 7.days
+  )
+end
+```
+## Configuration
+Configure in your initializer:
+```ruby
+# config/initializers/social_construct.rb
+# Template path (default: "social_cards")
+Rails.application.config.social_construct.template_path = "custom_path"
+# Enable debug logging (default: false)
+SocialConstruct::BaseCard.debug = true
+```
+## Requirements
+- Rails 7.0+
+- Ferrum (headless Chrome driver)
+- Marcel (MIME type detection)
+## License
+MIT

data/Rakefile ADDED Viewed

@@ -0,0 +1,8 @@
+require "bundler/setup"
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load("rails/tasks/engine.rake")
+load("rails/tasks/statistics.rake")
+require "bundler/gem_tasks"

data/app/controllers/concerns/social_construct/controller.rb ADDED Viewed

@@ -0,0 +1,66 @@
+module SocialConstruct
+  module Controller
+    extend ActiveSupport::Concern
+    included do
+      # Register social card mime type if not already registered
+      Mime::Type.register "image/png", :png unless Mime[:png]
+    end
+    # Render a social card as PNG with caching support
+    def send_social_card(card, cache_key: nil, expires_in: 7.days, cache_in_development: false)
+      # Build cache key if provided
+      if cache_key && (!Rails.env.development? || cache_in_development)
+        cache_key = Array(cache_key).join("-") if cache_key.is_a?(Array)
+        png_data = Rails.cache.fetch(cache_key, expires_in: expires_in) do
+          card.to_png
+        end
+      else
+        png_data = card.to_png
+      end
+      # Set caching headers
+      expires_in(1.day, public: true) unless Rails.env.development?
+      send_data(
+        png_data,
+        type: "image/png",
+        disposition: "inline",
+        filename: "#{controller_name.singularize}-social-card.png"
+      )
+    rescue => e
+      handle_social_card_error(e)
+    end
+    # Allow using render with social cards
+    def render(*args)
+      if args.first.is_a?(SocialConstruct::BaseCard)
+        card = args.first
+        options = args.second || {}
+        respond_to do |format|
+          format.png { send_social_card(card, **options) }
+          format.html { render(html: card.render.html_safe, layout: false) }
+        end
+      else
+        super
+      end
+    end
+    private
+    def handle_social_card_error(error)
+      Rails.logger.error("Social card generation failed: #{error.message}")
+      # Send a fallback 1x1 transparent PNG
+      send_data(
+        Base64.decode64(
+          "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="
+        ),
+        type: "image/png",
+        disposition: "inline"
+      )
+    end
+  end
+end

data/app/controllers/social_construct/previews_controller.rb ADDED Viewed

@@ -0,0 +1,61 @@
+module SocialConstruct
+  class PreviewsController < ActionController::Base
+    def index
+      @preview_classes = find_preview_classes
+    end
+    def show
+      @preview_class = find_preview_class(params[:preview_name])
+      @preview_name = params[:preview_name]
+      unless @preview_class
+        redirect_to(previews_path, alert: "Preview not found")
+        return
+      end
+      @examples = @preview_class.instance_methods(false).sort
+    end
+    def preview
+      preview_class = find_preview_class(params[:preview_name])
+      example_name = params[:example_name]
+      unless preview_class && example_name
+        redirect_to(previews_path, alert: "Preview not found")
+        return
+      end
+      @card = preview_class.new.send(example_name)
+      respond_to do |format|
+        format.html { render(html: @card.render.html_safe, layout: false) }
+        format.png { send_data(@card.to_png, type: "image/png", disposition: "inline") }
+      end
+    end
+    private
+    def find_preview_classes
+      # Look for preview classes in the host app
+      preview_path = Rails.root.join("app/social_cards/previews")
+      return [] unless preview_path.exist?
+      Dir[preview_path.join("*_preview.rb")]
+        .map do |file|
+          require_dependency(file)
+          class_name = File.basename(file, ".rb").camelize
+          class_name.constantize if Object.const_defined?(class_name)
+        end
+        .compact
+    end
+    def find_preview_class(name)
+      return nil unless name
+      class_name = "#{name.camelize}Preview"
+      class_name.constantize if Object.const_defined?(class_name)
+    rescue NameError
+      nil
+    end
+  end
+end

data/app/models/social_construct/base_card.rb ADDED Viewed

@@ -0,0 +1,211 @@
+require "base64"
+require "tempfile"
+module SocialConstruct
+  class BaseCard
+    include ActionView::Helpers
+    include Rails.application.routes.url_helpers
+    attr_reader :width, :height
+    # Class-level debug setting
+    cattr_accessor :debug, default: false
+    def initialize
+      @width = 1200
+      @height = 630
+    end
+    def render
+      ApplicationController.render(
+        template: template_name,
+        layout: layout_name,
+        locals: template_assigns.merge(
+          default_url_options: Rails.application.config.action_controller.default_url_options
+        )
+      )
+    end
+    def to_png
+      log_debug("Starting PNG generation for #{self.class.name}")
+      # Use 1x resolution for better performance and reliability
+      browser_options = {
+        headless: true,
+        timeout: 30,
+        window_size: [@width, @height]
+      }
+      # Add Docker-specific options in production
+      if Rails.env.production? || ENV["DOCKER_CONTAINER"].present?
+        browser_options[:browser_options] = {
+          :"no-sandbox" => nil,
+          :"disable-dev-shm-usage" => nil,
+          :"disable-gpu" => nil,
+          :"disable-software-rasterizer" => nil,
+          :"disable-web-security" => nil,
+          :"force-color-profile" => "srgb"
+        }
+        log_debug("Using production browser options")
+      end
+      browser = Ferrum::Browser.new(browser_options)
+      html_content = render
+      log_debug("HTML content length: #{html_content.length} bytes")
+      log_debug("HTML encoding: #{html_content.encoding}")
+      # For large HTML content (with embedded images), use a temp file instead of data URL
+      # 1MB threshold
+      if html_content.length > 1_000_000
+        log_debug("HTML too large for data URL, using temp file")
+        require "tempfile"
+        temp_file = Tempfile.new(["social_card", ".html"])
+        temp_file.write(html_content)
+        temp_file.rewind
+        temp_file.close
+        begin
+          browser.goto("file://#{temp_file.path}")
+        ensure
+          # Will be deleted after browser loads it
+          temp_file.unlink
+        end
+      else
+        # Ensure UTF-8 encoding
+        html_content = html_content.force_encoding("UTF-8")
+        encoded_html = ERB::Util.url_encode(html_content)
+        browser.goto("data:text/html;charset=utf-8,#{encoded_html}")
+      end
+      browser.set_viewport(width: @width, height: @height)
+      # Wait for the page to fully load
+      browser.network.wait_for_idle
+      # Add extra wait for complex pages with large images
+      sleep(0.5)
+      # Log page readiness
+      if debug
+        page_ready = browser.evaluate("document.readyState")
+        log_debug("Page ready state: #{page_ready}")
+        # Log computed styles to check if CSS is applied
+        body_bg = browser.evaluate("window.getComputedStyle(document.body).backgroundColor")
+        log_debug("Body background color: #{body_bg}")
+        # Check if content is visible
+        has_title = browser.evaluate("!!document.querySelector('.title')")
+        title_text = browser.evaluate("document.querySelector('.title')?.textContent") if has_title
+        log_debug("Has title element: #{has_title}, Title text: #{title_text}")
+        # Check HTML body content
+        body_html_length = browser.evaluate("document.body.innerHTML.length")
+        log_debug("Body HTML length: #{body_html_length}")
+      end
+      screenshot = browser.screenshot(
+        encoding: :binary,
+        quality: 100,
+        full: false
+      )
+      log_debug("Screenshot generated, size: #{screenshot.bytesize} bytes")
+      # Check if screenshot might be blank (very small file size indicates mostly white/single color)
+      # Less than 10KB usually means it's mostly one color
+      if screenshot.bytesize < 10_000
+        log_debug("Screenshot seems too small, might be blank. Retrying with delay...", :warn)
+        # Wait a bit more and try again
+        sleep(1)
+        # Force a paint
+        browser.execute(
+          "document.body.style.display = 'none'; document.body.offsetHeight; document.body.style.display = 'flex';"
+        )
+        screenshot = browser.screenshot(
+          encoding: :binary,
+          quality: 100,
+          full: false
+        )
+        log_debug("Retry screenshot size: #{screenshot.bytesize} bytes")
+      end
+      screenshot
+    rescue => e
+      log_debug("Ferrum screenshot failed: #{e.message}", :error)
+      log_debug("Backtrace: #{e.backtrace.first(5).join("\n")}", :error) if debug
+      raise
+    ensure
+      browser&.quit
+    end
+    private
+    def template_name
+      # Use configured template path from engine
+      template_path = Rails.application.config.social_construct.template_path
+      "#{template_path}/#{self.class.name.demodulize.underscore}"
+    end
+    def layout_name
+      # Check if a social cards layout exists
+      layout_path = "layouts/#{Rails.application.config.social_construct.template_path}"
+      if template_exists?(layout_path)
+        layout_path
+      else
+        false
+      end
+    end
+    def template_exists?(path)
+      ApplicationController.view_paths.any? do |resolver|
+        resolver.find_all(path, [], false, locale: [], formats: [:html], variants: [], handlers: [:erb]).any?
+      end
+    rescue
+      false
+    end
+    def template_assigns
+      {}
+    end
+    def image_to_data_url(attachment, variant_options = {})
+      return nil unless attachment.attached?
+      begin
+        # Ensure high quality defaults
+        options = {
+          saver: {quality: 90, strip: true}
+        }.deep_merge(variant_options)
+        variant = attachment.variant(options)
+        blob = variant.processed
+        content_type = blob.content_type || "image/jpeg"
+        image_data = blob.download
+        "data:#{content_type};base64,#{Base64.strict_encode64(image_data)}"
+      rescue => e
+        log_debug("Failed to convert image to data URL: #{e.message}", :error)
+        nil
+      end
+    end
+    def template_path
+      Rails.application.config.social_construct.template_path
+    end
+    def log_debug(message, level = :info)
+      return unless debug
+      Rails.logger.send(level, "[SocialCard] #{message}")
+    end
+  end
+end

data/app/views/social_construct/previews/index.html.erb ADDED Viewed

@@ -0,0 +1,53 @@
+<!DOCTYPE html>
+<html class="h-full">
+<head>
+  <title>Social Card Previews</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+</head>
+<body class="h-full bg-gray-50">
+  <div class="min-h-full">
+    <header class="bg-white shadow-sm">
+      <div class="mx-auto max-w-7xl px-4 py-4 sm:px-6 lg:px-8">
+        <h1 class="text-2xl font-semibold leading-6 text-gray-900">Social Card Previews</h1>
+      </div>
+    </header>
+    <main class="mx-auto max-w-7xl px-4 py-8 sm:px-6 lg:px-8">
+      <div class="overflow-hidden bg-white shadow rounded-lg">
+        <% if @preview_classes.any? %>
+          <ul role="list" class="divide-y divide-gray-200">
+            <% @preview_classes.each do |preview_class| %>
+              <li class="px-6 py-4 hover:bg-gray-50">
+                <% preview_name = preview_class.name.underscore.sub(/_preview$/, '') %>
+                <%= link_to social_construct.preview_path(preview_name), class: "block" do %>
+                  <div class="flex items-center justify-between">
+                    <div>
+                      <p class="text-lg font-medium text-indigo-600 hover:text-indigo-500">
+                        <%= preview_class.name.sub(/Preview$/, '').underscore.humanize %>
+                      </p>
+                      <p class="mt-1 text-sm text-gray-500">
+                        <%= preview_class.name %>
+                      </p>
+                    </div>
+                    <svg class="h-5 w-5 text-gray-400" fill="currentColor" viewBox="0 0 20 20">
+                      <path fill-rule="evenodd" d="M7.21 14.77a.75.75 0 01.02-1.06L11.168 10 7.23 6.29a.75.75 0 111.04-1.08l4.5 4.25a.75.75 0 010 1.08l-4.5 4.25a.75.75 0 01-1.06-.02z" clip-rule="evenodd" />
+                    </svg>
+                  </div>
+                <% end %>
+              </li>
+            <% end %>
+          </ul>
+        <% else %>
+          <div class="px-6 py-12 text-center">
+            <svg class="mx-auto h-12 w-12 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path>
+            </svg>
+            <h3 class="mt-2 text-sm font-semibold text-gray-900">No preview classes</h3>
+            <p class="mt-1 text-sm text-gray-500">Create preview classes in <code class="font-mono text-xs">app/social_cards/previews/</code></p>
+          </div>
+        <% end %>
+      </div>
+    </main>
+  </div>
+</body>
+</html>

data/app/views/social_construct/previews/show.html.erb ADDED Viewed

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html class="h-full">
+<head>
+  <title><%= @preview_class.name.sub(/Preview$/, '').underscore.humanize %> - Social Card Previews</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+</head>
+<body class="h-full bg-gray-50">
+  <div class="min-h-full">
+    <header class="bg-white shadow-sm">
+      <div class="mx-auto max-w-7xl px-4 py-4 sm:px-6 lg:px-8">
+        <nav class="mb-4">
+          <%= link_to social_construct.previews_path, class: "inline-flex items-center text-sm font-medium text-gray-500 hover:text-gray-700" do %>
+            <svg class="mr-1 h-4 w-4" fill="currentColor" viewBox="0 0 20 20">
+              <path fill-rule="evenodd" d="M12.79 5.23a.75.75 0 01-.02 1.06L8.832 10l3.938 3.71a.75.75 0 11-1.04 1.08l-4.5-4.25a.75.75 0 010-1.08l4.5-4.25a.75.75 0 011.06.02z" clip-rule="evenodd" />
+            </svg>
+            Back to all previews
+          <% end %>
+        </nav>
+        <h1 class="text-2xl font-semibold leading-6 text-gray-900"><%= @preview_class.name.sub(/Preview$/, '').underscore.humanize %></h1>
+      </div>
+    </header>
+    <main class="mx-auto max-w-7xl px-4 py-8 sm:px-6 lg:px-8">
+      <div class="overflow-hidden bg-white shadow rounded-lg">
+        <ul role="list" class="divide-y divide-gray-200">
+          <% @examples.each do |example| %>
+            <li class="px-6 py-4">
+              <div class="flex items-center justify-between">
+                <div>
+                  <%= link_to social_construct.example_preview_path(@preview_name, example), class: "text-lg font-medium text-indigo-600 hover:text-indigo-500" do %>
+                    <%= example.to_s.humanize %>
+                  <% end %>
+                </div>
+                <div class="ml-4 flex flex-shrink-0 space-x-2">
+                  <%= link_to social_construct.example_preview_path(@preview_name, example, format: :html), class: "inline-flex items-center rounded-md bg-white px-2.5 py-1.5 text-sm font-semibold text-gray-900 shadow-sm ring-1 ring-inset ring-gray-300 hover:bg-gray-50" do %>
+                    <svg class="-ml-0.5 mr-1.5 h-4 w-4 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                      <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4"></path>
+                    </svg>
+                    HTML
+                  <% end %>
+                  <%= link_to social_construct.example_preview_path(@preview_name, example, format: :png), class: "inline-flex items-center rounded-md bg-indigo-600 px-2.5 py-1.5 text-sm font-semibold text-white shadow-sm hover:bg-indigo-500" do %>
+                    <svg class="-ml-0.5 mr-1.5 h-4 w-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                      <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16l4.586-4.586a2 2 0 012.828 0L16 16m-2-2l1.586-1.586a2 2 0 012.828 0L20 14m-6-6h.01M6 20h12a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v12a2 2 0 002 2z"></path>
+                    </svg>
+                    PNG
+                  <% end %>
+                </div>
+              </div>
+            </li>
+          <% end %>
+        </ul>
+      </div>
+    </main>
+  </div>
+</body>
+</html>

data/config/routes.rb ADDED Viewed

@@ -0,0 +1,7 @@
+SocialConstruct::Engine.routes.draw do
+  resources(:previews, only: [:index, :show], param: :preview_name) do
+    member do
+      get(":example_name", action: :preview, as: :example)
+    end
+  end
+end

data/lib/generators/social_construct/install/install_generator.rb ADDED Viewed

@@ -0,0 +1,51 @@
+require "rails/generators/base"
+module SocialConstruct
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      desc "Creates SocialConstruct initializer, base classes, and example files"
+      def create_initializer_file
+        template("social_construct.rb", "config/initializers/social_construct.rb")
+      end
+      def create_application_social_card
+        template("application_social_card.rb", "app/social_cards/application_social_card.rb")
+      end
+      def create_example_social_card
+        template("example_social_card.rb", "app/social_cards/example_social_card.rb")
+      end
+      def create_example_template
+        template("example_social_card.html.erb", "app/views/social_cards/example_social_card.html.erb")
+      end
+      def create_social_cards_layout
+        template("social_cards_layout.html.erb", "app/views/layouts/social_cards.html.erb")
+      end
+      def create_example_preview
+        template("example_social_card_preview.rb", "app/social_cards/previews/example_social_card_preview.rb")
+      end
+      def add_route
+        route_string = <<-RUBY
+  # Social card previews (development only)
+  if Rails.env.development?
+    mount SocialConstruct::Engine, at: "/rails/social_cards"
+  end
+        RUBY
+        route(route_string)
+      end
+      def display_post_install
+        readme("POST_INSTALL") if behavior == :invoke
+      end
+    end
+  end
+end

data/lib/generators/social_construct/install/templates/POST_INSTALL ADDED Viewed

@@ -0,0 +1,34 @@
+===============================================================================
+  SocialConstruct has been successfully installed! 🎉
+  Next steps:
+  1. Update the logo path in app/social_cards/application_social_card.rb
+     to point to your actual logo file.
+  2. Run your Rails server and visit:
+     http://localhost:3000/rails/social_cards
+     You should see the example social card previews.
+  3. Create your own social card classes:
+     - Inherit from ApplicationSocialCard
+     - Create matching templates in app/views/social_cards/
+     - Add preview classes in app/social_cards/previews/
+  4. Use in your controllers:
+     class YourController < ApplicationController
+       include SocialConstruct::Controller
+       def og
+         @model = Model.find(params[:id])
+         render YourSocialCard.new(@model)
+       end
+     end
+  For more information, see:
+  https://github.com/brnbw/social_construct
+===============================================================================

data/lib/generators/social_construct/install/templates/application_social_card.rb ADDED Viewed

@@ -0,0 +1,4 @@
+class ApplicationSocialCard < SocialConstruct::BaseCard
+  # You can add any shared methods or configuration here
+  # that will be available to all your social card classes
+end

data/lib/generators/social_construct/install/templates/example_social_card.html.erb ADDED Viewed

@@ -0,0 +1,69 @@
+<% content_for :head do %>
+  <style>
+    body {
+      background-color: <%= background_color %>;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      color: white;
+      text-align: center;
+      padding: 60px;
+    }
+    .content {
+      max-width: 900px;
+    }
+    .title {
+      font-size: 72px;
+      font-weight: 800;
+      line-height: 1.1;
+      margin-bottom: 24px;
+      letter-spacing: -2px;
+    }
+    .subtitle {
+      font-size: 32px;
+      font-weight: 400;
+      opacity: 0.8;
+      line-height: 1.3;
+    }
+    .logo {
+      position: absolute;
+      bottom: 60px;
+      right: 60px;
+    }
+    .logo img {
+      height: 40px;
+      width: auto;
+      opacity: 0.9;
+    }
+    .decoration {
+      position: absolute;
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      background: linear-gradient(135deg, transparent 0%, rgba(255,255,255,0.1) 100%);
+      pointer-events: none;
+    }
+  </style>
+<% end %>
+<div class="decoration"></div>
+<div class="content">
+  <h1 class="title"><%= title %></h1>
+  <% if subtitle.present? %>
+    <p class="subtitle"><%= subtitle %></p>
+  <% end %>
+</div>
+<% if logo_data_url %>
+  <div class="logo">
+    <img src="<%= logo_data_url %>" alt="Logo">
+  </div>
+<% end %>

data/lib/generators/social_construct/install/templates/example_social_card.rb ADDED Viewed

@@ -0,0 +1,19 @@
+class ExampleSocialCard < ApplicationSocialCard
+  def initialize(title: "Hello World", subtitle: nil, background_color: "#1a1a1a")
+    super()
+    @title = title
+    @subtitle = subtitle
+    @background_color = background_color
+  end
+  private
+  def template_assigns
+    {
+      title: @title,
+      subtitle: @subtitle,
+      background_color: @background_color,
+      logo_data_url: logo_data_url
+    }
+  end
+end

data/lib/generators/social_construct/install/templates/example_social_card_preview.rb ADDED Viewed

@@ -0,0 +1,37 @@
+class ExampleSocialCardPreview
+  def default
+    ExampleSocialCard.new(
+      title: "Welcome to SocialConstruct",
+      subtitle: "Beautiful social cards for your Rails app"
+    )
+  end
+  def dark_theme
+    ExampleSocialCard.new(
+      title: "Dark Theme Example",
+      subtitle: "Perfect for modern applications",
+      background_color: "#0a0a0a"
+    )
+  end
+  def colorful
+    ExampleSocialCard.new(
+      title: "Colorful Background",
+      subtitle: "Make your cards stand out",
+      background_color: "#6366f1"
+    )
+  end
+  def long_title
+    ExampleSocialCard.new(
+      title: "This is a very long title that demonstrates how text wrapping works in social cards",
+      subtitle: "Subtitle remains readable"
+    )
+  end
+  def no_subtitle
+    ExampleSocialCard.new(
+      title: "Simple and Clean"
+    )
+  end
+end

data/lib/generators/social_construct/install/templates/social_cards_layout.html.erb ADDED Viewed

@@ -0,0 +1,49 @@
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>">
+  <head>
+    <meta charset="utf-8">
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+    <style>
+      /* Reset and base styles for all social cards */
+      * {
+        margin: 0;
+        padding: 0;
+        box-sizing: border-box;
+      }
+      html {
+        width: 1200px;
+        height: 630px;
+        background: white;
+      }
+      body {
+        width: 1200px;
+        height: 630px;
+        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Arial', sans-serif;
+        margin: 0;
+        padding: 0;
+        position: relative;
+        overflow: hidden;
+        -webkit-font-smoothing: antialiased;
+        -moz-osx-font-smoothing: grayscale;
+      }
+      /* Ensure images don't have borders */
+      img {
+        border: 0;
+        max-width: 100%;
+      }
+      /* Default text rendering */
+      h1, h2, h3, h4, h5, h6, p {
+        font-weight: normal;
+        margin: 0;
+      }
+    </style>
+    <%= yield :head %>
+  </head>
+  <body>
+    <%= yield %>
+  </body>
+</html>

data/lib/generators/social_construct/install/templates/social_construct.rb ADDED Viewed

@@ -0,0 +1,10 @@
+# SocialConstruct configuration
+Rails.application.configure do
+  # Configure the template path for social card views
+  # Default: "social_cards"
+  # config.social_construct.template_path = "social_cards"
+  # Enable debug logging for social card generation
+  # Default: false
+  # SocialConstruct::BaseCard.debug = true
+end

data/lib/social_construct/engine.rb ADDED Viewed

@@ -0,0 +1,14 @@
+module SocialConstruct
+  class Engine < ::Rails::Engine
+    isolate_namespace SocialConstruct
+    config.social_construct = ActiveSupport::OrderedOptions.new
+    config.social_construct.template_path = "social_cards"
+    # Ensure dependencies are loaded
+    config.before_initialize do
+      require "ferrum"
+      require "marcel"
+    end
+  end
+end

data/lib/social_construct/version.rb ADDED Viewed

@@ -0,0 +1,3 @@
+module SocialConstruct
+  VERSION = "0.1.0"
+end

data/lib/social_construct.rb ADDED Viewed

@@ -0,0 +1,12 @@
+require "social_construct/version"
+require "social_construct/engine"
+# Dependencies
+require "ferrum"
+require "marcel"
+module SocialConstruct
+  # Configuration for template paths and other settings
+  mattr_accessor :template_path
+  @@template_path = "social_cards"
+end

metadata ADDED Viewed

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: social_construct
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mikkel Malmberg
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: ferrum
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: marcel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: A flexible Rails engine for generating social media preview cards (Open
+  Graph images) with built-in preview functionality
+email:
+- mikkel@brnbw.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- app/controllers/concerns/social_construct/controller.rb
+- app/controllers/social_construct/previews_controller.rb
+- app/models/social_construct/base_card.rb
+- app/views/social_construct/previews/index.html.erb
+- app/views/social_construct/previews/show.html.erb
+- config/routes.rb
+- lib/generators/social_construct/install/install_generator.rb
+- lib/generators/social_construct/install/templates/POST_INSTALL
+- lib/generators/social_construct/install/templates/application_social_card.rb
+- lib/generators/social_construct/install/templates/example_social_card.html.erb
+- lib/generators/social_construct/install/templates/example_social_card.rb
+- lib/generators/social_construct/install/templates/example_social_card_preview.rb
+- lib/generators/social_construct/install/templates/social_cards_layout.html.erb
+- lib/generators/social_construct/install/templates/social_construct.rb
+- lib/social_construct.rb
+- lib/social_construct/engine.rb
+- lib/social_construct/version.rb
+homepage: https://github.com/brnbw/social_construct
+licenses: []
+metadata:
+  homepage_uri: https://github.com/brnbw/social_construct
+  source_code_uri: https://github.com/brnbw/social_construct
+  changelog_uri: https://github.com/brnbw/social_construct/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Rails engine for generating social media preview cards
+test_files: []