shopify-cli 2.10.0 → 2.11.1

data/lib/project_types/script/messages/messages.rb

@@ -5,88 +5,91 @@ module Script
     MESSAGES = {
       script: {
         help: <<~HELP,
-          Suite of commands for developing script applications. See {{command:%1$s script <command> --help}} for usage of each command.
+          Suite of commands for developing script applications. Run {{command:%1$s script <command> --help}} for usage of each command.
             Usage: {{command:%1$s script [ %2$s ]}}
         HELP
 
         error: {
-          deprecated_ep: "This project uses a Script API (%s) that has been deprecated. "\
-                         "This Script won't work in production.",
-          deprecated_ep_cause: "Try using a different Script API.",
+          deprecated_ep: "This script won't run in a store because "\
+                         "it uses a deprecated Script API (%s).",
+          deprecated_ep_cause: "Recreate this script using a supported Script API.",
           generic: "{{red:{{x}} Error}}",
           eacces_cause: "You don't have permission to write to this directory.",
-          eacces_help: "Try again and choose a different directory.",
+          eacces_help: "Get permission for this directory or choose a different one.",
 
           enospc_cause: "You don't have enough disk space to do this action.",
-          enospc_help: "Free up some space and try again.",
+          enospc_help: "Free up more space.",
 
           oauth_cause: "Something went wrong while authenticating your account with the Partner Dashboard.",
-          oauth_help: "Try again.",
+          oauth_help: "Wait a few minutes and try again.",
 
-          invalid_context_cause: "Your .shopify-cli.yml file is not correct. Values are missing for "\
+          invalid_context_cause: "Your .shopify-cli.yml is formatted incorrectly. It's missing values for "\
                                  "extension_point_type or script_name.",
-          invalid_context_help: "Add these values and try again.",
+          invalid_context_help: "Add these values.",
 
-          invalid_script_name_cause: "Invalid script name.",
-          invalid_script_name_help: "Replace or remove unsupported characters. Valid characters "\
-                                    "are numbers, letters, hyphens, or underscores.",
+          invalid_script_name_cause: "Script name contains unsupported characters.",
+          invalid_script_name_help: "Use only numbers, letters, hyphens, or underscores.",
 
-          no_existing_apps_cause: "You don't have any apps in your Partner Dashboard.",
-          no_existing_apps_help: "Create an app with {{command:shopify [node|rails] create}}" \
-                                 " or visit https://partners.shopify.com/.",
+          no_existing_apps_cause: "Your script can't be pushed to an app because your Partner account "\
+                                  "doesn't have any apps.",
+          no_existing_apps_help: "Create an app.",
 
-          no_existing_orgs_cause: "You don't have any partner organizations.",
-          no_existing_orgs_help: "Visit https://partners.shopify.com/ to create a partners account.",
+          no_existing_orgs_cause: "Your account doesn't belong to a Partner Organization.",
+          no_existing_orgs_help: "Visit https://partners.shopify.com/ to create an account.",
 
           project_exists_cause: "A directory with this same name already exists.",
-          project_exists_help: "Try again and enter a different name for the script.",
+          project_exists_help: "Choose a different name for your script.",
 
-          invalid_extension_cause: "Invalid Script API %s.",
-          invalid_extension_help: "Allowed values: %s.",
+          invalid_extension_cause: "The name of the Script API is incorrect: %s.",
+          invalid_extension_help: "Choose a supported API: %s.",
 
-          invalid_language_cause: "Invalid language %s.",
-          invalid_language_help: "Allowed values: %s.",
+          invalid_language_cause: "The language is not supported: %s.",
+          invalid_language_help: "Choose a supported language: %s.",
 
           missing_script_config_field_cause: "The %{filename} file is missing the required %{field} field.",
-          missing_script_config_field_help: "Add the field and try again.",
+          missing_script_config_field_help: "Add the field.",
 
-          script_config_parse_error_cause: "The %{filename} file contains invalid %{serialization_format}.",
-          script_config_parse_error_help: "Fix the errors and try again.",
+          script_config_parse_error_cause: "The %{filename} file contains incorrect %{serialization_format}.",
+          script_config_parse_error_help: "Correct the errors.",
 
           no_script_config_file_cause: "The %{filename} file is missing.",
-          no_script_config_file_help: "Create this file and try again.",
+          no_script_config_file_help: "Create this file.",
 
-          app_not_connected_cause: "Script is not connected to an app.",
-          app_not_connected_help: "Run shopify connect or enter fields for api-key and api-secret.",
+          app_not_connected_cause: "The script is not connected to an app.",
+          app_not_connected_help: "Run {{command:%{tool_name} script connect}}.",
 
-          configuration_definition_error_cause: "In the %{filename} file, there was a problem with the "\
+          configuration_definition_error_cause: "In %{filename} there is a problem with the "\
                                                 "configuration. %{message}",
-          configuration_definition_error_help: "Fix the error and try again.",
+          configuration_definition_error_help: "Fix the error.",
 
-          configuration_syntax_error_cause: "The %{filename} is not formatted properly.",
-          configuration_syntax_error_help: "Fix the errors and try again.",
+          configuration_definition_errors_cause: "In %{filename}, there are %{error_count} problems with "\
+                                                 "the configuration:\n%{concatenated_messages}\n",
+          configuration_definition_errors_help: "Correct the errors.",
 
-          configuration_missing_keys_error_cause: "The %{filename} file is missing required keys: "\
+          configuration_syntax_error_cause: "The %{filename} is not formatted correctly.",
+          configuration_syntax_error_help: "Fix the errors.",
+
+          configuration_missing_keys_error_cause: "The %{filename} is missing required keys: "\
                                               "%{missing_keys}.",
-          configuration_missing_keys_error_help: "Add the keys and try again.",
+          configuration_missing_keys_error_help: "Add the keys.",
 
-          configuration_invalid_value_error_cause: "The %{filename} configuration only accepts "\
+          configuration_invalid_value_error_cause: "The %{filename} configuration accepts "\
                                                    "one of the following types(s): %{valid_input_modes}.",
-          configuration_invalid_value_error_help: "Change the type and try again.",
+          configuration_invalid_value_error_help: "Change the value of the type.",
 
           configuration_schema_field_missing_keys_error_cause: "A configuration entry in the %{filename} file "\
                                                      "is missing required keys: %{missing_keys}.",
-          configuration_definition_schema_field_missing_keys_error_help: "Add the keys and try again.",
+          configuration_definition_schema_field_missing_keys_error_help: "Add the keys.",
 
           configuration_schema_field_invalid_value_error_cause: "The configuration entries in the "\
-                                                     "%{filename} file only accept one of the following "\
+                                                     "%{filename} file accept one of the following "\
                                                      "type(s): %{valid_types}.",
-          configuration_schema_field_invalid_value_error_help: "Change the types and try again.",
+          configuration_schema_field_invalid_value_error_help: "Change the value of the type.",
 
-          script_not_found_cause: "Couldn't find a script %s for the Script API %s",
+          script_not_found_cause: "Can't find script %s for Script API %s",
 
-          system_call_failure_cause: "An error was returned while running {{command:%{cmd}}}.",
-          system_call_failure_help: "Review the following error and try again.\n{{red:%{out}}}",
+          system_call_failure_cause: "Something went wrong while running: {{command:%{cmd}}}.",
+          system_call_failure_help: "Correct the error.\n{{red:%{out}}}",
 
           metadata_validation_cause: "The Script API metadata is incorrect.",
           metadata_validation_help: "The 'schemaVersions.major' field contains an unsupported version.",
@@ -100,57 +103,58 @@ module Script
           metadata_schema_versions_missing_minor: "Invalid Script API metadata:" \
                                                   " 'schemaVersions' is missing the 'minor' field",
 
-          metadata_not_found_cause: "Script version file (%s) cannot be found.",
-          metadata_not_found_help: "Ensure the 'shopify/scripts-toolchain-as' package is up to date and " \
-                                     "'package.json' contains a 'scripts/build' entry with a " \
-                                     "'--metadata build/metadata.json' argument",
+          metadata_not_found_cause: "Can't find the script version file (%{filename}).",
+          metadata_not_found_help: "Make sure your project is up-to-date and a script metadata file " \
+                                   "is accessible at %{filename}.",
 
           build_error_cause: "Something went wrong while building the script.",
-          build_error_help: "Correct the errors and try again.",
+          build_error_help: "Correct the errors.",
 
           dependency_install_cause: "Something went wrong while installing the needed dependencies.",
-          dependency_install_help: "Correct the errors and try again.",
+          dependency_install_help: "Correct the errors.",
 
           failed_api_request_cause: "Something went wrong while communicating with Shopify.",
           failed_api_request_help: "Try again.",
 
-          forbidden_error_cause: "You do not have permission to do this action.",
+          forbidden_error_cause: "You don't have permission to do this action.",
 
           graphql_error_cause: "An error was returned: %s.",
-          graphql_error_help: "\nReview the error and try again.",
+          graphql_error_help: "\nCorrect the error.",
 
-          script_repush_cause: "A version of this script already exists on the app.",
+          script_repush_cause: "Can’t push the script because a version of this script already exists on the app.",
           script_repush_help: "Use {{cyan:--force}} to replace the existing script.",
 
           build_script_not_found: "The root package.json is missing the build command that " \
-                                  "is needed to compile your script to WebAssembly.",
+                                  "is needed to compile your script to Wasm.",
           # rubocop:disable Layout/LineLength
           build_script_suggestion: "\n\nFor example, your package.json needs the following command:" \
             "\nbuild: npx shopify-scripts-toolchain-as build --src src/shopify_main.ts --binary build/<script_name>.wasm --metadata build/metadata.json -- --lib node_modules --optimize --use Date=",
 
-          web_assembly_binary_not_found: "WebAssembly binary not found.",
-          web_assembly_binary_not_found_suggestion: "No WebAssembly binary found." \
-            "Check that your build npm script outputs the generated binary to the root of the directory." \
-            "Generated binary should match the script name: <script_name>.wasm",
+          web_assembly_binary_not_found: "Wasm binary not found.",
+          web_assembly_binary_not_found_suggestion: "Check that there is a valid Wasm binary in the root directory" \
+          "Your Wasm binary should match the script name: <script_name>.wasm",
 
           project_config_not_found: "Internal error - Script can't be created because the project's config file is missing from the repository.",
 
           invalid_project_config: "Internal error - Script can't be created because the project's config file is invalid in the repository.",
 
-          script_upload_cause: "Fail to upload script.",
+          script_upload_cause: "Something went wrong and your script couldn't be pushed.",
           script_upload_help: "Try again.",
 
+          script_too_large_cause: "The size of your Wasm binary file is too large.",
+          script_too_large_help: "It must be less than %{max_size}.",
+
           api_library_not_found_cause: "Script can't be created because API library %{library_name} is missing from the dependencies",
-          api_library_not_found_help: "This error can occur because the API library was removed from your system or there is a problem with dependencies in the repository.",
+          api_library_not_found_help: "This can occur because the API library was removed from your system or there is a problem with dependencies in the repository.",
 
           language_library_for_api_not_found_cause: "Script can’t be pushed because the %{language} library for API %{api} is missing.",
           language_library_for_api_not_found_help: "Make sure extension_point.yml contains the correct API library.",
           no_scripts_found_in_app: "The selected apps have no scripts. Please, create them first on the partners' dashboard.",
-          missing_env_file_variables: "The following variables are missing in the .env file: %s."\
-            " It might happen when the script hasn't been previously connected to an app."\
-            " To connect the script to an app, run {{command:%s script connect}}",
-          missing_push_options: "The following options are required: %s."\
-            " You can obtain them from the .env file generated after connecting the script to an app.",
+          missing_env_file_variables: "The following are missing in the .env file: %s."\
+            " To add it, run {{command:%s script connect}}",
+          missing_push_options: "The following are missing: %s. "\
+            "To add them to a CI environment:\n\t1. Run a connect command {{command:%s script connect}}\n\t2. Navigate to the .env file at the root of your project\n\t"\
+            "3. Copy the missing values, then pass them through as arguments.",
         },
 
         create: {
@@ -158,26 +162,29 @@ module Script
             {{command:%1$s script create}}: Creates a script project.
               Usage: {{command:%1$s script create}}
               Options:
-                {{command:--name=NAME}} Script project name. Use any string.
-                {{command:--api=TYPE}} Script API name. Allowed values: %2$s.
-                {{command:--language=LANGUAGE}} Programming language. Allowed values: %3$s.
+                {{command:--name=NAME}} Script project name.
+                {{command:--api=TYPE}} Script API name. Supported values: %2$s.
+                {{command:--language=LANGUAGE}} Programming language. Supported values: %3$s.
           HELP
 
           error: {
-            operation_failed: "Script not created.",
+            operation_failed: "Something went wrong and the script wasn't created.",
           },
 
-          change_directory_notice: "{{*}} Change directories to {{green:%s}} to run script commands",
-          creating: "Creating script",
-          created: "Created script",
+          change_directory_notice: "{{*}} Change directories to {{green:%s}} to run script commands.",
+          creating: "Creating script.",
+          created: "Created script.",
+          preparing_project: "Preparing script project structure.",
+          creating_wasm: "Creating configuration files.",
+          created_wasm: "Configuration files created.",
         },
 
         push: {
           help: <<~HELP,
-            Build the script, upload it to Shopify, and register it to an app.  If you've already pushed the script to this app, then use --force to replace the existing version on the app.
+            Build the script, upload it to Shopify, and register it to an app.
               Usage: {{command:%s script push}}
               Options:
-                {{command:[--force]}} Replaces the existing script on the app with this version.
+                {{command:[--force]}} Replace the existing script with this version.
                 {{command:[--api-key=API_KEY]}} The API key used to register an app with the script. This can be found on the app page on Partners Dashboard. Overrides the value in the .env file, if present.
                 {{command:[--api-secret=API_SECRET]}} The API secret of the app the script is registered with. Overrides the value in the .env file, if present.
                 {{command:[--uuid=UUID]}} The uuid of the script. Overrides the value in the .env file, if present.
@@ -200,34 +207,34 @@ module Script
           error: {
             operation_failed: "Couldn't connect script to app.",
             missing_env_file_variables: "The following variables are missing in the .env file: %s."\
-            " To connect the script to an app, either enter the value into the .env file or delete the .env file, then run {{command:%s script connect}}",
+            " To connect the script to an app, enter the value into the .env file or delete the .env file, and then run {{command:%s script connect}}",
           },
         },
         javy: {
           help: <<~HELP,
-            Compile the JavaScript code into WebAssembly.
+            Compile the JavaScript code into Wasm.
               Usage: {{command:%s script javy}}
               Options:
                 {{command:--in}} The name of the JavaScript file that will be compiled.
-                {{command:--out}} The name of the file that the WebAssembly should be written to.
+                {{command:--out}} The name of the file that the Wasm should be written to.
           HELP
           errors: {
-            invalid_arguments: "Javy was run with invalid arguments. Run {{command: %s script javy --help}} for more information.",
+            invalid_arguments: "Javy was run with invalid arguments. Run {{command: %s script javy --help}}.",
           },
         },
 
         project_deps: {
-          none_required: "{{v}} None required",
-          checking_with_npm: "Checking dependencies with npm",
-          installing: "Dependencies installing",
-          installed: "Missing dependencies installed",
+          none_required: "{{v}} Dependencies are up to date.",
+          checking: "Checking dependencies.",
+          installing: "Installing dependencies.",
+          installed: "Installed missing dependencies.",
         },
 
         forms: {
           create: {
             select_extension_point: "Which Script API do you want to use?",
             select_language: "Which language do you want to use?",
-            script_name: "Script name",
+            script_name: "What do you want to name your script?",
           },
         },
 
@@ -236,14 +243,15 @@ module Script
           building_script: "Building script",
           built: "Built",
           pushing: "Pushing",
+          pushing_script: "Pushing script",
           pushed: "Pushed",
           ensure_env: {
             organization: "Partner organization {{green:%s (%s)}}.",
             organization_select: "Which partner organization do you want to use?",
-            app: "Script will be pushed to app {{green:%s}}.",
+            app: "Push script to app {{green:%s}}.",
             app_select: "Which app do you want to push this script to?",
-            ask_connect_to_existing_script: "The selected app has some scripts. Do you want to replace any of the "\
-              "existing scripts on the app with this script?",
+            ask_connect_to_existing_script: "This app contains scripts. Do you want to replace an "\
+              "existing script on the app with this script?",
             ask_which_script_to_connect_to: "Which script do you want to replace?",
           },
         },

data/lib/project_types/script/ui/error_handler.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "cli/ui"
 
 module Script
@@ -5,9 +7,9 @@ module Script
     module ErrorHandler
       def self.display(failed_op:, cause_of_error:, help_suggestion:)
         $stderr.puts(CLI::UI.fmt(ShopifyCLI::Context.message("script.error.generic")))
-        full_msg = failed_op ? failed_op.dup : ""
-        full_msg << " #{cause_of_error}" if cause_of_error
-        full_msg << " #{help_suggestion}" if help_suggestion
+        full_msg = failed_op ? failed_op.dup : String.new
+        append_msg(full_msg, cause_of_error) if cause_of_error
+        append_msg(full_msg, help_suggestion) if help_suggestion
         $stderr.puts(CLI::UI.fmt(full_msg.strip))
       end
 
@@ -22,6 +24,11 @@ module Script
         display_and_raise(failed_op: failed_op, **messages)
       end
 
+      private_class_method def self.append_msg(full_msg, msg_to_append)
+        full_msg << " " unless /\s$/.match?(full_msg)
+        full_msg << msg_to_append
+      end
+
       def self.error_messages(e)
         case e
         when Errno::EACCES
@@ -100,8 +107,8 @@ module Script
           }
         when Layers::Domain::Errors::MetadataNotFoundError
           {
-            cause_of_error: ShopifyCLI::Context.message("script.error.metadata_not_found_cause"),
-            help_suggestion: ShopifyCLI::Context.message("script.error.metadata_not_found_help"),
+            cause_of_error: ShopifyCLI::Context.message("script.error.metadata_not_found_cause", filename: e.filename),
+            help_suggestion: ShopifyCLI::Context.message("script.error.metadata_not_found_help", filename: e.filename),
           }
         when Layers::Domain::Errors::MissingScriptConfigFieldError
           {
@@ -135,14 +142,26 @@ module Script
             help_suggestion: ShopifyCLI::Context.message("script.error.no_script_config_file_help"),
           }
         when Layers::Infrastructure::Errors::ScriptConfigurationDefinitionError
-          {
-            cause_of_error: ShopifyCLI::Context.message(
-              "script.error.configuration_definition_error_cause",
-              message: e.message,
-              filename: e.filename,
-            ),
-            help_suggestion: ShopifyCLI::Context.message("script.error.configuration_definition_error_help"),
-          }
+          if e.messages.count == 1
+            {
+              cause_of_error: ShopifyCLI::Context.message(
+                "script.error.configuration_definition_error_cause",
+                message: e.messages.fetch(0),
+                filename: e.filename,
+              ),
+              help_suggestion: ShopifyCLI::Context.message("script.error.configuration_definition_error_help"),
+            }
+          else
+            {
+              cause_of_error: ShopifyCLI::Context.message(
+                "script.error.configuration_definition_errors_cause",
+                concatenated_messages: e.messages.map { |m| "{{x}} #{m}" }.join("\n"),
+                filename: e.filename,
+                error_count: e.messages.count,
+              ),
+              help_suggestion: ShopifyCLI::Context.message("script.error.configuration_definition_errors_help"),
+            }
+          end
         when Layers::Infrastructure::Errors::ScriptConfigSyntaxError
           {
             cause_of_error: ShopifyCLI::Context.message(
@@ -154,7 +173,8 @@ module Script
         when Layers::Infrastructure::Errors::ScriptEnvAppNotConnectedError
           {
             cause_of_error: ShopifyCLI::Context.message("script.error.app_not_connected_cause"),
-            help_suggestion: ShopifyCLI::Context.message("script.error.app_not_connected_help"),
+            help_suggestion: ShopifyCLI::Context.message("script.error.app_not_connected_help",
+              tool_name: ShopifyCLI::TOOL_NAME),
           }
         when Layers::Infrastructure::Errors::ScriptConfigMissingKeysError
           {
@@ -251,6 +271,11 @@ module Script
             cause_of_error: ShopifyCLI::Context.message("script.error.script_upload_cause"),
             help_suggestion: ShopifyCLI::Context.message("script.error.script_upload_help"),
           }
+        when Layers::Infrastructure::Errors::ScriptTooLargeError
+          {
+            cause_of_error: ShopifyCLI::Context.message("script.error.script_too_large_cause"),
+            help_suggestion: ShopifyCLI::Context.message("script.error.script_too_large_help", max_size: e.max_size),
+          }
         when Layers::Infrastructure::Errors::APILibraryNotFoundError
           {
             cause_of_error: ShopifyCLI::Context

data/lib/project_types/theme/commands/check.rb

@@ -4,6 +4,8 @@ require "theme_check"
 module Theme
   class Command
     class Check < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       class Options < ShopifyCLI::Options
         def initialize(theme_check)
           super()

data/lib/project_types/theme/commands/delete.rb

@@ -5,6 +5,8 @@ require "shopify_cli/theme/development_theme"
 module Theme
   class Command
     class Delete < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-d", "--development") { flags[:development] = true }
         parser.on("-a", "--show-all") { flags[:show_all] = true }

data/lib/project_types/theme/commands/init.rb

@@ -3,6 +3,8 @@
 module Theme
   class Command
     class Init < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-u", "--clone-url URL") { |url| flags[:clone_url] = url }
       end

data/lib/project_types/theme/commands/language_server.rb

@@ -4,6 +4,8 @@ require "theme_check"
 module Theme
   class Command
     class LanguageServer < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       def call(*)
         ThemeCheck::LanguageServer.start
       end

data/lib/project_types/theme/commands/package.rb

@@ -5,6 +5,8 @@ require "json"
 module Theme
   class Command
     class Package < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       THEME_DIRECTORIES = %w[
         assets
         config

data/lib/project_types/theme/commands/publish.rb

@@ -4,6 +4,8 @@ require "shopify_cli/theme/theme"
 module Theme
   class Command
     class Publish < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-f", "--force") { flags[:force] = true }
       end

data/lib/project_types/theme/commands/pull.rb

@@ -7,13 +7,18 @@ require "shopify_cli/theme/syncer"
 module Theme
   class Command
     class Pull < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-n", "--nodelete") { flags[:nodelete] = true }
         parser.on("-i", "--themeid=ID") { |theme_id| flags[:theme_id] = theme_id }
         parser.on("-t", "--theme=NAME_OR_ID") { |theme| flags[:theme] = theme }
         parser.on("-l", "--live") { flags[:live] = true }
         parser.on("-d", "--development") { flags[:development] = true }
-        parser.on("-o", "--only=PATTERN") { |pattern| flags[:includes] = pattern }
+        parser.on("-o", "--only=PATTERN") do |pattern|
+          flags[:includes] ||= []
+          flags[:includes] << pattern
+        end
         parser.on("-x", "--ignore=PATTERN") do |pattern|
           flags[:ignores] ||= []
           flags[:ignores] << pattern

data/lib/project_types/theme/commands/push.rb

@@ -8,6 +8,8 @@ require "shopify_cli/theme/syncer"
 module Theme
   class Command
     class Push < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-n", "--nodelete") { flags[:nodelete] = true }
         parser.on("-i", "--themeid=ID") { |theme_id| flags[:theme_id] = theme_id }
@@ -18,7 +20,10 @@ module Theme
         parser.on("-j", "--json") { flags[:json] = true }
         parser.on("-a", "--allow-live") { flags[:allow_live] = true }
         parser.on("-p", "--publish") { flags[:publish] = true }
-        parser.on("-o", "--only=PATTERN") { |pattern| flags[:includes] = pattern }
+        parser.on("-o", "--only=PATTERN") do |pattern|
+          flags[:includes] ||= []
+          flags[:includes] << pattern
+        end
         parser.on("-x", "--ignore=PATTERN") do |pattern|
           flags[:ignores] ||= []
           flags[:ignores] << pattern

data/lib/project_types/theme/commands/serve.rb

@@ -4,6 +4,8 @@ require "shopify_cli/theme/dev_server"
 module Theme
   class Command
     class Serve < ShopifyCLI::Command::SubCommand
+      recommend_default_ruby_range
+
       DEFAULT_HTTP_HOST = "127.0.0.1"
 
       options do |parser, flags|

data/lib/shopify_cli/command/sub_command.rb

@@ -9,6 +9,8 @@ module ShopifyCLI
           cmd = new(@ctx)
           args = cmd.options.parse(@_options, args || [])
           return call_help(parent_command, command_name) if cmd.options.help
+          check_ruby_version
+          check_node_version
           run_prerequisites
 
           cmd.call(args, command_name)

data/lib/shopify_cli/command.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 require "shopify_cli"
+require "semantic/semantic"
 
 module ShopifyCLI
   class Command < CLI::Kit::BaseCommand
@@ -7,6 +8,8 @@ module ShopifyCLI
     autoload :AppSubCommand,  "shopify_cli/command/app_sub_command"
     autoload :ProjectCommand, "shopify_cli/command/project_command"
 
+    VersionRange = Struct.new(:from, :to, keyword_init: true)
+
     extend Feature::Set
 
     attr_writer :ctx
@@ -26,6 +29,8 @@ module ShopifyCLI
           cmd = new(@ctx)
           cmd.options.parse(@_options, args)
           return call_help(command_name) if cmd.options.help
+          check_ruby_version
+          check_node_version
           run_prerequisites
           cmd.call(args, command_name)
         end
@@ -58,6 +63,73 @@ module ShopifyCLI
         )
       end
 
+      def recommend_ruby(from:, to:)
+        @compatible_ruby_range = VersionRange.new(
+          from: Semantic::Version.new(from),
+          to: Semantic::Version.new(to)
+        )
+      end
+
+      def recommend_default_ruby_range
+        recommend_ruby(
+          from: Constants::SupportedVersions::Ruby::FROM,
+          to: Constants::SupportedVersions::Ruby::TO
+        )
+      end
+
+      def check_ruby_version
+        check_version(
+          Environment.ruby_version,
+          range: @compatible_ruby_range,
+          runtime: "Ruby"
+        )
+      end
+
+      def recommend_node(from:, to:)
+        @compatible_node_range = VersionRange.new(
+          from: Semantic::Version.new(from),
+          to: Semantic::Version.new(to)
+        )
+      end
+
+      def recommend_default_node_range
+        recommend_node(
+          from: Constants::SupportedVersions::Node::FROM,
+          to: Constants::SupportedVersions::Node::TO
+        )
+      end
+
+      def check_node_version
+        context = Context.new
+        if @compatible_node_range && context.which("node").nil?
+          raise ShopifyCLI::Abort, context.message("core.errors.missing_node")
+        end
+
+        check_version(
+          Environment.node_version,
+          range: @compatible_node_range,
+          runtime: "Node",
+          context: context
+        )
+      end
+
+      def check_version(version, range:, runtime:, context: Context.new)
+        return if Environment.test?
+        return if range.nil?
+
+        version_without_pre_nor_build = Utilities.version_dropping_pre_and_build(version)
+        is_higher_than_bottom = version_without_pre_nor_build >= Utilities.version_dropping_pre_and_build(range.from)
+        is_lower_than_top = version_without_pre_nor_build < Utilities.version_dropping_pre_and_build(range.to)
+        return if is_higher_than_bottom && is_lower_than_top
+
+        context.warn("Your environment #{runtime} version, #{version},"\
+          " is outside of the range supported by the CLI,"\
+          " #{range.from}..<#{range.to},"\
+          " and might cause incompatibility issues.")
+      rescue StandardError => error
+        ExceptionReporter.report_error_silently(error)
+      end
+
       def prerequisite_task(*tasks_without_args, **tasks_with_args)
         @prerequisite_tasks ||= []
         @prerequisite_tasks += tasks_without_args.map { |t| PrerequisiteTask.new(t) }