rails-metro 0.1.0

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

@@ -0,0 +1,41 @@
+module Rails
+  module Metro
+    module Packs
+      class TestMockingPack < FeaturePack
+        pack_name "test_mocking"
+        description "VCR + WebMock for recording and replaying HTTP interactions in tests"
+        category "testing"
+
+        def gems
+          [
+            {name: "vcr", group: :test},
+            {name: "webmock", group: :test}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "test/support/vcr.rb", <<~RUBY',
+            '  require "vcr"',
+            "",
+            "  VCR.configure do |config|",
+            '    config.cassette_library_dir = "test/cassettes"',
+            "    config.hook_into :webmock",
+            "    config.ignore_localhost = true",
+            "    config.default_cassette_options = { record: :once }",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "VCR: Wrap HTTP tests with `VCR.use_cassette(\"name\") { }` to record/replay",
+            "VCR: Cassettes stored in test/cassettes/",
+            "WebMock: All external HTTP is blocked in tests by default -- use VCR or stub explicitly"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+module Rails
+  module Metro
+    module Packs
+      class TestingPack < FeaturePack
+        pack_name "testing"
+        description "FactoryBot + Faker + Capybara for testing"
+        category "testing"
+
+        def gems
+          [
+            {name: "factory_bot_rails", group: :test},
+            {name: "faker", group: :test},
+            {name: "capybara", group: :test},
+            {name: "selenium-webdriver", group: :test}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "test/support/factory_bot.rb", <<~RUBY',
+            "  FactoryBot::SyntaxMethods",
+            "",
+            "  class ActiveSupport::TestCase",
+            "    include FactoryBot::Syntax::Methods",
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Testing: Generate factories with `bin/rails g factory_bot:model User`",
+            "Testing: Use `build(:user)`, `create(:user)` in tests"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+module Rails
+  module Metro
+    module Packs
+      class TwilioPack < FeaturePack
+        pack_name "twilio"
+        description "Twilio for SMS, voice, and WhatsApp messaging"
+        category "notifications"
+
+        def gems
+          [
+            {name: "twilio-ruby"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/twilio.rb", <<~RUBY',
+            "  TWILIO_CLIENT = Twilio::REST::Client.new(",
+            '    Rails.application.credentials.dig(:twilio, :account_sid) || ENV["TWILIO_ACCOUNT_SID"],',
+            '    Rails.application.credentials.dig(:twilio, :auth_token) || ENV["TWILIO_AUTH_TOKEN"]',
+            "  )",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Twilio: Add your credentials with `bin/rails credentials:edit`:",
+            "  twilio:",
+            "    account_sid: your_account_sid",
+            "    auth_token: your_auth_token",
+            "    phone_number: \"+1234567890\""
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+module Rails
+  module Metro
+    module Packs
+      class ViteRailsPack < FeaturePack
+        pack_name "vite_rails"
+        description "Vite Rails for fast frontend bundling with HMR"
+        category "ui"
+
+        def gems
+          [
+            {name: "vite_rails"}
+          ]
+        end
+
+        def template_lines
+          [
+            'run "bundle exec vite install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Vite: Run `bin/vite dev` alongside `bin/rails s` for development",
+            "Vite: Hot Module Replacement (HMR) for instant updates",
+            "Vite: Build for production with `bin/vite build`"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+module Rails
+  module Metro
+    module Packs
+      class WebPushPack < FeaturePack
+        pack_name "web_push"
+        description "Web Push for browser push notifications"
+        category "notifications"
+
+        def gems
+          [
+            {name: "web-push"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "config/initializers/web_push.rb", <<~RUBY',
+            "  WebPush.configure do |config|",
+            '    config.vapid_public_key = Rails.application.credentials.dig(:vapid, :public_key) || ENV["VAPID_PUBLIC_KEY"]',
+            '    config.vapid_private_key = Rails.application.credentials.dig(:vapid, :private_key) || ENV["VAPID_PRIVATE_KEY"]',
+            "  end",
+            "RUBY"
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Web Push: Generate VAPID keys with `WebPush.generate_key`",
+            "Web Push: Add keys with `bin/rails credentials:edit`:",
+            "  vapid:",
+            "    public_key: your_public_key",
+            "    private_key: your_private_key",
+            "Web Push: Register a service worker in your app for push subscriptions"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+module Rails
+  module Metro
+    module Packs
+      class WebhooksPack < FeaturePack
+        pack_name "webhooks"
+        description "Incoming and outgoing webhook handling"
+        category "api"
+
+        def gems
+          [
+            {name: "webhook_system"}
+          ]
+        end
+
+        def template_lines
+          [
+            'create_file "app/controllers/webhooks_controller.rb", <<~RUBY',
+            "  class WebhooksController < ActionController::API",
+            "    skip_before_action :verify_authenticity_token",
+            "",
+            "    def receive",
+            "      payload = JSON.parse(request.body.read)",
+            '      signature = request.headers["X-Webhook-Signature"]',
+            "",
+            "      # Verify and process webhook",
+            '      Rails.logger.info "[Webhook] Received: \#{payload}"',
+            "      head :ok",
+            "    end",
+            "  end",
+            "RUBY",
+            "",
+            'route "post \\"/webhooks/:provider\\", to: \\"webhooks#receive\\""'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "Webhooks: Incoming endpoint at POST /webhooks/:provider",
+            "Webhooks: Add signature verification per provider in WebhooksController"
+          ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module Rails
+  module Metro
+    module Packs
+      class WebsocketsPack < FeaturePack
+        pack_name "websockets"
+        description "Solid Cable (Rails 8 default, database-backed ActionCable)"
+        category "core"
+
+        def gems
+          [
+            {name: "solid_cable"}
+          ]
+        end
+
+        def template_lines
+          [
+            'rails_command "solid_cable:install"'
+          ]
+        end
+
+        def post_install_notes
+          [
+            "WebSockets: Solid Cable is configured as the ActionCable adapter"
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/template_compiler.rb

@@ -0,0 +1,85 @@
+require "tempfile"
+
+module Rails
+  module Metro
+    class TemplateCompiler
+      attr_reader :config, :packs
+
+      def initialize(config:, packs:)
+        @config = config
+        @packs = packs
+      end
+
+      def compile
+        lines = []
+        lines << header
+        lines << ""
+        lines << gem_declarations
+        lines << ""
+        lines << after_bundle_block
+        lines.flatten.join("\n")
+      end
+
+      def compile_to_file
+        content = compile
+        tmpfile = Tempfile.new(["rails-metro-template", ".rb"])
+        tmpfile.write(content)
+        tmpfile.close
+        tmpfile.path
+      end
+
+      def post_install_notes
+        packs.flat_map { |p| p.new.post_install_notes }.compact
+      end
+
+      private
+
+      def header
+        pack_names = packs.map(&:pack_name).join(", ")
+        [
+          "# Generated by rails-metro v#{VERSION}",
+          "# Packs: #{pack_names}",
+          "#",
+          "# Apply with: rails new APP_NAME -m this_template.rb",
+          "# Or: bin/rails app:template LOCATION=this_template.rb"
+        ]
+      end
+
+      def gem_declarations
+        all_gems = packs.flat_map { |p| p.new.gems }.uniq { |g| g[:name] }
+        return [] if all_gems.empty?
+
+        grouped = all_gems.group_by { |g| g[:group] }
+        lines = []
+
+        ungrouped = grouped.delete(nil) || []
+        ungrouped.each do |g|
+          version = g[:version] ? ", \"#{g[:version]}\"" : ""
+          lines << "gem \"#{g[:name]}\"#{version}"
+        end
+
+        grouped.each do |group, gems|
+          lines << ""
+          lines << "gem_group :#{group} do"
+          gems.each do |g|
+            version = g[:version] ? ", \"#{g[:version]}\"" : ""
+            lines << "  gem \"#{g[:name]}\"#{version}"
+          end
+          lines << "end"
+        end
+
+        lines
+      end
+
+      def after_bundle_block
+        template_lines = packs.flat_map { |p| p.new.template_lines }
+        return [] if template_lines.empty?
+
+        lines = ["", "after_bundle do"]
+        template_lines.each { |line| lines << "  #{line}" }
+        lines << "end"
+        lines
+      end
+    end
+  end
+end

data/lib/rails/metro/tui/app.rb

@@ -0,0 +1,119 @@
+module Rails
+  module Metro
+    module Tui
+      class App
+        include Bubbletea::Model
+
+        STEP_ORDER = %i[app_name database packs review].freeze
+
+        attr_reader :step_index, :config, :steps
+
+        def initialize
+          @config = Config.new
+          @registry = FeatureRegistry.default
+          @step_index = 0
+          @steps = {
+            app_name: Steps::AppNameStep.new,
+            database: Steps::DatabaseStep.new,
+            packs: Steps::PackStep.new(registry: @registry),
+            review: nil
+          }
+          @quitting = false
+          @final_action = nil
+        end
+
+        def init
+          nil
+        end
+
+        def update(msg)
+          case msg
+          when Bubbletea::KeyMessage
+            if msg.esc? || (msg.ctrl? && msg.char == "c")
+              @quitting = true
+              return self, Bubbletea::QuitCommand.new
+            end
+          end
+
+          step = current_step
+          step, action = step.update(msg)
+          @steps[current_step_name] = step
+
+          case action
+          when :next
+            advance_step
+          when :back
+            go_back
+          end
+
+          [self, nil]
+        end
+
+        def view
+          return "" if @quitting
+
+          lines = []
+          lines << header
+          lines << ""
+          lines << current_step.view
+          lines.join("\n")
+        end
+
+        def current_step_name
+          STEP_ORDER[@step_index]
+        end
+
+        def current_step
+          @steps[current_step_name]
+        end
+
+        attr_reader :final_action
+
+        private
+
+        def header
+          progress = STEP_ORDER.each_with_index.map { |name, i|
+            label = name.to_s.tr("_", " ").capitalize
+            if i < @step_index
+              Styles.success.render("✓ #{label}")
+            elsif i == @step_index
+              Styles.selected.render("● #{label}")
+            else
+              Styles.dimmed.render("○ #{label}")
+            end
+          }.join("  ")
+          "  #{progress}"
+        end
+
+        def advance_step
+          sync_config
+
+          if @step_index >= STEP_ORDER.length - 1
+            @final_action = @steps[:review]&.action
+            @quitting = true
+            return self, Bubbletea::QuitCommand.new
+          end
+
+          @step_index += 1
+
+          if current_step_name == :review
+            @steps[:review] = Steps::ReviewStep.new(config: @config, registry: @registry)
+          end
+
+          [self, nil]
+        end
+
+        def go_back
+          @step_index = [@step_index - 1, 0].max
+          [self, nil]
+        end
+
+        def sync_config
+          @config.app_name = @steps[:app_name].app_name
+          @config.database = @steps[:database].selected
+          @config.selected_packs = @steps[:packs].selected_packs.to_a.sort
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/tui/steps/app_name_step.rb

@@ -0,0 +1,57 @@
+module Rails
+  module Metro
+    module Tui
+      module Steps
+        class AppNameStep
+          attr_reader :app_name, :error
+
+          def initialize(app_name: "")
+            @app_name = app_name
+            @error = nil
+          end
+
+          def update(msg)
+            case msg
+            when Bubbletea::KeyMessage
+              if msg.enter?
+                if @app_name.strip.empty?
+                  @error = "App name cannot be empty"
+                elsif @app_name.match?(/[^a-zA-Z0-9_-]/)
+                  @error = "App name can only contain letters, numbers, hyphens, and underscores"
+                else
+                  @error = nil
+                  return self, :next
+                end
+              elsif msg.backspace?
+                @app_name = @app_name[0...-1]
+                @error = nil
+              elsif msg.runes?
+                @app_name += msg.to_s
+                @error = nil
+              end
+            end
+            [self, nil]
+          end
+
+          def view
+            lines = []
+            lines << Styles.title.render("  Create a new Rails app")
+            lines << ""
+            lines << "  App name: #{@app_name}█"
+            lines << ""
+            if @error
+              lines << "  #{Styles.error_style.render(@error)}"
+              lines << ""
+            end
+            lines << Styles.help.render("  Enter to continue • Ctrl+C to quit")
+            lines.join("\n")
+          end
+
+          def complete?
+            @app_name.strip.length > 0 && @error.nil?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rails/metro/tui/steps/database_step.rb

@@ -0,0 +1,53 @@
+module Rails
+  module Metro
+    module Tui
+      module Steps
+        class DatabaseStep
+          DATABASES = %w[sqlite3 postgresql mysql2].freeze
+
+          attr_reader :cursor, :selected
+
+          def initialize(selected: "sqlite3")
+            @cursor = DATABASES.index(selected) || 0
+            @selected = selected
+          end
+
+          def update(msg)
+            case msg
+            when Bubbletea::KeyMessage
+              if msg.enter?
+                @selected = DATABASES[@cursor]
+                return self, :next
+              elsif msg.up? || msg.char == "k"
+                @cursor = (@cursor - 1) % DATABASES.length
+              elsif msg.down? || msg.char == "j"
+                @cursor = (@cursor + 1) % DATABASES.length
+              end
+            end
+            [self, nil]
+          end
+
+          def view
+            lines = []
+            lines << Styles.title.render("  Select database")
+            lines << ""
+            DATABASES.each_with_index do |db, i|
+              lines << if i == @cursor
+                Styles.selected.render("  > #{db}")
+              else
+                Styles.dimmed.render("    #{db}")
+              end
+            end
+            lines << ""
+            lines << Styles.help.render("  j/k or arrows to move • Enter to select • Ctrl+C to quit")
+            lines.join("\n")
+          end
+
+          def complete?
+            DATABASES.include?(@selected)
+          end
+        end
+      end
+    end
+  end
+end