rails-metro 0.1.0

data/lib/rails/metro/packs/postmark_pack.rb

@@ -0,0 +1,39 @@
+module Rails
+  module Metro
+    module Packs
+      class PostmarkPack < FeaturePack
+        pack_name "postmark"
+        description "Postmark for fast transactional email (99%+ inbox delivery)"
+        category "notifications"
+
+        def gems
+          [
+            {name: "postmark-rails"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/postmark.rb", <<~RUBY',
+            "  ActionMailer::Base.delivery_method = :postmark",
+            "  ActionMailer::Base.postmark_settings = {",
+            '    api_token: Rails.application.credentials.dig(:postmark, :api_token) || ENV["POSTMARK_API_TOKEN"]',
+            "  }",
+            "RUBY",
+            "",
+            'environment "config.action_mailer.delivery_method = :postmark", env: "production"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Postmark: Add your API token with `bin/rails credentials:edit`:",
+            "  postmark:",
+            "    api_token: your_server_api_token",
+            "Postmark: Known for excellent deliverability and fast delivery times"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/pretender_pack.rb

@@ -0,0 +1,33 @@
+module Rails
+  module Metro
+    module Packs
+      class PretenderPack < FeaturePack
+        pack_name "pretender"
+        description "Pretender for user impersonation (admin support tool)"
+        category "ops"
+
+        def gems
+          [
+            {name: "pretender"}
+          ]
+        end
+
+        def template_lines
+          [
+            'inject_into_file "app/controllers/application_controller.rb", after: "class ApplicationController < ActionController::Base\\n" do',
+            '  "  impersonates :user\\n"',
+            "end"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Pretender: Impersonate with `impersonate_user(user)` in a controller action",
+            "Pretender: Stop with `stop_impersonating_user`",
+            "Pretender: `true_user` returns the admin, `current_user` returns the impersonated user"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/profiling_pack.rb

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class ProfilingPack < FeaturePack
+        pack_name "profiling"
+        description "Stackprof + memory_profiler for CPU and memory profiling"
+        category "ops"
+
+        def gems
+          [
+            {name: "stackprof", group: :development},
+            {name: "memory_profiler", group: :development}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Profiling: CPU profile with `StackProf.run(mode: :cpu) { code }` and `StackProf::Report`",
+            "Profiling: Memory profile with `MemoryProfiler.report { code }.pretty_print`",
+            "Profiling: Both available in development only"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/pundit_pack.rb

@@ -0,0 +1,50 @@
+module Rails
+  module Metro
+    module Packs
+      class PunditPack < FeaturePack
+        pack_name "pundit"
+        description "Pundit for simple, policy-based authorization"
+        category "core"
+        conflicts_with "authorization"
+
+        def gems
+          [
+            {name: "pundit"}
+          ]
+        end
+
+        def template_lines
+          [
+            'inject_into_file "app/controllers/application_controller.rb", after: "class ApplicationController < ActionController::Base\\n" do',
+            '  "  include Pundit::Authorization\\n"',
+            "end",
+            "",
+            'create_file "app/policies/application_policy.rb", <<~RUBY',
+            "  class ApplicationPolicy",
+            "    attr_reader :user, :record",
+            "",
+            "    def initialize(user, record)",
+            "      @user = user",
+            "      @record = record",
+            "    end",
+            "",
+            "    def index? = false",
+            "    def show? = false",
+            "    def create? = false",
+            "    def update? = false",
+            "    def destroy? = false",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Pundit: Generate policies with `bin/rails g pundit:policy User`",
+            "Pundit: Use `authorize @user` in controllers"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/qr_code_pack.rb

@@ -0,0 +1,37 @@
+module Rails
+  module Metro
+    module Packs
+      class QrCodePack < FeaturePack
+        pack_name "qr_code"
+        description "RQRCode for QR code generation (SVG, PNG, ANSI)"
+        category "ui"
+
+        def gems
+          [
+            {name: "rqrcode"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "app/helpers/qr_code_helper.rb", <<~RUBY',
+            "  module QrCodeHelper",
+            '    def qr_code_svg(content, size: 4, color: "000")',
+            "      qr = RQRCode::QRCode.new(content)",
+            '      qr.as_svg(module_size: size, color: color, shape_rendering: "crispEdges").html_safe',
+            "    end",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "QR Code: Use `<%= qr_code_svg(\"https://example.com\") %>` in views",
+            "QR Code: Also supports PNG with `qr.as_png` and ANSI terminal output"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/r2_storage_pack.rb

@@ -0,0 +1,48 @@
+module Rails
+  module Metro
+    module Packs
+      class R2StoragePack < FeaturePack
+        pack_name "r2_storage"
+        description "Cloudflare R2 for S3-compatible Active Storage (no egress fees)"
+        category "core"
+        conflicts_with "s3_storage"
+
+        def gems
+          [
+            {name: "aws-sdk-s3"}
+          ]
+        end
+
+        def template_lines
+          [
+            'inject_into_file "config/storage.yml", <<~YML',
+            "",
+            "  r2:",
+            "    service: S3",
+            "    endpoint: <%= Rails.application.credentials.dig(:r2, :endpoint) %>",
+            '    region: <%= Rails.application.credentials.dig(:r2, :region) || "auto" %>',
+            "    bucket: <%= Rails.application.credentials.dig(:r2, :bucket) %>",
+            "    access_key_id: <%= Rails.application.credentials.dig(:r2, :access_key_id) %>",
+            "    secret_access_key: <%= Rails.application.credentials.dig(:r2, :secret_access_key) %>",
+            "YML",
+            "",
+            'environment "config.active_storage.service = :r2", env: "production"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "R2: Add your Cloudflare credentials with `bin/rails credentials:edit`:",
+            "  r2:",
+            "    endpoint: https://ACCOUNT_ID.r2.cloudflarestorage.com",
+            "    region: auto",
+            "    bucket: your-bucket-name",
+            "    access_key_id: your_access_key",
+            "    secret_access_key: your_secret_key",
+            "R2: Zero egress fees -- great for media-heavy apps"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/rack_timeout_pack.rb

@@ -0,0 +1,34 @@
+module Rails
+  module Metro
+    module Packs
+      class RackTimeoutPack < FeaturePack
+        pack_name "rack_timeout"
+        description "Rack::Timeout for request timeout protection"
+        category "ops"
+
+        def gems
+          [
+            {name: "rack-timeout"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/rack_timeout.rb", <<~RUBY',
+            "  Rack::Timeout.service_timeout = 15",
+            "  Rack::Timeout.wait_timeout = 30",
+            "  Rack::Timeout.wait_overtime = 60",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Rack::Timeout: Requests exceeding 15s are terminated with a Rack::Timeout::RequestTimeoutError",
+            "Rack::Timeout: Customize thresholds in config/initializers/rack_timeout.rb"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/rails_i18n_pack.rb

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class RailsI18nPack < FeaturePack
+        pack_name "rails_i18n"
+        description "Rails I18n locale data for 100+ languages"
+        category "core"
+
+        def gems
+          [
+            {name: "rails-i18n"}
+          ]
+        end
+
+        def template_lines
+          [
+            'environment "config.i18n.available_locales = [:en]',
+            '  config.i18n.default_locale = :en"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "I18n: Add locales to config.i18n.available_locales as needed",
+            "I18n: Locale files available for 100+ languages (date formats, pluralization, etc.)"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/ransack_pack.rb

@@ -0,0 +1,29 @@
+module Rails
+  module Metro
+    module Packs
+      class RansackPack < FeaturePack
+        pack_name "ransack"
+        description "Ransack for object-based search and filter forms"
+        category "ui"
+
+        def gems
+          [
+            {name: "ransack", version: "~> 4.0"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Ransack: Use `@q = User.ransack(params[:q])` in controllers",
+            "Ransack: Build forms with `search_form_for @q do |f|` in views",
+            "Ransack: Supports sorting, predicates (_cont, _eq, _gt, etc.)"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/rate_limiting_pack.rb

@@ -0,0 +1,39 @@
+module Rails
+  module Metro
+    module Packs
+      class RateLimitingPack < FeaturePack
+        pack_name "rate_limiting"
+        description "Rack::Attack for throttling and blocking"
+        category "ops"
+
+        def gems
+          [
+            {name: "rack-attack"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/rack_attack.rb", <<~RUBY',
+            "  class Rack::Attack",
+            '    throttle("req/ip", limit: 300, period: 5.minutes) do |req|',
+            "      req.ip",
+            "    end",
+            "",
+            '    throttle("logins/ip", limit: 5, period: 20.seconds) do |req|',
+            '      req.ip if req.path == "/session" && req.post?',
+            "    end",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Rate Limiting: Customize throttle rules in config/initializers/rack_attack.rb"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/recaptcha_pack.rb

@@ -0,0 +1,38 @@
+module Rails
+  module Metro
+    module Packs
+      class RecaptchaPack < FeaturePack
+        pack_name "recaptcha"
+        description "reCAPTCHA v3 for Google-powered bot protection"
+        category "core"
+
+        def gems
+          [
+            {name: "recaptcha"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/recaptcha.rb", <<~RUBY',
+            "  Recaptcha.configure do |config|",
+            '    config.site_key = Rails.application.credentials.dig(:recaptcha, :site_key) || ENV["RECAPTCHA_SITE_KEY"]',
+            '    config.secret_key = Rails.application.credentials.dig(:recaptcha, :secret_key) || ENV["RECAPTCHA_SECRET_KEY"]',
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "reCAPTCHA: Add your keys with `bin/rails credentials:edit`:",
+            "  recaptcha:",
+            "    site_key: your_site_key",
+            "    secret_key: your_secret_key",
+            "reCAPTCHA: Use `<%= recaptcha_v3 %>` in forms and `verify_recaptcha` in controllers"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/resend_pack.rb

@@ -0,0 +1,37 @@
+module Rails
+  module Metro
+    module Packs
+      class ResendPack < FeaturePack
+        pack_name "resend"
+        description "Resend for transactional and marketing email delivery"
+        category "notifications"
+
+        def gems
+          [
+            {name: "resend"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/resend.rb", <<~RUBY',
+            "  Resend.api_key = Rails.application.credentials.dig(:resend, :api_key) || ENV[\"RESEND_API_KEY\"]",
+            "RUBY",
+            "",
+            "# Configure Action Mailer to use Resend",
+            'environment "config.action_mailer.delivery_method = :resend", env: "production"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Resend: Add your API key with `bin/rails credentials:edit`:",
+            "  resend:",
+            "    api_key: re_your_api_key_here",
+            "Resend: Verify your sending domain at https://resend.com/domains"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/revenuecat_pack.rb

@@ -0,0 +1,36 @@
+module Rails
+  module Metro
+    module Packs
+      class RevenuecatPack < FeaturePack
+        pack_name "revenuecat"
+        description "RevenueCat for subscription management and in-app purchases"
+        category "payments"
+
+        def gems
+          [
+            {name: "revenuecat-api"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/revenuecat.rb", <<~RUBY',
+            "  RevenueCat.configure do |config|",
+            '    config.api_key = Rails.application.credentials.dig(:revenuecat, :api_key) || ENV["REVENUECAT_API_KEY"]',
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "RevenueCat: Add your API key with `bin/rails credentials:edit`:",
+            "  revenuecat:",
+            "    api_key: your_api_key_here",
+            "RevenueCat: Best suited for apps with mobile (iOS/Android) subscription billing"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/rolify_pack.rb

@@ -0,0 +1,32 @@
+module Rails
+  module Metro
+    module Packs
+      class RolifyPack < FeaturePack
+        pack_name "rolify"
+        description "Rolify for role management (admin, editor, viewer, etc.)"
+        category "core"
+
+        def gems
+          [
+            {name: "rolify"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate rolify Role User"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Rolify: Run `bin/rails db:migrate` to create roles table",
+            "Rolify: Assign with `user.add_role :admin`",
+            "Rolify: Check with `user.has_role? :admin`",
+            "Rolify: Pairs well with Pundit or Action Policy for authorization"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/rollbar_pack.rb

@@ -0,0 +1,38 @@
+module Rails
+  module Metro
+    module Packs
+      class RollbarPack < FeaturePack
+        pack_name "rollbar"
+        description "Rollbar for real-time error tracking and debugging"
+        category "ops"
+        conflicts_with "error_tracking", "honeybadger"
+
+        def gems
+          [
+            {name: "rollbar"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/rollbar.rb", <<~RUBY',
+            "  Rollbar.configure do |config|",
+            '    config.access_token = Rails.application.credentials.dig(:rollbar, :access_token) || ENV["ROLLBAR_ACCESS_TOKEN"]',
+            "    config.enabled = !Rails.env.test?",
+            "    config.environment = Rails.env",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Rollbar: Add your access token with `bin/rails credentials:edit`:",
+            "  rollbar:",
+            "    access_token: your_token_here"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/s3_storage_pack.rb

@@ -0,0 +1,45 @@
+module Rails
+  module Metro
+    module Packs
+      class S3StoragePack < FeaturePack
+        pack_name "s3_storage"
+        description "AWS S3 for Active Storage file uploads"
+        category "core"
+        conflicts_with "r2_storage"
+
+        def gems
+          [
+            {name: "aws-sdk-s3"}
+          ]
+        end
+
+        def template_lines
+          [
+            'inject_into_file "config/storage.yml", <<~YML',
+            "",
+            "  amazon:",
+            "    service: S3",
+            "    access_key_id: <%= Rails.application.credentials.dig(:aws, :access_key_id) %>",
+            "    secret_access_key: <%= Rails.application.credentials.dig(:aws, :secret_access_key) %>",
+            '    region: <%= Rails.application.credentials.dig(:aws, :region) || "us-east-1" %>',
+            "    bucket: <%= Rails.application.credentials.dig(:aws, :bucket) %>",
+            "YML",
+            "",
+            'environment "config.active_storage.service = :amazon", env: "production"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "S3: Add your AWS credentials with `bin/rails credentials:edit`:",
+            "  aws:",
+            "    access_key_id: AKIA...",
+            "    secret_access_key: your_secret",
+            "    region: us-east-1",
+            "    bucket: your-bucket-name"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/scenic_pack.rb

@@ -0,0 +1,28 @@
+module Rails
+  module Metro
+    module Packs
+      class ScenicPack < FeaturePack
+        pack_name "scenic"
+        description "Scenic for versioned database views"
+        category "data"
+
+        def gems
+          [
+            {name: "scenic"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Scenic: Generate views with `bin/rails g scenic:view search_results`",
+            "Scenic: Views are versioned -- update with `bin/rails g scenic:view search_results --replace`"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/scheduling_pack.rb

@@ -0,0 +1,46 @@
+module Rails
+  module Metro
+    module Packs
+      class SchedulingPack < FeaturePack
+        pack_name "scheduling"
+        description "Recurring tasks with Solid Queue and solid_queue recurring"
+        category "core"
+        depends_on "background_jobs"
+
+        def gems
+          []
+        end
+
+        def template_lines
+          [
+            'create_file "config/recurring.yml", <<~YML',
+            "  production:",
+            "    cleanup_old_records:",
+            "      class: CleanupOldRecordsJob",
+            '      schedule: "every day at 3am"',
+            "      queue: default",
+            "YML",
+            "",
+            'create_file "app/jobs/cleanup_old_records_job.rb", <<~RUBY',
+            "  class CleanupOldRecordsJob < ApplicationJob",
+            "    queue_as :default",
+            "",
+            "    def perform",
+            "      # Add your recurring cleanup logic here",
+            '      Rails.logger.info "Running scheduled cleanup"',
+            "    end",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Scheduling: Define recurring jobs in config/recurring.yml",
+            "Scheduling: Solid Queue handles scheduling natively -- no cron or external gems needed"
+          ]
+        end
+      end
+    end
+  end
+end