rails-metro 0.1.0

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

@@ -0,0 +1,38 @@
+module Rails
+  module Metro
+    module Packs
+      class ApiSerializationPack < FeaturePack
+        pack_name "api_serialization"
+        description "Alba for fast, flexible JSON serialization"
+        category "api"
+
+        def gems
+          [
+            {name: "alba", version: "~> 3.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/alba.rb", <<~RUBY',
+            "  Alba.backend = :oj",
+            "RUBY",
+            "",
+            'create_file "app/resources/application_resource.rb", <<~RUBY',
+            "  class ApplicationResource",
+            "    include Alba::Resource",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Alba: Create resources in app/resources/ inheriting from ApplicationResource",
+            "Alba: Use `UserResource.new(user).serialize` to generate JSON"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,35 @@
+module Rails
+  module Metro
+    module Packs
+      class AppLintingPack < FeaturePack
+        pack_name "app_linting"
+        description "Standard Ruby + ERB Lint for code and template linting"
+        category "ops"
+
+        def gems
+          [
+            {name: "standard", group: :development},
+            {name: "erb_lint", group: :development}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file ".standard.yml", <<~YML',
+            "  # Standard Ruby configuration",
+            "  # See: https://github.com/standardrb/standard",
+            "YML"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Linting: Run `bundle exec standardrb` to check Ruby code",
+            "Linting: Run `bundle exec standardrb --fix` to auto-fix",
+            "Linting: Run `bundle exec erblint --lint-all` to check ERB templates"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class AuditTrailPack < FeaturePack
+        pack_name "audit_trail"
+        description "PaperTrail for model versioning and audit trail"
+        category "data"
+
+        def gems
+          [
+            {name: "paper_trail", version: "~> 16.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate paper_trail:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "PaperTrail: Run `bin/rails db:migrate` to create versions table",
+            "PaperTrail: Add `has_paper_trail` to models you want to track",
+            "PaperTrail: Access history with `record.versions` and `record.paper_trail.previous_version`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class AuthenticationPack < FeaturePack
+        pack_name "authentication"
+        description "authentication-zero (generates code you own, 2FA, recovery codes)"
+        category "core"
+        conflicts_with "devise", "passwordless"
+
+        def gems
+          [
+            {name: "authentication-zero"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate authentication"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Authentication: Run `bin/rails db:migrate` to create auth tables",
+            "Authentication: See app/controllers/sessions_controller.rb to customize login flow"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class AuthorizationPack < FeaturePack
+        pack_name "authorization"
+        description "Action Policy for authorization (Rails-idiomatic, scoping, caching)"
+        category "core"
+        conflicts_with "pundit"
+
+        def gems
+          [
+            {name: "action_policy", version: "~> 0.7"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate action_policy:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Authorization: Generate policies with `bin/rails g action_policy:policy User`",
+            "Authorization: See https://actionpolicy.evilmartians.io for docs"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+module Rails
+  module Metro
+    module Packs
+      class AvoPack < FeaturePack
+        pack_name "avo"
+        description "Avo -- modern, customizable admin panel framework"
+        category "admin"
+        conflicts_with "administrate", "activeadmin", "madmin"
+
+        def gems
+          [
+            {name: "avo"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate avo:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Avo: Run `bin/rails db:migrate` to create Avo tables",
+            "Avo: Access admin at /avo",
+            "Avo: Generate resources with `bin/rails g avo:resource User`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+module Rails
+  module Metro
+    module Packs
+      class AwsSesPack < FeaturePack
+        pack_name "aws_ses"
+        description "Amazon SES for high-volume email delivery"
+        category "notifications"
+
+        def gems
+          [
+            {name: "aws-sdk-sesv2"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/aws_ses.rb", <<~RUBY',
+            "  ActionMailer::Base.smtp_settings = {",
+            '    address: "email-smtp.\#{Rails.application.credentials.dig(:aws_ses, :region) || ENV["AWS_REGION"] || "us-east-1"}.amazonaws.com",',
+            "    port: 587,",
+            '    user_name: Rails.application.credentials.dig(:aws_ses, :smtp_username) || ENV["AWS_SES_SMTP_USERNAME"],',
+            '    password: Rails.application.credentials.dig(:aws_ses, :smtp_password) || ENV["AWS_SES_SMTP_PASSWORD"],',
+            "    authentication: :plain,",
+            "    enable_starttls_auto: true",
+            "  }",
+            "RUBY",
+            "",
+            'environment "config.action_mailer.delivery_method = :smtp", env: "production"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "AWS SES: Add your SMTP credentials with `bin/rails credentials:edit`:",
+            "  aws_ses:",
+            "    smtp_username: your_smtp_username",
+            "    smtp_password: your_smtp_password",
+            "    region: us-east-1",
+            "AWS SES: Verify your sending domain/email in the AWS SES console"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+module Rails
+  module Metro
+    module Packs
+      class BackgroundJobsPack < FeaturePack
+        pack_name "background_jobs"
+        description "Solid Queue + Mission Control Jobs (Rails 8 default, no Redis)"
+        category "core"
+        conflicts_with "sidekiq", "good_job"
+
+        def gems
+          [
+            {name: "solid_queue"},
+            {name: "mission_control-jobs"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "solid_queue:install"',
+            'route "mount MissionControl::Jobs::Engine, at: \\"/jobs\\""'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Background Jobs: Run `bin/rails db:migrate` to create Solid Queue tables",
+            "Background Jobs: Monitor jobs at /jobs",
+            "Background Jobs: Start the worker with `bin/jobs`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,62 @@
+module Rails
+  module Metro
+    module Packs
+      class BlazerPack < FeaturePack
+        pack_name "blazer"
+        description "SQL analytics dashboards with Blazer"
+        category "analytics"
+
+        def gems
+          [
+            {name: "blazer", version: "~> 3.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            generator_lines,
+            route_lines,
+            auth_initializer_lines
+          ].flatten
+        end
+
+        def post_install_notes
+          [
+            "Blazer: Run `bin/rails db:migrate` to create Blazer tables",
+            "Blazer: Access dashboards at /blazer",
+            "Blazer: For production, set BLAZER_DATABASE_URL to a read-only database connection"
+          ]
+        end
+
+        private
+
+        def generator_lines
+          [
+            'rails_command "generate blazer:install"'
+          ]
+        end
+
+        def route_lines
+          [
+            'route "mount Blazer::Engine, at: \\"blazer\\""'
+          ]
+        end
+
+        def auth_initializer_lines
+          [
+            'create_file "config/initializers/blazer.rb", <<~RUBY',
+            "  # Blazer authentication",
+            "  # For production, replace with your app's authentication:",
+            "  #   authenticate :user, ->(u) { u.admin? } do",
+            "  #     mount Blazer::Engine, at: \"blazer\"",
+            "  #   end",
+            "  #",
+            "  # Or set ENV[\"BLAZER_USERNAME\"] and ENV[\"BLAZER_PASSWORD\"] for basic auth",
+            "  ENV[\"BLAZER_DATABASE_URL\"] ||= ENV[\"DATABASE_URL\"]",
+            "RUBY"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class BreadcrumbsPack < FeaturePack
+        pack_name "breadcrumbs"
+        description "Gretel for flexible breadcrumb navigation"
+        category "ui"
+
+        def gems
+          [
+            {name: "gretel"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate gretel:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Breadcrumbs: Define breadcrumbs in config/breadcrumbs.rb",
+            "Breadcrumbs: Set in controllers with `breadcrumb :home, root_path`",
+            "Breadcrumbs: Render with `<%= breadcrumbs %>` in layouts"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class CachingPack < FeaturePack
+        pack_name "caching"
+        description "Solid Cache (Rails 8 default, database-backed caching)"
+        category "core"
+
+        def gems
+          [
+            {name: "solid_cache"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "solid_cache:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Caching: Run `bin/rails db:migrate` to create Solid Cache tables",
+            "Caching: Already configured as the default cache store in production"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,67 @@
+module Rails
+  module Metro
+    module Packs
+      class ChartingPack < FeaturePack
+        pack_name "charting"
+        description "Chartkick + Groupdate for charts and time-series visualization"
+        category "ui"
+
+        def gems
+          [
+            {name: "chartkick", version: "~> 5.2"},
+            {name: "groupdate", version: "~> 6.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            importmap_lines,
+            layout_js_lines,
+            sample_partial_lines
+          ].flatten
+        end
+
+        def post_install_notes
+          [
+            "Charting: Use `<%= line_chart User.group_by_day(:created_at).count %>` in views",
+            "Charting: Groupdate adds `.group_by_day`, `.group_by_week`, etc. to ActiveRecord",
+            "Charting: See https://chartkick.com for full documentation"
+          ]
+        end
+
+        private
+
+        def importmap_lines
+          [
+            "# Pin Chartkick JS for importmap-rails",
+            'append_to_file "config/importmap.rb", <<~RUBY',
+            '  pin "chartkick", to: "chartkick.js"',
+            '  pin "Chart.bundle", to: "Chart.bundle.js"',
+            "RUBY"
+          ]
+        end
+
+        def layout_js_lines
+          [
+            'inject_into_file "app/views/layouts/application.html.erb", before: "</head>" do',
+            '  "    <%= javascript_include_tag \\"chartkick\\" %>\\n"',
+            "end"
+          ]
+        end
+
+        def sample_partial_lines
+          [
+            'create_file "app/views/shared/_sample_chart.html.erb", <<~ERB',
+            "  <%# Example charts -- remove or customize %>",
+            "  <div class=\"charts\">",
+            "    <h2>Sample Charts</h2>",
+            '    <%%= line_chart({"Jan" => 100, "Feb" => 150, "Mar" => 200}, title: "Monthly Growth") %>',
+            '    <%%= pie_chart({"Ruby" => 40, "JavaScript" => 30, "Python" => 20, "Other" => 10}, title: "Languages") %>',
+            "  </div>",
+            "ERB"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+module Rails
+  module Metro
+    module Packs
+      class CircuitBreakerPack < FeaturePack
+        pack_name "circuit_breaker"
+        description "Circuitbox for circuit breaking on external service calls"
+        category "ops"
+
+        def gems
+          [
+            {name: "circuitbox"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/circuitbox.rb", <<~RUBY',
+            "  Circuitbox.configure do |config|",
+            "    config.default_circuit_store = Circuitbox::MemoryStore.new",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Circuitbox: Wrap external calls with `Circuitbox.circuit(:my_service, exceptions: [Timeout::Error]) { call }`",
+            "Circuitbox: Circuit opens after repeated failures, preventing cascade failures"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+module Rails
+  module Metro
+    module Packs
+      class ClickyPack < FeaturePack
+        pack_name "clicky"
+        description "Clicky for real-time web analytics"
+        category "analytics"
+
+        def gems
+          []
+        end
+
+        def template_lines
+          [
+            'create_file "app/views/layouts/_clicky.html.erb", <<~ERB',
+            "  <script>var clicky_site_ids = clicky_site_ids || []; clicky_site_ids.push(<%%= Rails.application.credentials.dig(:clicky, :site_id) || ENV[\"CLICKY_SITE_ID\"] %>);</script>",
+            '  <script async src="//static.getclicky.com/js"></script>',
+            '  <noscript><p><img alt="Clicky" width="1" height="1" src="//in.getclicky.com/<%%= Rails.application.credentials.dig(:clicky, :site_id) || ENV["CLICKY_SITE_ID"] %>ns.gif" /></p></noscript>',
+            "ERB",
+            "",
+            'inject_into_file "app/views/layouts/application.html.erb", before: "</body>" do',
+            '  "    <%= render \\"layouts/clicky\\" %>\\n"',
+            "end"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Clicky: Add your site ID with `bin/rails credentials:edit`:",
+            "  clicky:",
+            "    site_id: 123456"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+module Rails
+  module Metro
+    module Packs
+      class CloudinaryPack < FeaturePack
+        pack_name "cloudinary"
+        description "Cloudinary for cloud image and video management"
+        category "ui"
+
+        def gems
+          [
+            {name: "cloudinary"},
+            {name: "activestorage-cloudinary-service"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/cloudinary.rb", <<~RUBY',
+            "  Cloudinary.config do |config|",
+            '    config.cloud_name = Rails.application.credentials.dig(:cloudinary, :cloud_name) || ENV["CLOUDINARY_CLOUD_NAME"]',
+            '    config.api_key = Rails.application.credentials.dig(:cloudinary, :api_key) || ENV["CLOUDINARY_API_KEY"]',
+            '    config.api_secret = Rails.application.credentials.dig(:cloudinary, :api_secret) || ENV["CLOUDINARY_API_SECRET"]',
+            "    config.secure = true",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Cloudinary: Add your credentials with `bin/rails credentials:edit`:",
+            "  cloudinary:",
+            "    cloud_name: your_cloud_name",
+            "    api_key: your_api_key",
+            "    api_secret: your_api_secret",
+            "Cloudinary: Use as Active Storage service by setting `service: Cloudinary` in storage.yml"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class ComponentsPack < FeaturePack
+        pack_name "components"
+        description "ViewComponent for component-based views"
+        category "ui"
+
+        def gems
+          [
+            {name: "view_component", version: "~> 3.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate component Example title --stimulus"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Components: Generate with `bin/rails g component MyComponent`",
+            "Components: See https://viewcomponent.org for docs"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Rails
+  module Metro
+    module Packs
+      class CounterCulturePack < FeaturePack
+        pack_name "counter_culture"
+        description "Counter Culture for turbo-charged counter caches"
+        category "data"
+
+        def gems
+          [
+            {name: "counter_culture"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Counter Culture: Add `counter_culture :category` to models",
+            "Counter Culture: Supports conditional counters, multi-level, and custom columns",
+            "Counter Culture: Fix counts with `Model.counter_culture_fix_counts`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Rails
+  module Metro
+    module Packs
+      class DataMigratePack < FeaturePack
+        pack_name "data_migrate"
+        description "Data Migrate for separating data migrations from schema migrations"
+        category "data"
+
+        def gems
+          [
+            {name: "data_migrate"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Data Migrate: Generate with `bin/rails g data_migration backfill_users`",
+            "Data Migrate: Run with `bin/rails data:migrate`",
+            "Data Migrate: Data migrations live in db/data/ separate from schema migrations"
+          ]
+        end
+      end
+    end
+  end
+end