rails-metro 0.1.0

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

@@ -0,0 +1,32 @@
+module Rails
+  module Metro
+    module Packs
+      class SearchPack < FeaturePack
+        pack_name "search"
+        description "pg_search for PostgreSQL full-text search"
+        category "data"
+        conflicts_with "meilisearch", "elasticsearch"
+
+        def gems
+          [
+            {name: "pg_search", version: "~> 2.3"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate pg_search:migration:multisearch"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Search: Run `bin/rails db:migrate` to create pg_search tables",
+            "Search: Add `include PgSearch::Model` to models you want to search",
+            "Search: Requires PostgreSQL database"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class SecurityPack < FeaturePack
+        pack_name "security"
+        description "Brakeman + bundler-audit for security scanning"
+        category "ops"
+
+        def gems
+          [
+            {name: "brakeman", group: :development},
+            {name: "bundler-audit", group: :development}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Security: Run `bundle exec brakeman` to scan for vulnerabilities",
+            "Security: Run `bundle exec bundler-audit check --update` to check gem CVEs",
+            "Security: Add both to CI for continuous security checks"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,44 @@
+module Rails
+  module Metro
+    module Packs
+      class SendgridPack < FeaturePack
+        pack_name "sendgrid"
+        description "SendGrid for transactional and marketing email delivery"
+        category "notifications"
+
+        def gems
+          [
+            {name: "sendgrid-ruby"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/sendgrid.rb", <<~RUBY',
+            "  ActionMailer::Base.smtp_settings = {",
+            '    user_name: "apikey",',
+            '    password: Rails.application.credentials.dig(:sendgrid, :api_key) || ENV["SENDGRID_API_KEY"],',
+            '    domain: Rails.application.credentials.dig(:sendgrid, :domain) || "example.com",',
+            '    address: "smtp.sendgrid.net",',
+            "    port: 587,",
+            "    authentication: :plain,",
+            "    enable_starttls_auto: true",
+            "  }",
+            "RUBY",
+            "",
+            'environment "config.action_mailer.delivery_method = :smtp", env: "production"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "SendGrid: Add your API key with `bin/rails credentials:edit`:",
+            "  sendgrid:",
+            "    api_key: SG.your_api_key_here",
+            "    domain: yourdomain.com"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module Rails
+  module Metro
+    module Packs
+      class SentDmPack < FeaturePack
+        pack_name "sent_dm"
+        description "Sent.dm for multi-channel message delivery (email, SMS, push)"
+        category "notifications"
+
+        def gems
+          [
+            {name: "sent_dm"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/sent_dm.rb", <<~RUBY',
+            "  SentDm.configure do |config|",
+            '    config.api_key = Rails.application.credentials.dig(:sent_dm, :api_key) || ENV["SENT_DM_API_KEY"]',
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Sent.dm: Add your API key with `bin/rails credentials:edit`:",
+            "  sent_dm:",
+            "    api_key: your_api_key_here",
+            "Sent.dm: Supports email, SMS, and push notifications from a single API"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,40 @@
+module Rails
+  module Metro
+    module Packs
+      class SeoPack < FeaturePack
+        pack_name "seo"
+        description "meta-tags + sitemap_generator for SEO"
+        category "seo"
+
+        def gems
+          [
+            {name: "meta-tags", version: "~> 2.22"},
+            {name: "sitemap_generator", version: "~> 6.3"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/sitemap.rb", <<~RUBY',
+            '  SitemapGenerator::Sitemap.default_host = "https://example.com"',
+            "",
+            "  SitemapGenerator::Sitemap.create do",
+            '    add "/about", changefreq: "monthly"',
+            "  end",
+            "RUBY",
+            'inject_into_file "app/views/layouts/application.html.erb", after: "<head>\\n" do',
+            '  "    <%= display_meta_tags site: \\"My App\\" %>\\n"',
+            "end"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "SEO: Use `set_meta_tags title: \"Page\"` in controllers",
+            "SEO: Generate sitemap with `bin/rails sitemap:refresh`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+module Rails
+  module Metro
+    module Packs
+      class ShouldaMatchersPack < FeaturePack
+        pack_name "shoulda_matchers"
+        description "Shoulda Matchers for one-liner model and controller test assertions"
+        category "testing"
+
+        def gems
+          [
+            {name: "shoulda-matchers", group: :test}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "test/support/shoulda_matchers.rb", <<~RUBY',
+            "  Shoulda::Matchers.configure do |config|",
+            "    config.integrate do |with|",
+            "      with.test_framework :minitest",
+            "      with.library :rails",
+            "    end",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Shoulda: Use `should validate_presence_of(:name)` in model tests",
+            "Shoulda: Use `should belong_to(:user)` for association tests"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+module Rails
+  module Metro
+    module Packs
+      class SidekiqPack < FeaturePack
+        pack_name "sidekiq"
+        description "Sidekiq for Redis-backed background jobs (high throughput)"
+        category "core"
+        conflicts_with "background_jobs", "good_job"
+
+        def gems
+          [
+            {name: "sidekiq", version: "~> 7.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            'environment "config.active_job.queue_adapter = :sidekiq"',
+            "",
+            'create_file "config/sidekiq.yml", <<~YML',
+            "  :concurrency: 5",
+            "  :queues:",
+            "    - default",
+            "    - mailers",
+            "YML",
+            "",
+            'route "require \\"sidekiq/web\\"',
+            "  mount Sidekiq::Web => \\\"/sidekiq\\\"\""
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Sidekiq: Requires Redis -- install and run `redis-server`",
+            "Sidekiq: Start worker with `bundle exec sidekiq`",
+            "Sidekiq: Monitor jobs at /sidekiq"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Rails
+  module Metro
+    module Packs
+      class SimpleCalendarPack < FeaturePack
+        pack_name "simple_calendar"
+        description "Simple Calendar for month/week/day calendar views"
+        category "ui"
+
+        def gems
+          [
+            {name: "simple_calendar", version: "~> 3.0"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Simple Calendar: Use `<%= month_calendar events: @events do |date, events| %>` in views",
+            "Simple Calendar: Models need a `start_time` attribute (or configure with `attribute: :my_date`)",
+            "Simple Calendar: Supports month_calendar, week_calendar, and custom ranges"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class SimpleFormPack < FeaturePack
+        pack_name "simple_form"
+        description "Simple Form for easy, flexible form building"
+        category "ui"
+
+        def gems
+          [
+            {name: "simple_form"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate simple_form:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Simple Form: Use `<%= simple_form_for @user do |f| %>` in views",
+            "Simple Form: Customize wrappers in config/initializers/simple_form.rb"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+module Rails
+  module Metro
+    module Packs
+      class SimplecovPack < FeaturePack
+        pack_name "simplecov"
+        description "SimpleCov for code coverage reporting"
+        category "testing"
+
+        def gems
+          [
+            {name: "simplecov", group: :test}
+          ]
+        end
+
+        def template_lines
+          [
+            'prepend_to_file "test/test_helper.rb", <<~RUBY',
+            '  require "simplecov"',
+            "  SimpleCov.start \"rails\" do",
+            '    add_filter "/test/"',
+            '    add_filter "/config/"',
+            "    enable_coverage :branch",
+            "  end",
+            "",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "SimpleCov: Coverage report generated at coverage/index.html after running tests",
+            "SimpleCov: Branch coverage enabled by default"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module Rails
+  module Metro
+    module Packs
+      class SlackNotifierPack < FeaturePack
+        pack_name "slack_notifier"
+        description "Slack Notifier for sending webhook notifications to Slack"
+        category "notifications"
+
+        def gems
+          [
+            {name: "slack-notifier"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/slack.rb", <<~RUBY',
+            "  SLACK_NOTIFIER = Slack::Notifier.new(",
+            '    Rails.application.credentials.dig(:slack, :webhook_url) || ENV["SLACK_WEBHOOK_URL"]',
+            "  )",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Slack: Add your webhook URL with `bin/rails credentials:edit`:",
+            "  slack:",
+            "    webhook_url: https://hooks.slack.com/services/...",
+            "Slack: Send with `SLACK_NOTIFIER.ping(\"Hello from Rails!\")`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class SoftDeletesPack < FeaturePack
+        pack_name "soft_deletes"
+        description "Discard for soft deletes (archive instead of destroy)"
+        category "data"
+
+        def gems
+          [
+            {name: "discard", version: "~> 1.3"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Discard: Add `include Discard::Model` to models",
+            "Discard: Add `discarded_at:datetime` column via migration",
+            "Discard: Use `record.discard` instead of `record.destroy`",
+            "Discard: Query with `User.kept` and `User.discarded`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class SolidusPack < FeaturePack
+        pack_name "solidus"
+        description "Solidus for full-featured e-commerce (products, orders, payments)"
+        category "payments"
+
+        def gems
+          [
+            {name: "solidus"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate solidus:install --auto-accept"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Solidus: Run `bin/rails db:migrate` and `bin/rails db:seed` to set up",
+            "Solidus: Admin panel at /admin (default: admin@example.com / test123)",
+            "Solidus: See https://solidus.io/docs for customization guides"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Rails
+  module Metro
+    module Packs
+      class SpreadsheetsPack < FeaturePack
+        pack_name "spreadsheets"
+        description "Caxlsx for Excel spreadsheet generation"
+        category "ui"
+
+        def gems
+          [
+            {name: "caxlsx"},
+            {name: "caxlsx_rails"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Spreadsheets: Create .xlsx templates in app/views with `.xlsx.axlsx` extension",
+            "Spreadsheets: Use `format.xlsx` in controllers to serve Excel downloads"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,41 @@
+module Rails
+  module Metro
+    module Packs
+      class StatcounterPack < FeaturePack
+        pack_name "statcounter"
+        description "StatCounter for visitor stats and web analytics"
+        category "analytics"
+
+        def gems
+          []
+        end
+
+        def template_lines
+          [
+            'create_file "app/views/layouts/_statcounter.html.erb", <<~ERB',
+            "  <script type=\"text/javascript\">",
+            "    var sc_project=<%%= Rails.application.credentials.dig(:statcounter, :project_id) || ENV[\"STATCOUNTER_PROJECT_ID\"] %>;",
+            "    var sc_invisible=1;",
+            "    var sc_security=\"<%%= Rails.application.credentials.dig(:statcounter, :security_code) || ENV[\"STATCOUNTER_SECURITY\"] %>\";",
+            "  </script>",
+            '  <script type="text/javascript" src="https://www.statcounter.com/counter/counter.js" async></script>',
+            "ERB",
+            "",
+            'inject_into_file "app/views/layouts/application.html.erb", before: "</body>" do',
+            '  "    <%= render \\"layouts/statcounter\\" %>\\n"',
+            "end"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "StatCounter: Add your project credentials with `bin/rails credentials:edit`:",
+            "  statcounter:",
+            "    project_id: 12345678",
+            "    security_code: your_security_code"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Rails
+  module Metro
+    module Packs
+      class StimulusComponentsPack < FeaturePack
+        pack_name "stimulus_components"
+        description "Stimulus Components -- pre-built Stimulus controllers (dropdowns, modals, etc.)"
+        category "ui"
+
+        def gems
+          [
+            {name: "stimulus-rails"}
+          ]
+        end
+
+        def template_lines
+          [
+            'append_to_file "config/importmap.rb", <<~RUBY',
+            '  pin "stimulus-use", to: "https://ga.jspm.io/npm:stimulus-use/dist/index.js"',
+            '  pin "stimulus-components", to: "https://ga.jspm.io/npm:stimulus-components/dist/index.js"',
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Stimulus Components: Pre-built controllers for dropdowns, modals, tabs, clipboard, etc.",
+            "Stimulus Components: See https://www.stimulus-components.com for full list"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+module Rails
+  module Metro
+    module Packs
+      class StorageValidationsPack < FeaturePack
+        pack_name "storage_validations"
+        description "Active Storage Validations for file type, size, and dimension checks"
+        category "data"
+
+        def gems
+          [
+            {name: "active_storage_validations"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Storage Validations: Use `validates :avatar, attached: true, content_type: :image` in models",
+            "Storage Validations: Supports size, dimension, aspect ratio, and content type validations"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class StrongMigrationsPack < FeaturePack
+        pack_name "strong_migrations"
+        description "Strong Migrations -- catch unsafe migrations before they run"
+        category "data"
+
+        def gems
+          [
+            {name: "strong_migrations"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate strong_migrations:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Strong Migrations: Dangerous migrations will raise errors with safe alternatives",
+            "Strong Migrations: Use `safety_assured { }` to override when you know it's safe"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class TaggingPack < FeaturePack
+        pack_name "tagging"
+        description "Acts As Taggable On for tagging models"
+        category "data"
+
+        def gems
+          [
+            {name: "acts-as-taggable-on", version: "~> 11.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "acts_as_taggable_on_engine:install:migrations"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Tagging: Run `bin/rails db:migrate` to create tag tables",
+            "Tagging: Add `acts_as_taggable_on :tags` to models",
+            "Tagging: Use `@post.tag_list.add(\"ruby\", \"rails\")`"
+          ]
+        end
+      end
+    end
+  end
+end