rails-metro 0.1.0

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

@@ -0,0 +1,41 @@
+module Rails
+  module Metro
+    module Packs
+      class DatadogPack < FeaturePack
+        pack_name "datadog"
+        description "Datadog APM for tracing, metrics, and log management"
+        category "ops"
+
+        def gems
+          [
+            {name: "datadog"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/datadog.rb", <<~RUBY',
+            "  Datadog.configure do |c|",
+            "    c.service = Rails.application.class.module_parent_name.underscore",
+            "    c.env = Rails.env",
+            "",
+            "    c.tracing.instrument :rails",
+            "    c.tracing.instrument :http",
+            "    c.tracing.instrument :active_record",
+            "    c.tracing.instrument :redis if defined?(Redis)",
+            "    c.tracing.instrument :sidekiq if defined?(Sidekiq)",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Datadog: Install the Datadog Agent on your server (not a Ruby gem)",
+            "Datadog: Set DD_API_KEY and DD_ENV environment variables in production"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module Rails
+  module Metro
+    module Packs
+      class DeploymentPack < FeaturePack
+        pack_name "deployment"
+        description "Kamal for zero-downtime deploys to any Linux box"
+        category "ops"
+
+        def gems
+          [
+            {name: "kamal", version: "~> 2.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate kamal"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Deployment: Edit config/deploy.yml with your server details",
+            "Deployment: Run `kamal setup` to provision, then `kamal deploy`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+module Rails
+  module Metro
+    module Packs
+      class DevisePack < FeaturePack
+        pack_name "devise"
+        description "Devise for full-featured authentication (OmniAuth, LDAP, etc.)"
+        category "core"
+        conflicts_with "authentication", "passwordless"
+
+        def gems
+          [
+            {name: "devise"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate devise:install"',
+            'rails_command "generate devise User"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Devise: Run `bin/rails db:migrate` to create users table",
+            "Devise: Generate views with `bin/rails g devise:views`",
+            "Devise: Configure mailer sender in config/initializers/devise.rb"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+module Rails
+  module Metro
+    module Packs
+      class DoorkeeperPack < FeaturePack
+        pack_name "doorkeeper"
+        description "Doorkeeper for OAuth2 provider (issue tokens, authorize apps)"
+        category "api"
+
+        def gems
+          [
+            {name: "doorkeeper"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate doorkeeper:install"',
+            'rails_command "generate doorkeeper:migration"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Doorkeeper: Run `bin/rails db:migrate` to create OAuth tables",
+            "Doorkeeper: Configure resource owner in config/initializers/doorkeeper.rb",
+            "Doorkeeper: Manage OAuth apps at /oauth/applications"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module Rails
+  module Metro
+    module Packs
+      class DotenvPack < FeaturePack
+        pack_name "dotenv"
+        description "Dotenv for loading .env files in development"
+        category "ops"
+
+        def gems
+          [
+            {name: "dotenv-rails", group: :development}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file ".env.example", <<~ENV',
+            "  # Copy to .env and fill in values",
+            "  # DATABASE_URL=postgres://localhost/myapp_development",
+            "  # RAILS_MASTER_KEY=your_master_key",
+            "ENV",
+            "",
+            'append_to_file ".gitignore", "\\n.env\\n.env.local\\n"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Dotenv: Copy .env.example to .env and fill in your values",
+            "Dotenv: .env files are gitignored -- never commit secrets"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class ElasticsearchPack < FeaturePack
+        pack_name "elasticsearch"
+        description "Searchkick for Elasticsearch-powered search"
+        category "data"
+        conflicts_with "search", "meilisearch"
+
+        def gems
+          [
+            {name: "searchkick"}
+          ]
+        end
+
+        def template_lines
+          []
+        end
+
+        def post_install_notes
+          [
+            "Searchkick: Install and run Elasticsearch (or OpenSearch)",
+            "Searchkick: Add `searchkick` to models you want to search",
+            "Searchkick: Reindex with `Model.reindex`",
+            "Searchkick: Search with `Model.search(\"query\")`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+module Rails
+  module Metro
+    module Packs
+      class EncryptionPack < FeaturePack
+        pack_name "encryption"
+        description "Lockbox for application-level field encryption"
+        category "data"
+
+        def gems
+          [
+            {name: "lockbox"},
+            {name: "blind_index"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/lockbox.rb", <<~RUBY',
+            "  Lockbox.master_key = Rails.application.credentials.dig(:lockbox, :master_key) || ENV[\"LOCKBOX_MASTER_KEY\"]",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Lockbox: Generate a master key with `Lockbox.generate_key`",
+            "Lockbox: Add to credentials with `bin/rails credentials:edit`:",
+            "  lockbox:",
+            "    master_key: your_generated_key",
+            "Lockbox: Use `encrypts :email` in models to encrypt fields",
+            "Lockbox: Use `blind_index :email` for searchable encrypted fields"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,40 @@
+module Rails
+  module Metro
+    module Packs
+      class ErrorTrackingPack < FeaturePack
+        pack_name "error_tracking"
+        description "Sentry for error tracking and performance monitoring"
+        category "ops"
+        conflicts_with "honeybadger", "rollbar"
+
+        def gems
+          [
+            {name: "sentry-ruby"},
+            {name: "sentry-rails"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/sentry.rb", <<~RUBY',
+            "  Sentry.init do |config|",
+            '    config.dsn = Rails.application.credentials.dig(:sentry, :dsn) || ENV["SENTRY_DSN"]',
+            "    config.breadcrumbs_logger = [:active_support_logger, :http_logger]",
+            "    config.traces_sample_rate = 0.1",
+            "    config.profiles_sample_rate = 0.1",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Sentry: Add your DSN with `bin/rails credentials:edit`:",
+            "  sentry:",
+            "    dsn: https://your-dsn@sentry.io/project-id"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class EventSourcingPack < FeaturePack
+        pack_name "event_sourcing"
+        description "Rails Event Store for event sourcing and CQRS"
+        category "data"
+
+        def gems
+          [
+            {name: "rails_event_store"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate rails_event_store_active_record:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Event Store: Run `bin/rails db:migrate` to create events table",
+            "Event Store: Publish events with `Rails.configuration.event_store.publish(event)`",
+            "Event Store: Browse events at /res if you mount the browser engine"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+module Rails
+  module Metro
+    module Packs
+      class FaradayPack < FeaturePack
+        pack_name "faraday"
+        description "Faraday for composable HTTP client requests"
+        category "core"
+
+        def gems
+          [
+            {name: "faraday", version: "~> 2.0"},
+            {name: "faraday-retry"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "app/clients/application_client.rb", <<~RUBY',
+            "  class ApplicationClient",
+            "    def connection",
+            "      @connection ||= Faraday.new do |f|",
+            "        f.request :json",
+            "        f.response :json",
+            "        f.request :retry, max: 2, interval: 0.5",
+            "        f.adapter Faraday.default_adapter",
+            "      end",
+            "    end",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Faraday: Base client class at app/clients/application_client.rb",
+            "Faraday: Create service-specific clients inheriting from ApplicationClient"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module Rails
+  module Metro
+    module Packs
+      class FathomPack < FeaturePack
+        pack_name "fathom"
+        description "Fathom -- simple, privacy-focused website analytics"
+        category "analytics"
+
+        def gems
+          []
+        end
+
+        def template_lines
+          [
+            'create_file "app/views/layouts/_fathom.html.erb", <<~ERB',
+            '  <script src="https://cdn.usefathom.com/script.js" data-site="<%%= Rails.application.credentials.dig(:fathom, :site_id) || ENV["FATHOM_SITE_ID"] %>" defer></script>',
+            "ERB",
+            "",
+            'inject_into_file "app/views/layouts/application.html.erb", after: "<head>\\n" do',
+            '  "    <%= render \\"layouts/fathom\\" %>\\n"',
+            "end"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Fathom: Add your site ID with `bin/rails credentials:edit`:",
+            "  fathom:",
+            "    site_id: ABCDEFGH",
+            "Fathom: No cookie banner needed -- privacy-first, GDPR compliant"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+module Rails
+  module Metro
+    module Packs
+      class FeatureFlagsPack < FeaturePack
+        pack_name "feature_flags"
+        description "Flipper for feature flags with web UI"
+        category "ops"
+
+        def gems
+          [
+            {name: "flipper"},
+            {name: "flipper-active_record"},
+            {name: "flipper-ui"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate flipper:setup"',
+            'route "mount Flipper::UI.app(Flipper) => \\"/flipper\\""'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Feature Flags: Run `bin/rails db:migrate` to create Flipper tables",
+            "Feature Flags: Manage flags at /flipper",
+            "Feature Flags: Use `Flipper.enabled?(:my_feature)` in code"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class FriendlyIdPack < FeaturePack
+        pack_name "friendly_id"
+        description "FriendlyId for human-readable URL slugs"
+        category "ui"
+
+        def gems
+          [
+            {name: "friendly_id", version: "~> 5.5"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate friendly_id"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "FriendlyId: Run `bin/rails db:migrate` to create slugs table",
+            "FriendlyId: Add `extend FriendlyId` and `friendly_id :name, use: :slugged` to models",
+            "FriendlyId: Use `User.friendly.find(\"john-doe\")` instead of `User.find(id)`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+module Rails
+  module Metro
+    module Packs
+      class GeocoderPack < FeaturePack
+        pack_name "geocoder"
+        description "Geocoder for address lookup, geocoding, and distance queries"
+        category "data"
+
+        def gems
+          [
+            {name: "geocoder"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/geocoder.rb", <<~RUBY',
+            "  Geocoder.configure(",
+            "    timeout: 5,",
+            "    lookup: :nominatim,",
+            "    units: :mi,",
+            "    cache: Rails.cache",
+            "  )",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Geocoder: Add `geocoded_by :address` to models with latitude/longitude columns",
+            "Geocoder: Use `Model.near(\"New York\", 50)` for proximity search",
+            "Geocoder: Default uses free Nominatim API -- switch to Google/Mapbox for production"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+module Rails
+  module Metro
+    module Packs
+      class GoodJobPack < FeaturePack
+        pack_name "good_job"
+        description "GoodJob for Postgres-backed background jobs (no Redis needed)"
+        category "core"
+        conflicts_with "background_jobs", "sidekiq"
+
+        def gems
+          [
+            {name: "good_job", version: "~> 4.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            'environment "config.active_job.queue_adapter = :good_job"',
+            'rails_command "generate good_job:install"',
+            'route "mount GoodJob::Engine => \\"/good_job\\""'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "GoodJob: Run `bin/rails db:migrate` to create job tables",
+            "GoodJob: Monitor jobs at /good_job",
+            "GoodJob: Supports cron-like recurring jobs via config/good_job.yml"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+module Rails
+  module Metro
+    module Packs
+      class GoogleAnalyticsPack < FeaturePack
+        pack_name "google_analytics"
+        description "Google Analytics 4 (GA4) for web analytics"
+        category "analytics"
+
+        def gems
+          []
+        end
+
+        def template_lines
+          [
+            'create_file "app/views/layouts/_google_analytics.html.erb", <<~ERB',
+            "  <!-- Google Analytics 4 -->",
+            '  <script async src="https://www.googletagmanager.com/gtag/js?id=<%%= Rails.application.credentials.dig(:google_analytics, :measurement_id) || ENV["GA_MEASUREMENT_ID"] %>"></script>',
+            "  <script>",
+            "    window.dataLayer = window.dataLayer || [];",
+            "    function gtag(){dataLayer.push(arguments);}",
+            '    gtag("js", new Date());',
+            '    gtag("config", "<%%= Rails.application.credentials.dig(:google_analytics, :measurement_id) || ENV["GA_MEASUREMENT_ID"] %>");',
+            "  </script>",
+            "ERB",
+            "",
+            'inject_into_file "app/views/layouts/application.html.erb", after: "<head>\\n" do',
+            '  "    <%= render \\"layouts/google_analytics\\" %>\\n"',
+            "end"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Google Analytics: Add your measurement ID with `bin/rails credentials:edit`:",
+            "  google_analytics:",
+            "    measurement_id: G-XXXXXXXXXX"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+module Rails
+  module Metro
+    module Packs
+      class GoogleTagManagerPack < FeaturePack
+        pack_name "google_tag_manager"
+        description "Google Tag Manager for managing analytics and marketing tags"
+        category "analytics"
+
+        def gems
+          []
+        end
+
+        def template_lines
+          [
+            'create_file "app/views/layouts/_gtm_head.html.erb", <<~ERB',
+            "  <!-- Google Tag Manager -->",
+            "  <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({\"gtm.start\":",
+            '  new Date().getTime(),event:"gtm.js"});var f=d.getElementsByTagName(s)[0],',
+            '  j=d.createElement(s),dl=l!="dataLayer"?"&l="+l:"";j.async=true;j.src=',
+            '  "https://www.googletagmanager.com/gtm.js?id="+i+dl;f.parentNode.insertBefore(j,f);',
+            '  })(window,document,"script","dataLayer","<%%= Rails.application.credentials.dig(:gtm, :container_id) || ENV["GTM_CONTAINER_ID"] %>");</script>',
+            "ERB",
+            "",
+            'create_file "app/views/layouts/_gtm_body.html.erb", <<~ERB',
+            "  <!-- Google Tag Manager (noscript) -->",
+            '  <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=<%%= Rails.application.credentials.dig(:gtm, :container_id) || ENV["GTM_CONTAINER_ID"] %>"',
+            '  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>',
+            "ERB",
+            "",
+            'inject_into_file "app/views/layouts/application.html.erb", after: "<head>\\n" do',
+            '  "    <%= render \\"layouts/gtm_head\\" %>\\n"',
+            "end",
+            "",
+            'inject_into_file "app/views/layouts/application.html.erb", after: "<body>\\n" do',
+            '  "    <%= render \\"layouts/gtm_body\\" %>\\n"',
+            "end"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "GTM: Add your container ID with `bin/rails credentials:edit`:",
+            "  gtm:",
+            "    container_id: GTM-XXXXXXX",
+            "GTM: Manage all your analytics/marketing tags from the GTM dashboard"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class GraphqlPack < FeaturePack
+        pack_name "graphql"
+        description "GraphQL API with graphql-ruby"
+        category "api"
+
+        def gems
+          [
+            {name: "graphql", version: "~> 2.0"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "generate graphql:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "GraphQL: Endpoint available at /graphql",
+            "GraphQL: Generate types with `bin/rails g graphql:object User`",
+            "GraphQL: GraphiQL IDE available in development at /graphiql"
+          ]
+        end
+      end
+    end
+  end
+end