RubyGems - rails-metro - Versions diffs - 0.1.0 - Mend

rails-metro 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 (150) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +17 -0
data/LICENSE +21 -0
data/README.md +267 -0
data/exe/metro +3 -0
data/lib/rails/metro/cli.rb +162 -0
data/lib/rails/metro/config.rb +40 -0
data/lib/rails/metro/feature_pack.rb +59 -0
data/lib/rails/metro/feature_registry.rb +147 -0
data/lib/rails/metro/packs/aasm_pack.rb +29 -0
data/lib/rails/metro/packs/ab_testing_pack.rb +39 -0
data/lib/rails/metro/packs/action_text_pack.rb +29 -0
data/lib/rails/metro/packs/activeadmin_pack.rb +32 -0
data/lib/rails/metro/packs/activity_feed_pack.rb +31 -0
data/lib/rails/metro/packs/acts_as_list_pack.rb +28 -0
data/lib/rails/metro/packs/acts_as_votable_pack.rb +32 -0
data/lib/rails/metro/packs/administrate_pack.rb +31 -0
data/lib/rails/metro/packs/after_party_pack.rb +31 -0
data/lib/rails/metro/packs/ahoy_pack.rb +31 -0
data/lib/rails/metro/packs/amplitude_pack.rb +45 -0
data/lib/rails/metro/packs/annotate_pack.rb +30 -0
data/lib/rails/metro/packs/api_cors_pack.rb +41 -0
data/lib/rails/metro/packs/api_docs_pack.rb +34 -0
data/lib/rails/metro/packs/api_guard_pack.rb +31 -0
data/lib/rails/metro/packs/api_serialization_pack.rb +38 -0
data/lib/rails/metro/packs/app_linting_pack.rb +35 -0
data/lib/rails/metro/packs/audit_trail_pack.rb +31 -0
data/lib/rails/metro/packs/authentication_pack.rb +31 -0
data/lib/rails/metro/packs/authorization_pack.rb +31 -0
data/lib/rails/metro/packs/avo_pack.rb +32 -0
data/lib/rails/metro/packs/aws_ses_pack.rb +45 -0
data/lib/rails/metro/packs/background_jobs_pack.rb +34 -0
data/lib/rails/metro/packs/blazer_pack.rb +62 -0
data/lib/rails/metro/packs/breadcrumbs_pack.rb +31 -0
data/lib/rails/metro/packs/caching_pack.rb +30 -0
data/lib/rails/metro/packs/charting_pack.rb +67 -0
data/lib/rails/metro/packs/circuit_breaker_pack.rb +34 -0
data/lib/rails/metro/packs/clicky_pack.rb +37 -0
data/lib/rails/metro/packs/cloudinary_pack.rb +42 -0
data/lib/rails/metro/packs/components_pack.rb +30 -0
data/lib/rails/metro/packs/counter_culture_pack.rb +29 -0
data/lib/rails/metro/packs/data_migrate_pack.rb +29 -0
data/lib/rails/metro/packs/datadog_pack.rb +41 -0
data/lib/rails/metro/packs/deployment_pack.rb +30 -0
data/lib/rails/metro/packs/devise_pack.rb +33 -0
data/lib/rails/metro/packs/doorkeeper_pack.rb +32 -0
data/lib/rails/metro/packs/dotenv_pack.rb +36 -0
data/lib/rails/metro/packs/elasticsearch_pack.rb +31 -0
data/lib/rails/metro/packs/encryption_pack.rb +37 -0
data/lib/rails/metro/packs/error_tracking_pack.rb +40 -0
data/lib/rails/metro/packs/event_sourcing_pack.rb +31 -0
data/lib/rails/metro/packs/faraday_pack.rb +42 -0
data/lib/rails/metro/packs/fathom_pack.rb +36 -0
data/lib/rails/metro/packs/feature_flags_pack.rb +34 -0
data/lib/rails/metro/packs/friendly_id_pack.rb +31 -0
data/lib/rails/metro/packs/geocoder_pack.rb +38 -0
data/lib/rails/metro/packs/good_job_pack.rb +34 -0
data/lib/rails/metro/packs/google_analytics_pack.rb +42 -0
data/lib/rails/metro/packs/google_tag_manager_pack.rb +51 -0
data/lib/rails/metro/packs/graphql_pack.rb +31 -0
data/lib/rails/metro/packs/health_check_pack.rb +34 -0
data/lib/rails/metro/packs/heap_pack.rb +39 -0
data/lib/rails/metro/packs/honeybadger_pack.rb +37 -0
data/lib/rails/metro/packs/hotwire_livereload_pack.rb +28 -0
data/lib/rails/metro/packs/icons_pack.rb +28 -0
data/lib/rails/metro/packs/invisible_captcha_pack.rb +35 -0
data/lib/rails/metro/packs/kredis_pack.rb +31 -0
data/lib/rails/metro/packs/lemon_squeezy_pack.rb +36 -0
data/lib/rails/metro/packs/letter_opener_pack.rb +31 -0
data/lib/rails/metro/packs/letter_opener_web_pack.rb +32 -0
data/lib/rails/metro/packs/logging_pack.rb +36 -0
data/lib/rails/metro/packs/madmin_pack.rb +32 -0
data/lib/rails/metro/packs/mailgun_pack.rb +44 -0
data/lib/rails/metro/packs/maintenance_mode_pack.rb +30 -0
data/lib/rails/metro/packs/maintenance_tasks_pack.rb +32 -0
data/lib/rails/metro/packs/markdown_pack.rb +48 -0
data/lib/rails/metro/packs/matomo_pack.rb +48 -0
data/lib/rails/metro/packs/meilisearch_pack.rb +37 -0
data/lib/rails/metro/packs/mixpanel_pack.rb +47 -0
data/lib/rails/metro/packs/mobility_pack.rb +32 -0
data/lib/rails/metro/packs/mollie_pack.rb +36 -0
data/lib/rails/metro/packs/multitenancy_pack.rb +35 -0
data/lib/rails/metro/packs/newrelic_pack.rb +52 -0
data/lib/rails/metro/packs/notifications_pack.rb +31 -0
data/lib/rails/metro/packs/omniauth_pack.rb +49 -0
data/lib/rails/metro/packs/paddle_pack.rb +37 -0
data/lib/rails/metro/packs/pagination_pack.rb +44 -0
data/lib/rails/metro/packs/passwordless_pack.rb +32 -0
data/lib/rails/metro/packs/payments_pack.rb +35 -0
data/lib/rails/metro/packs/paypal_pack.rb +35 -0
data/lib/rails/metro/packs/pdf_pack.rb +45 -0
data/lib/rails/metro/packs/performance_pack.rb +37 -0
data/lib/rails/metro/packs/pghero_pack.rb +31 -0
data/lib/rails/metro/packs/plausible_pack.rb +36 -0
data/lib/rails/metro/packs/posthog_pack.rb +40 -0
data/lib/rails/metro/packs/postmark_pack.rb +39 -0
data/lib/rails/metro/packs/pretender_pack.rb +33 -0
data/lib/rails/metro/packs/profiling_pack.rb +30 -0
data/lib/rails/metro/packs/pundit_pack.rb +50 -0
data/lib/rails/metro/packs/qr_code_pack.rb +37 -0
data/lib/rails/metro/packs/r2_storage_pack.rb +48 -0
data/lib/rails/metro/packs/rack_timeout_pack.rb +34 -0
data/lib/rails/metro/packs/rails_i18n_pack.rb +31 -0
data/lib/rails/metro/packs/ransack_pack.rb +29 -0
data/lib/rails/metro/packs/rate_limiting_pack.rb +39 -0
data/lib/rails/metro/packs/recaptcha_pack.rb +38 -0
data/lib/rails/metro/packs/resend_pack.rb +37 -0
data/lib/rails/metro/packs/revenuecat_pack.rb +36 -0
data/lib/rails/metro/packs/rolify_pack.rb +32 -0
data/lib/rails/metro/packs/rollbar_pack.rb +38 -0
data/lib/rails/metro/packs/s3_storage_pack.rb +45 -0
data/lib/rails/metro/packs/scenic_pack.rb +28 -0
data/lib/rails/metro/packs/scheduling_pack.rb +46 -0
data/lib/rails/metro/packs/search_pack.rb +32 -0
data/lib/rails/metro/packs/security_pack.rb +30 -0
data/lib/rails/metro/packs/sendgrid_pack.rb +44 -0
data/lib/rails/metro/packs/sent_dm_pack.rb +36 -0
data/lib/rails/metro/packs/seo_pack.rb +40 -0
data/lib/rails/metro/packs/shoulda_matchers_pack.rb +37 -0
data/lib/rails/metro/packs/sidekiq_pack.rb +42 -0
data/lib/rails/metro/packs/simple_calendar_pack.rb +29 -0
data/lib/rails/metro/packs/simple_form_pack.rb +30 -0
data/lib/rails/metro/packs/simplecov_pack.rb +38 -0
data/lib/rails/metro/packs/slack_notifier_pack.rb +36 -0
data/lib/rails/metro/packs/soft_deletes_pack.rb +30 -0
data/lib/rails/metro/packs/solidus_pack.rb +31 -0
data/lib/rails/metro/packs/spreadsheets_pack.rb +29 -0
data/lib/rails/metro/packs/statcounter_pack.rb +41 -0
data/lib/rails/metro/packs/stimulus_components_pack.rb +33 -0
data/lib/rails/metro/packs/storage_validations_pack.rb +28 -0
data/lib/rails/metro/packs/strong_migrations_pack.rb +30 -0
data/lib/rails/metro/packs/tagging_pack.rb +31 -0
data/lib/rails/metro/packs/test_mocking_pack.rb +41 -0
data/lib/rails/metro/packs/testing_pack.rb +39 -0
data/lib/rails/metro/packs/twilio_pack.rb +38 -0
data/lib/rails/metro/packs/vite_rails_pack.rb +31 -0
data/lib/rails/metro/packs/web_push_pack.rb +39 -0
data/lib/rails/metro/packs/webhooks_pack.rb +45 -0
data/lib/rails/metro/packs/websockets_pack.rb +29 -0
data/lib/rails/metro/template_compiler.rb +85 -0
data/lib/rails/metro/tui/app.rb +119 -0
data/lib/rails/metro/tui/steps/app_name_step.rb +57 -0
data/lib/rails/metro/tui/steps/database_step.rb +53 -0
data/lib/rails/metro/tui/steps/pack_step.rb +248 -0
data/lib/rails/metro/tui/steps/review_step.rb +94 -0
data/lib/rails/metro/tui/styles.rb +47 -0
data/lib/rails/metro/tui.rb +37 -0
data/lib/rails/metro/version.rb +5 -0
data/lib/rails/metro.rb +9 -0
metadata +206 -0

data/lib/rails/metro/packs/health_check_pack.rb ADDED Viewed

@@ -0,0 +1,34 @@
+module Rails
+  module Metro
+    module Packs
+      class HealthCheckPack < FeaturePack
+        pack_name "health_check"
+        description "OkComputer for health check endpoints (load balancers, k8s)"
+        category "ops"
+        def gems
+          [
+            {name: "okcomputer"}
+          ]
+        end
+        def template_lines
+          [
+            'create_file "config/initializers/okcomputer.rb", <<~RUBY',
+            '  OkComputer::Registry.register "database", OkComputer::ActiveRecordCheck.new',
+            '  OkComputer::Registry.register "cache", OkComputer::GenericCacheCheck.new',
+            "  OkComputer.mount_at = \"health\"",
+            "RUBY"
+          ]
+        end
+        def post_install_notes
+          [
+            "Health Check: Endpoints at /health and /health/all",
+            "Health Check: Point load balancer/k8s probes at /health"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/heap_pack.rb ADDED Viewed

@@ -0,0 +1,39 @@
+module Rails
+  module Metro
+    module Packs
+      class HeapPack < FeaturePack
+        pack_name "heap"
+        description "Heap for auto-captured product analytics"
+        category "analytics"
+        def gems
+          []
+        end
+        def template_lines
+          [
+            'create_file "app/views/layouts/_heap.html.erb", <<~ERB',
+            "  <script type=\"text/javascript\">",
+            '    window.heap=window.heap||[],heap.load=function(e,t){window.heap.appid=e,window.heap.config=t=t||{};var r=document.createElement("script");r.type="text/javascript",r.async=!0,r.src="https://cdn.heapanalytics.com/js/heap-"+e+".js";var a=document.getElementsByTagName("script")[0];a.parentNode.insertBefore(r,a);for(var n=function(e){return function(){heap.push([e].concat(Array.prototype.slice.call(arguments,0)))}},p=["addEventProperties","addUserProperties","clearEventProperties","identify","resetIdentity","removeEventProperty","setEventProperties","track","unsetEventProperty"],o=0;o<p.length;o++)heap[p[o]]=n(p[o])};',
+            '    heap.load("<%%= Rails.application.credentials.dig(:heap, :app_id) || ENV["HEAP_APP_ID"] %>");',
+            "  </script>",
+            "ERB",
+            "",
+            'inject_into_file "app/views/layouts/application.html.erb", after: "<head>\\n" do',
+            '  "    <%= render \\"layouts/heap\\" %>\\n"',
+            "end"
+          ]
+        end
+        def post_install_notes
+          [
+            "Heap: Add your app ID with `bin/rails credentials:edit`:",
+            "  heap:",
+            "    app_id: \"1234567890\"",
+            "Heap: Auto-captures all user interactions -- no manual event tracking needed"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/honeybadger_pack.rb ADDED Viewed

@@ -0,0 +1,37 @@
+module Rails
+  module Metro
+    module Packs
+      class HoneybadgerPack < FeaturePack
+        pack_name "honeybadger"
+        description "Honeybadger for error tracking and uptime monitoring"
+        category "ops"
+        conflicts_with "error_tracking", "rollbar"
+        def gems
+          [
+            {name: "honeybadger"}
+          ]
+        end
+        def template_lines
+          [
+            'run "bundle exec honeybadger install"',
+            'create_file "config/initializers/honeybadger.rb", <<~RUBY',
+            "  Honeybadger.configure do |config|",
+            '    config.api_key = Rails.application.credentials.dig(:honeybadger, :api_key) || ENV["HONEYBADGER_API_KEY"]',
+            "  end",
+            "RUBY"
+          ]
+        end
+        def post_install_notes
+          [
+            "Honeybadger: Add your API key with `bin/rails credentials:edit`:",
+            "  honeybadger:",
+            "    api_key: your_api_key_here"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/hotwire_livereload_pack.rb ADDED Viewed

@@ -0,0 +1,28 @@
+module Rails
+  module Metro
+    module Packs
+      class HotwireLivereloadPack < FeaturePack
+        pack_name "hotwire_livereload"
+        description "Hotwire LiveReload for automatic page refresh on file changes"
+        category "ops"
+        def gems
+          [
+            {name: "hotwire-livereload", group: :development}
+          ]
+        end
+        def template_lines
+          []
+        end
+        def post_install_notes
+          [
+            "LiveReload: Pages auto-refresh when you save views, CSS, or JS files",
+            "LiveReload: Works via Hotwire/Turbo -- no browser extension needed"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/icons_pack.rb ADDED Viewed

@@ -0,0 +1,28 @@
+module Rails
+  module Metro
+    module Packs
+      class IconsPack < FeaturePack
+        pack_name "icons"
+        description "Lucide Rails for modern SVG icons"
+        category "ui"
+        def gems
+          [
+            {name: "lucide-rails"}
+          ]
+        end
+        def template_lines
+          []
+        end
+        def post_install_notes
+          [
+            "Icons: Use `<%= lucide_icon \"home\" %>` in views",
+            "Icons: Browse icons at https://lucide.dev"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/invisible_captcha_pack.rb ADDED Viewed

@@ -0,0 +1,35 @@
+module Rails
+  module Metro
+    module Packs
+      class InvisibleCaptchaPack < FeaturePack
+        pack_name "invisible_captcha"
+        description "Invisible Captcha for honeypot-based spam prevention"
+        category "core"
+        def gems
+          [
+            {name: "invisible_captcha"}
+          ]
+        end
+        def template_lines
+          [
+            'create_file "config/initializers/invisible_captcha.rb", <<~RUBY',
+            "  InvisibleCaptcha.setup do |config|",
+            "    config.honeypots = [:subtitle, :city, :nickname]",
+            "    config.timestamp_threshold = 2",
+            "  end",
+            "RUBY"
+          ]
+        end
+        def post_install_notes
+          [
+            "Invisible Captcha: Add `invisible_captcha` to forms that need spam protection",
+            "Invisible Captcha: No user-facing CAPTCHA -- uses honeypots and timing"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/kredis_pack.rb ADDED Viewed

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class KredisPack < FeaturePack
+        pack_name "kredis"
+        description "Kredis for structured Redis types in Rails models"
+        category "data"
+        def gems
+          [
+            {name: "kredis"}
+          ]
+        end
+        def template_lines
+          [
+            'rails_command "kredis:install"'
+          ]
+        end
+        def post_install_notes
+          [
+            "Kredis: Requires Redis -- configure in config/redis/shared.yml",
+            "Kredis: Use `kredis_list :recent_searches` in models",
+            "Kredis: Supports lists, sets, flags, counters, enums, and more"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/lemon_squeezy_pack.rb ADDED Viewed

@@ -0,0 +1,36 @@
+module Rails
+  module Metro
+    module Packs
+      class LemonSqueezyPack < FeaturePack
+        pack_name "lemon_squeezy"
+        description "Lemon Squeezy -- merchant of record for SaaS (handles tax/VAT)"
+        category "payments"
+        def gems
+          [
+            {name: "lemon_squeezy"}
+          ]
+        end
+        def template_lines
+          [
+            'create_file "config/initializers/lemon_squeezy.rb", <<~RUBY',
+            "  LemonSqueezy.configure do |config|",
+            '    config.api_key = Rails.application.credentials.dig(:lemon_squeezy, :api_key) || ENV["LEMON_SQUEEZY_API_KEY"]',
+            "  end",
+            "RUBY"
+          ]
+        end
+        def post_install_notes
+          [
+            "Lemon Squeezy: Add your API key with `bin/rails credentials:edit`:",
+            "  lemon_squeezy:",
+            "    api_key: your_api_key_here",
+            "Lemon Squeezy: Acts as merchant of record -- handles sales tax, VAT, and billing for you"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/letter_opener_pack.rb ADDED Viewed

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class LetterOpenerPack < FeaturePack
+        pack_name "letter_opener"
+        description "Letter Opener for previewing emails in the browser (dev)"
+        category "ops"
+        def gems
+          [
+            {name: "letter_opener", group: :development}
+          ]
+        end
+        def template_lines
+          [
+            'environment "config.action_mailer.delivery_method = :letter_opener", env: "development"',
+            'environment "config.action_mailer.perform_deliveries = true", env: "development"'
+          ]
+        end
+        def post_install_notes
+          [
+            "Letter Opener: Emails open in your browser automatically in development",
+            "Letter Opener: No SMTP setup needed for dev -- just send and it pops up"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/letter_opener_web_pack.rb ADDED Viewed

@@ -0,0 +1,32 @@
+module Rails
+  module Metro
+    module Packs
+      class LetterOpenerWebPack < FeaturePack
+        pack_name "letter_opener_web"
+        description "Letter Opener Web for browsable email inbox in development"
+        category "ops"
+        depends_on "letter_opener"
+        def gems
+          [
+            {name: "letter_opener_web", group: :development}
+          ]
+        end
+        def template_lines
+          [
+            'environment "config.action_mailer.delivery_method = :letter_opener_web", env: "development"',
+            'route "mount LetterOpenerWeb::Engine, at: \\"/letter_opener\\" if Rails.env.development?"'
+          ]
+        end
+        def post_install_notes
+          [
+            "Letter Opener Web: Browse all sent emails at /letter_opener in development",
+            "Letter Opener Web: Provides a persistent inbox UI (vs letter_opener which just opens a tab)"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/logging_pack.rb ADDED Viewed

@@ -0,0 +1,36 @@
+module Rails
+  module Metro
+    module Packs
+      class LoggingPack < FeaturePack
+        pack_name "logging"
+        description "Lograge for clean, single-line structured request logs"
+        category "ops"
+        def gems
+          [
+            {name: "lograge"}
+          ]
+        end
+        def template_lines
+          [
+            'environment "config.lograge.enabled = true',
+            "  config.lograge.custom_payload do |controller|",
+            "    {",
+            "      host: controller.request.host,",
+            "      user_id: controller.respond_to?(:current_user, true) && controller.current_user&.id",
+            "    }",
+            '  end", env: "production"'
+          ]
+        end
+        def post_install_notes
+          [
+            "Lograge: Production logs are now single-line structured format",
+            "Lograge: Customize payload in config/environments/production.rb"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/madmin_pack.rb ADDED Viewed

@@ -0,0 +1,32 @@
+module Rails
+  module Metro
+    module Packs
+      class MadminPack < FeaturePack
+        pack_name "madmin"
+        description "Madmin -- a modern admin framework by Chris Oliver (GoRails)"
+        category "admin"
+        conflicts_with "avo", "administrate", "activeadmin"
+        def gems
+          [
+            {name: "madmin"}
+          ]
+        end
+        def template_lines
+          [
+            'rails_command "generate madmin:install"'
+          ]
+        end
+        def post_install_notes
+          [
+            "Madmin: Access admin at /madmin",
+            "Madmin: Resources are auto-generated from your models",
+            "Madmin: Customize with `bin/rails g madmin:resource User`"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/mailgun_pack.rb ADDED Viewed

@@ -0,0 +1,44 @@
+module Rails
+  module Metro
+    module Packs
+      class MailgunPack < FeaturePack
+        pack_name "mailgun"
+        description "Mailgun for transactional email delivery"
+        category "notifications"
+        def gems
+          [
+            {name: "mailgun-ruby"}
+          ]
+        end
+        def template_lines
+          [
+            'create_file "config/initializers/mailgun.rb", <<~RUBY',
+            "  ActionMailer::Base.smtp_settings = {",
+            "    port: 587,",
+            '    address: "smtp.mailgun.org",',
+            '    user_name: Rails.application.credentials.dig(:mailgun, :smtp_login) || ENV["MAILGUN_SMTP_LOGIN"],',
+            '    password: Rails.application.credentials.dig(:mailgun, :smtp_password) || ENV["MAILGUN_SMTP_PASSWORD"],',
+            "    authentication: :plain,",
+            "    enable_starttls_auto: true",
+            "  }",
+            "RUBY",
+            "",
+            'environment "config.action_mailer.delivery_method = :smtp", env: "production"'
+          ]
+        end
+        def post_install_notes
+          [
+            "Mailgun: Add your credentials with `bin/rails credentials:edit`:",
+            "  mailgun:",
+            "    smtp_login: postmaster@yourdomain.com",
+            "    smtp_password: your_smtp_password",
+            "Mailgun: Verify your sending domain in the Mailgun dashboard"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/maintenance_mode_pack.rb ADDED Viewed

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class MaintenanceModePack < FeaturePack
+        pack_name "maintenance_mode"
+        description "Turnout for easy maintenance mode pages"
+        category "ops"
+        def gems
+          [
+            {name: "turnout"}
+          ]
+        end
+        def template_lines
+          []
+        end
+        def post_install_notes
+          [
+            "Maintenance Mode: Enable with `rake maintenance:start`",
+            "Maintenance Mode: Disable with `rake maintenance:end`",
+            "Maintenance Mode: Customize page in public/maintenance.html",
+            "Maintenance Mode: Allow specific IPs with `rake maintenance:start ALLOWED_IPS=1.2.3.4`"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/maintenance_tasks_pack.rb ADDED Viewed

@@ -0,0 +1,32 @@
+module Rails
+  module Metro
+    module Packs
+      class MaintenanceTasksPack < FeaturePack
+        pack_name "maintenance_tasks"
+        description "Maintenance Tasks (Shopify) for admin-triggered background tasks"
+        category "ops"
+        def gems
+          [
+            {name: "maintenance_tasks"}
+          ]
+        end
+        def template_lines
+          [
+            'rails_command "generate maintenance_tasks:install"',
+            'route "mount MaintenanceTasks::Engine => \\"/maintenance_tasks\\""'
+          ]
+        end
+        def post_install_notes
+          [
+            "Maintenance Tasks: Run `bin/rails db:migrate` to create task tables",
+            "Maintenance Tasks: Generate with `bin/rails g maintenance_tasks:task BackfillUsers`",
+            "Maintenance Tasks: Trigger and monitor at /maintenance_tasks"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/markdown_pack.rb ADDED Viewed

@@ -0,0 +1,48 @@
+module Rails
+  module Metro
+    module Packs
+      class MarkdownPack < FeaturePack
+        pack_name "markdown"
+        description "Redcarpet for Markdown rendering with syntax highlighting"
+        category "ui"
+        def gems
+          [
+            {name: "redcarpet"},
+            {name: "rouge"}
+          ]
+        end
+        def template_lines
+          [
+            'create_file "app/helpers/markdown_helper.rb", <<~RUBY',
+            "  module MarkdownHelper",
+            "    def render_markdown(text)",
+            "      renderer = Redcarpet::Render::HTML.new(",
+            "        hard_wrap: true,",
+            "        link_attributes: { target: \"_blank\", rel: \"noopener\" }",
+            "      )",
+            "      markdown = Redcarpet::Markdown.new(renderer,",
+            "        autolink: true,",
+            "        tables: true,",
+            "        fenced_code_blocks: true,",
+            "        strikethrough: true,",
+            "        highlight: true",
+            "      )",
+            "      markdown.render(text).html_safe",
+            "    end",
+            "  end",
+            "RUBY"
+          ]
+        end
+        def post_install_notes
+          [
+            "Markdown: Use `<%= render_markdown(@post.body) %>` in views",
+            "Markdown: Rouge provides syntax highlighting for code blocks"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/matomo_pack.rb ADDED Viewed

@@ -0,0 +1,48 @@
+module Rails
+  module Metro
+    module Packs
+      class MatomoPack < FeaturePack
+        pack_name "matomo"
+        description "Matomo -- self-hosted open-source web analytics (Google Analytics alternative)"
+        category "analytics"
+        def gems
+          []
+        end
+        def template_lines
+          [
+            'create_file "app/views/layouts/_matomo.html.erb", <<~ERB',
+            "  <script>",
+            "    var _paq = window._paq = window._paq || [];",
+            '    _paq.push(["trackPageView"]);',
+            '    _paq.push(["enableLinkTracking"]);',
+            "    (function() {",
+            '      var u="<%%= Rails.application.credentials.dig(:matomo, :url) || ENV["MATOMO_URL"] %>/";',
+            '      _paq.push(["setTrackerUrl", u+"matomo.php"]);',
+            '      _paq.push(["setSiteId", "<%%= Rails.application.credentials.dig(:matomo, :site_id) || ENV["MATOMO_SITE_ID"] %>"]);',
+            '      var d=document, g=d.createElement("script"), s=d.getElementsByTagName("script")[0];',
+            '      g.async=true; g.src=u+"matomo.js"; s.parentNode.insertBefore(g,s);',
+            "    })();",
+            "  </script>",
+            "ERB",
+            "",
+            'inject_into_file "app/views/layouts/application.html.erb", after: "<head>\\n" do',
+            '  "    <%= render \\"layouts/matomo\\" %>\\n"',
+            "end"
+          ]
+        end
+        def post_install_notes
+          [
+            "Matomo: Add your instance details with `bin/rails credentials:edit`:",
+            "  matomo:",
+            "    url: https://your-matomo-instance.com",
+            "    site_id: 1",
+            "Matomo: Self-hosted -- you own 100% of your analytics data"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/packs/meilisearch_pack.rb ADDED Viewed

@@ -0,0 +1,37 @@
+module Rails
+  module Metro
+    module Packs
+      class MeilisearchPack < FeaturePack
+        pack_name "meilisearch"
+        description "Meilisearch for typo-tolerant, fast full-text search"
+        category "data"
+        conflicts_with "search", "elasticsearch"
+        def gems
+          [
+            {name: "meilisearch-rails"}
+          ]
+        end
+        def template_lines
+          [
+            'create_file "config/initializers/meilisearch.rb", <<~RUBY',
+            "  MeiliSearch::Rails.configuration = {",
+            '    meilisearch_url: Rails.application.credentials.dig(:meilisearch, :url) || ENV.fetch("MEILISEARCH_URL", "http://localhost:7700"),',
+            '    meilisearch_api_key: Rails.application.credentials.dig(:meilisearch, :api_key) || ENV["MEILISEARCH_API_KEY"]',
+            "  }",
+            "RUBY"
+          ]
+        end
+        def post_install_notes
+          [
+            "Meilisearch: Install and run the Meilisearch server (see https://meilisearch.com)",
+            "Meilisearch: Add `include MeiliSearch::Rails` to models",
+            "Meilisearch: Use `Model.search(\"query\")` for instant search"
+          ]
+        end
+      end
+    end
+  end
+end