RubyGems - social_construct - Versions diffs - 0.1.0 → 0.3.0 - Mend

social_construct 0.1.0 → 0.3.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 (17) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10cb6057e914282f135714277ab5459c5794e1892a4a2a0825c24cc64ec6259c
-  data.tar.gz: 239310809089b66d572365265074e18a32d1ddc7c693374d60090276a38d793f
+  metadata.gz: 9b1b86abf2f0675a09e15f221cbd4cbda23fbd5f5b37d0406130c30808e3f127
+  data.tar.gz: 5069906dc7297bddd8600b3bef4b321881c09e475138f63980cea760e0e4ff71
 SHA512:
-  metadata.gz: f269fe451a28fae49d20e8c78953b810fe39c7db26559c80d8f555a8cc03ec9f0d80ce811ff6aa94466ba815fd6b4dfe4c19542477878729201b52f70dfbf4aa
-  data.tar.gz: 868aa2dd22efbae1a7e105c8d10f0cfb2bbeee80f71386acdc44c1205b8672a279eefbca334255255230808863d5bde084de1b3ab5c936da39359d5da5dd4f32
+  metadata.gz: a921f74dd5276deef7b2fc446ccfda8adf15d092ff9e2f43fb48c454f7487a4079286b9bf4a3a3346625aaa95716d956229a73f6dce8a4261fa1a0ffbbc7785b
+  data.tar.gz: 84b6f50e3d7a6fa73432304be9ded5dfb08f47c72f0c30d72b56e779c9ec0f1c73de02db0799f9582f6e94ecdfc6f28409e48247f3f4e6afd32cf171a7e4a667

data/README.md CHANGED Viewed

@@ -1,190 +1,154 @@
-# SocialConstruct
+<img src="https://s3.brnbw.com/Stack-C9apVxz8Pg.webp" width="600">
-A Rails engine for generating social media preview cards (Open Graph images) with built-in preview functionality.
+- Design using HTML/CSS
+- Supports images, fonts, caching, ...
+- Built-in previews in development (like mailers)
+- Only requirement is Chrome(ium)
-## Installation
+## Example
-Add to your Gemfile:
+Create a card class:
 ```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
+class PostSocialCard < ApplicationSocialCard
+  def initialize(post)
+    @post = post
   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
+      title: @post.title,
+      author: @post.author_name,
+      avatar: attachment_data_url(@post.author.avatar)
     }
   end
 end
 ```
-### 3. Create templates
-Templates go in `app/views/social_cards/` and should match your class names:
+Create a template:
 ```erb
-<!-- app/views/social_cards/item_social_card.html.erb -->
+<!-- app/views/social_cards/post_social_card.html.erb -->
 <div class="card">
-  <h1><%= item.title %></h1>
-  <!-- Your card HTML -->
+  <img src="<%= avatar %>" class="logo">
+  <h1><%= title %></h1>
+  <p>by <%= author %></p>
 </div>
 ```
-### 4. Optional: Use a shared layout
-Create `app/views/layouts/social_cards.html.erb` for shared HTML structure:
+Add a controller action:
-```erb
-<!DOCTYPE html>
-<html>
-  <head>
-    <meta charset="utf-8">
-    <style>
-      /* Shared styles */
-    </style>
-    <%= yield :head %>
-  </head>
-  <body>
-    <%= yield %>
-  </body>
-</html>
-```
+```ruby
+class PostsController < ApplicationController
+  include SocialConstruct::Controller
-### 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 social_image
+    @post = Post.find(params[:id])
-  def with_long_title
-    item = Item.new(title: "This is a very long title that will test text wrapping")
-    ItemSocialCard.new(item)
+    send_social_card(
+      PostSocialCard.new(@post),
+      cache_key: [@post.id, @post.updated_at]
+    )
   end
 end
 ```
-Visit `/rails/social_cards` in development to see all your previews.
+## Setup
+```sh
+$ bundle add social_construct && bundle install
+$ bin/rails generate social_construct:install
+```
-### 6. Use in your controllers
+## Images
-Include the controller concern:
+Convert ActiveStorage attachments to Base64 `data://` URLs:
 ```ruby
-class ItemsController < ApplicationController
-  include SocialConstruct::Controller
-  def og
-    @item = Item.find(params[:id])
-    render ItemSocialCard.new(@item)
-  end
+def template_assigns
+  {
+    cover_image: attachment_data_url(@post.cover_image),
+    avatar: attachment_data_url(@post.author.avatar, resize_to_limit: [200, 200])
+  }
 end
 ```
-The `render` method automatically handles both formats:
+## Fonts
-- `.png` - Generates the actual PNG image
-- `.html` - Shows the HTML preview (useful for debugging)
+### Remote fonts
-Or with caching:
+Just import them normally and they should work.
-```ruby
-def og
-  @item = Item.find(params[:id])
+```erb
+<style>
+  @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap');
+  body { font-family: 'Inter', sans-serif; }
+</style>
+```
-  cache_key = [
-    "social-cards",
-    "item",
-    @item.id,
-    @item.updated_at.to_i
-  ]
+### Local fonts
-  render ItemSocialCard.new(@item), cache_key: cache_key
+Store fonts in `app/assets/fonts/` and embed as `data://` URLs:
+```ruby
+class LocalFontsCard < ApplicationSocialCard
+  def template_assigns
+    {
+      custom_font_css: generate_font_face(
+        "custom-font-name",
+        "Recursive_VF_1.085--subset-GF_latin_basic.woff2",
+        weight: "300 1000"
+      )
+    }
+  end
 end
 ```
-Alternative API:
+And include in template:
-```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
+```erb
+<style>
+  <%= custom_font_css %>
+  body {
+    font-family: 'custom-font-name', sans-serif;
+  }
+</style>
 ```
-## Configuration
+## Previews
-Configure in your initializer:
+Mount the preview engine:
 ```ruby
-# config/initializers/social_construct.rb
+Rails.application.routes.draw do
+  if Rails.env.development?
+    mount(SocialConstruct::Engine => "/rails/social_cards")
+  end
+end
+```
-# Template path (default: "social_cards")
-Rails.application.config.social_construct.template_path = "custom_path"
+Create preview classes:
-# Enable debug logging (default: false)
-SocialConstruct::BaseCard.debug = true
-```
+```ruby
+# test/social_cards/previews/post_social_card_preview.rb
+class PostSocialCardPreview
+  def default
+    PostSocialCard.new(Post.first)
+  end
-## Requirements
+  def long_title
+    post = Post.new(title: "A very long title that demonstrates text wrapping behavior")
+    PostSocialCard.new(post)
+  end
+end
+```
-- Rails 7.0+
-- Ferrum (headless Chrome driver)
-- Marcel (MIME type detection)
+Visit `http://localhost:3000/rails/social_cards` to preview all cards.
 ## License
 MIT

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

@@ -3,7 +3,6 @@ module SocialConstruct
     extend ActiveSupport::Concern
     included do
-      # Register social card mime type if not already registered
       Mime::Type.register "image/png", :png unless Mime[:png]
     end
@@ -35,16 +34,14 @@ module SocialConstruct
     # Allow using render with social cards
     def render(*args)
-      if args.first.is_a?(SocialConstruct::BaseCard)
-        card = args.first
-        options = args.second || {}
+      return super unless args.first.is_a?(SocialConstruct::BaseCard)
-        respond_to do |format|
-          format.png { send_social_card(card, **options) }
-          format.html { render(html: card.render.html_safe, layout: false) }
-        end
-      else
-        super
+      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
     end

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

@@ -1,5 +1,9 @@
 module SocialConstruct
   class PreviewsController < ActionController::Base
+    include SocialConstruct::Controller
+    before_action :ensure_previews_enabled
     def index
       @preview_classes = find_preview_classes
     end
@@ -27,26 +31,29 @@ module SocialConstruct
       @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
+      render(@card)
     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)
+      return [] unless (paths = Rails.application.config.social_construct.preview_paths)
+      paths
+        .map do |path|
+          next [] unless path.exist?
+          glob = path.join("*_preview.rb")
+          Dir[glob]
+            .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
-        .compact
+        .flatten
     end
     def find_preview_class(name)
@@ -57,5 +64,11 @@ module SocialConstruct
     rescue NameError
       nil
     end
+    def ensure_previews_enabled
+      unless Rails.application.config.social_construct.show_previews
+        raise ActionController::RoutingError, "Social card previews are disabled"
+      end
+    end
   end
 end

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

@@ -6,14 +6,14 @@ module SocialConstruct
     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
+    def width
+      @width || 1200
+    end
+    def height
+      @height || 630
     end
     def render
@@ -33,7 +33,7 @@ module SocialConstruct
       browser_options = {
         headless: true,
         timeout: 30,
-        window_size: [@width, @height]
+        window_size: [width, height]
       }
       # Add Docker-specific options in production
@@ -81,13 +81,38 @@ module SocialConstruct
         browser.goto("data:text/html;charset=utf-8,#{encoded_html}")
       end
-      browser.set_viewport(width: @width, height: @height)
+      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)
+      # Wait for all images and fonts to load
+      browser.execute(
+        <<~JS
+          return new Promise((resolve) => {
+            // Check if all images are loaded
+            const images = Array.from(document.querySelectorAll('img'));
+            const imagePromises = images.map(img => {
+              if (img.complete) return Promise.resolve();
+              return new Promise(res => {
+                img.addEventListener('load', res);
+                img.addEventListener('error', res);
+              });
+            });
+            // Check document fonts
+            const fontPromise = document.fonts?.ready || Promise.resolve();
+            // Wait for everything
+            Promise.all([...imagePromises, fontPromise]).then(() => {
+              // Small delay to ensure rendering is complete
+              requestAnimationFrame(() => {
+                setTimeout(resolve, 50);
+              });
+            });
+          });
+        JS
+      )
       # Log page readiness
       if debug
@@ -108,6 +133,21 @@ module SocialConstruct
         log_debug("Body HTML length: #{body_html_length}")
       end
+      # Ensure content is painted before screenshot
+      browser.execute(
+        <<~JS
+          // Force layout and paint
+          document.body.offsetHeight;
+          // Check if we have visible content
+          const hasContent = document.body.textContent.trim().length > 0 ||
+                            document.querySelectorAll('img').length > 0;
+          if (!hasContent) {
+            console.warn('Page appears to have no visible content');
+          }
+          return hasContent;
+        JS
+      )
       screenshot = browser.screenshot(
         encoding: :binary,
         quality: 100,
@@ -116,27 +156,6 @@ module SocialConstruct
       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)
@@ -177,7 +196,7 @@ module SocialConstruct
       {}
     end
-    def image_to_data_url(attachment, variant_options = {})
+    def attachment_data_url(attachment, variant_options = {})
       return nil unless attachment.attached?
       begin
@@ -191,14 +210,93 @@ module SocialConstruct
         content_type = blob.content_type || "image/jpeg"
         image_data = blob.download
+        file_size = image_data.bytesize
+        # Check image size limitations
+        # 2MB hard limit
+        if file_size > 2_000_000
+          log_debug("Image is #{file_size} bytes (#{file_size / 1024 / 1024}MB), exceeds 2MB data URL limit", :error)
+          return nil
+          # 500KB warning threshold
+        elsif file_size > 500_000
+          log_debug(
+            "Image is #{file_size} bytes (#{file_size / 1024}KB), consider optimizing for better performance",
+            :warn
+          )
+        end
-        "data:#{content_type};base64,#{Base64.strict_encode64(image_data)}"
+        encoded_data = Base64.strict_encode64(image_data)
+        log_debug("Image loaded: #{file_size} bytes (#{encoded_data.bytesize} bytes encoded)")
+        "data:#{content_type};base64,#{encoded_data}"
       rescue => e
         log_debug("Failed to convert image to data URL: #{e.message}", :error)
         nil
       end
     end
+    # Local font helper - converts font file to data URL
+    def font_to_data_url(font_path)
+      full_path = if font_path.start_with?("/")
+        font_path
+      else
+        Rails.root.join("app", "assets", "fonts", font_path)
+      end
+      return nil unless File.exist?(full_path)
+      begin
+        font_data = File.read(full_path)
+        file_size = font_data.bytesize
+        # Check file size limitations
+        # Most browsers have data URL limits around 2MB, but performance degrades after ~500KB
+        # 2MB hard limit
+        if file_size > 2_000_000
+          log_debug(
+            "Font file #{font_path} is #{file_size} bytes (#{file_size / 1024 / 1024}MB), exceeds 2MB data URL limit",
+            :error
+          )
+          return nil
+          # 500KB warning threshold
+        elsif file_size > 500_000
+          log_debug(
+            "Font file #{font_path} is #{file_size} bytes (#{file_size / 1024}KB), consider optimizing for better performance",
+            :warn
+          )
+        end
+        content_type = font_content_type(full_path)
+        encoded_data = Base64.strict_encode64(font_data)
+        # Base64 encoding increases size by ~33%
+        encoded_size = encoded_data.bytesize
+        log_debug("Font #{font_path} loaded: #{file_size} bytes (#{encoded_size} bytes encoded)")
+        "data:#{content_type};base64,#{encoded_data}"
+      rescue => e
+        log_debug("Failed to convert font to data URL: #{e.message}", :error)
+        nil
+      end
+    end
+    # Generate @font-face declaration for local fonts
+    def generate_font_face(family_name, font_path, weight: "normal", style: "normal", display: "swap")
+      data_url = font_to_data_url(font_path)
+      return "" unless data_url
+      <<~CSS
+        @font-face {
+          font-family: '#{family_name}';
+          src: url('#{data_url}');
+          font-weight: #{weight};
+          font-style: #{style};
+          font-display: #{display};
+        }
+      CSS
+        .html_safe
+    end
     def template_path
       Rails.application.config.social_construct.template_path
     end
@@ -207,5 +305,84 @@ module SocialConstruct
       return unless debug
       Rails.logger.send(level, "[SocialCard] #{message}")
     end
+    # Local image helper - converts image file to data URL
+    def image_data_url(image_path)
+      full_path = if image_path.start_with?("/")
+        image_path
+      else
+        Rails.root.join("app", "assets", "images", image_path)
+      end
+      return nil unless File.exist?(full_path)
+      begin
+        image_data = File.read(full_path)
+        file_size = image_data.bytesize
+        # Check file size limitations
+        if file_size > 2_000_000
+          log_debug(
+            "Image file #{image_path} is #{file_size} bytes (#{file_size / 1024 / 1024}MB), exceeds 2MB data URL limit",
+            :error
+          )
+          return nil
+        elsif file_size > 500_000
+          log_debug(
+            "Image file #{image_path} is #{file_size} bytes (#{file_size / 1024}KB), consider optimizing for better performance",
+            :warn
+          )
+        end
+        content_type = image_content_type(full_path)
+        encoded_data = Base64.strict_encode64(image_data)
+        log_debug("Image #{image_path} loaded: #{file_size} bytes (#{encoded_data.bytesize} bytes encoded)")
+        "data:#{content_type};base64,#{encoded_data}"
+      rescue => e
+        log_debug("Failed to convert image to data URL: #{e.message}", :error)
+        nil
+      end
+    end
+    # Determine MIME type for image files
+    def image_content_type(image_path)
+      extension = File.extname(image_path).downcase
+      case extension
+      when ".png"
+        "image/png"
+      when ".jpg", ".jpeg"
+        "image/jpeg"
+      when ".gif"
+        "image/gif"
+      when ".svg"
+        "image/svg+xml"
+      when ".webp"
+        "image/webp"
+      else
+        # fallback
+        "image/png"
+      end
+    end
+    # Determine MIME type for font files
+    def font_content_type(font_path)
+      extension = File.extname(font_path).downcase
+      case extension
+      when ".woff2"
+        "font/woff2"
+      when ".woff"
+        "font/woff"
+      when ".ttf"
+        "font/truetype"
+      when ".otf"
+        "font/opentype"
+      when ".eot"
+        "application/vnd.ms-fontobject"
+      else
+        # fallback
+        "font/truetype"
+      end
+    end
   end
 end

data/config/routes.rb CHANGED Viewed

@@ -4,4 +4,6 @@ SocialConstruct::Engine.routes.draw do
       get(":example_name", action: :preview, as: :example)
     end
   end
+  root(to: redirect("previews"))
 end

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

@@ -28,7 +28,7 @@ module SocialConstruct
       end
       def create_example_preview
-        template("example_social_card_preview.rb", "app/social_cards/previews/example_social_card_preview.rb")
+        template("example_social_card_preview.rb", "test/social_cards/previews/example_social_card_preview.rb")
       end
       def add_route
@@ -42,10 +42,6 @@ module SocialConstruct
         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/example_social_card.html.erb CHANGED Viewed

@@ -1,7 +1,7 @@
-<% content_for :head do %>
+<%% content_for :head do %>
   <style>
     body {
-      background-color: <%= background_color %>;
+      background-color: <%%= background_color %>;
       display: flex;
       align-items: center;
       justify-content: center;
@@ -9,11 +9,11 @@
       text-align: center;
       padding: 60px;
     }
     .content {
       max-width: 900px;
     }
     .title {
       font-size: 72px;
       font-weight: 800;
@@ -21,26 +21,26 @@
       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;
@@ -51,19 +51,13 @@
       pointer-events: none;
     }
   </style>
-<% end %>
+<%% end %>
 <div class="decoration"></div>
 <div class="content">
-  <h1 class="title"><%= title %></h1>
-  <% if subtitle.present? %>
-    <p class="subtitle"><%= subtitle %></p>
-  <% end %>
+  <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 CHANGED Viewed

@@ -1,6 +1,5 @@
 class ExampleSocialCard < ApplicationSocialCard
   def initialize(title: "Hello World", subtitle: nil, background_color: "#1a1a1a")
-    super()
     @title = title
     @subtitle = subtitle
     @background_color = background_color
@@ -12,8 +11,7 @@ class ExampleSocialCard < ApplicationSocialCard
     {
       title: @title,
       subtitle: @subtitle,
-      background_color: @background_color,
-      logo_data_url: logo_data_url
+      background_color: @background_color
     }
   end
 end

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

@@ -5,33 +5,4 @@ class ExampleSocialCardPreview
       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 CHANGED Viewed

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="<%= I18n.locale %>">
+<html lang="<%%= I18n.locale %>">
   <head>
     <meta charset="utf-8">
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
@@ -10,13 +10,13 @@
         padding: 0;
         box-sizing: border-box;
       }
       html {
         width: 1200px;
         height: 630px;
         background: white;
       }
       body {
         width: 1200px;
         height: 630px;
@@ -28,22 +28,23 @@
         -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 %>
+    <%%= yield :head %>
   </head>
   <body>
-    <%= yield %>
+    <%%= yield %>
   </body>
-</html>
+</html>

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

@@ -1,9 +1,16 @@
-# SocialConstruct configuration
 Rails.application.configure do
   # Configure the template path for social card views
   # Default: "social_cards"
   # config.social_construct.template_path = "social_cards"
+  # Configure paths for social card previews
+  # Default: ["test/social_cards/previews"]
+  # config.social_construct.preview_paths = ["test/social_cards/previews"]
+  # Enable social card previews
+  # Default: true in development, false otherwise
+  # config.social_construct.show_previews = Rails.env.development?
   # Enable debug logging for social card generation
   # Default: false
   # SocialConstruct::BaseCard.debug = true

data/lib/social_construct/engine.rb CHANGED Viewed

@@ -4,11 +4,14 @@ module SocialConstruct
     config.social_construct = ActiveSupport::OrderedOptions.new
     config.social_construct.template_path = "social_cards"
+    config.social_construct.preview_paths = []
+    config.social_construct.show_previews = Rails.env.development?
-    # Ensure dependencies are loaded
-    config.before_initialize do
-      require "ferrum"
-      require "marcel"
+    # Set default preview path after application initializes
+    config.after_initialize do |app|
+      if app.config.social_construct.preview_paths.empty?
+        app.config.social_construct.preview_paths = [Rails.root.join("test/social_cards/previews")]
+      end
     end
   end
 end

data/lib/social_construct/version.rb CHANGED Viewed

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

data/lib/social_construct.rb CHANGED Viewed

@@ -6,7 +6,4 @@ require "ferrum"
 require "marcel"
 module SocialConstruct
-  # Configuration for template paths and other settings
-  mattr_accessor :template_path
-  @@template_path = "social_cards"
 end

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: social_construct
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Mikkel Malmberg
@@ -68,7 +68,6 @@ files:
 - 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
@@ -78,12 +77,12 @@ files:
 - lib/social_construct.rb
 - lib/social_construct/engine.rb
 - lib/social_construct/version.rb
-homepage: https://github.com/brnbw/social_construct
+homepage: https://github.com/mikker/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
+  homepage_uri: https://github.com/mikker/social_construct
+  source_code_uri: https://github.com/mikker/social_construct
+  changelog_uri: https://github.com/mikker/social_construct/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib

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

@@ -1,34 +0,0 @@
-===============================================================================
-  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
-===============================================================================