[#1949] Added Starter prompt and updated other prompts descriptions.

.vortex/installer/composer.json

@@ -23,7 +23,7 @@
         "composer/composer": "^2.8",
         "cweagans/composer-patches": "^1.7",
         "czproject/git-php": "^4.3",
-        "laravel/prompts": "^0.3.5",
+        "laravel/prompts": "dev-feature/add-description",
         "nikic/iter": "^2.4",
         "sebastian/diff": "*",
         "symfony/console": "^7.3",
@@ -43,6 +43,12 @@
         "rector/rector": "^2",
         "symfony/finder": "^7.2"
     },
+    "repositories": [
+        {
+            "type": "vcs",
+            "url": "https://github.com/AlexSkrypnyk/prompts.git"
+        }
+    ],
     "autoload": {
         "psr-4": {
             "DrevOps\\VortexInstaller\\": "src/"

.vortex/installer/rector.php

@@ -14,6 +14,7 @@
 
 use Rector\CodeQuality\Rector\ClassMethod\InlineArrayReturnAssignRector;
 use Rector\CodeQuality\Rector\Empty_\SimplifyEmptyCheckOnEmptyArrayRector;
+use Rector\CodeQuality\Rector\FunctionLike\SimplifyUselessVariableRector;
 use Rector\CodingStyle\Rector\ClassMethod\NewlineBeforeNewAssignSetRector;
 use Rector\CodingStyle\Rector\FuncCall\CountArrayToEmptyArrayComparisonRector;
 use Rector\CodingStyle\Rector\Stmt\NewlineAfterStatementRector;
@@ -57,6 +58,7 @@
     NewlineBeforeNewAssignSetRector::class,
     RemoveAlwaysTrueIfConditionRector::class,
     SimplifyEmptyCheckOnEmptyArrayRector::class,
+    SimplifyUselessVariableRector::class,
     // Dependencies.
     '*/vendor/*',
     '*/node_modules/*',

.vortex/installer/src/Command/InstallCommand.php

@@ -9,6 +9,7 @@
 use DrevOps\VortexInstaller\Utils\Downloader;
 use DrevOps\VortexInstaller\Utils\Env;
 use DrevOps\VortexInstaller\Utils\File;
+use DrevOps\VortexInstaller\Utils\Strings;
 use DrevOps\VortexInstaller\Utils\Tui;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputArgument;
@@ -51,6 +52,11 @@ class InstallCommand extends Command {
    */
   protected Config $config;
 
+  /**
+   * The prompt manager.
+   */
+  protected PromptManager $promptManager;
+
   /**
    * {@inheritdoc}
    */
@@ -101,15 +107,15 @@ protected function execute(InputInterface $input, OutputInterface $output): int
       $this->resolveOptions($input->getArguments(), $input->getOptions());
 
       Tui::init($output, !$this->config->getNoInteraction());
-      $pm = new PromptManager($this->config);
+      $this->promptManager = new PromptManager($this->config);
 
       static::header();
 
-      $pm->runPrompts();
+      $this->promptManager->runPrompts();
 
-      Tui::list($pm->getResponsesSummary(), 'Installation summary');
+      Tui::list($this->promptManager->getResponsesSummary(), 'Installation summary');
 
-      if (!$pm->shouldProceed()) {
+      if (!$this->promptManager->shouldProceed()) {
         Tui::info('Aborting project installation. No files were changed.');
 
         return Command::SUCCESS;
@@ -132,7 +138,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
       Tui::action(
         label: '⚙️ Customizing Vortex for your project',
-        action: fn() => $pm->runProcessors(),
+        action: fn() => $this->promptManager->runProcessors(),
         success: 'Vortex was customized for your project',
       );
 
@@ -153,9 +159,6 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         action: fn(): string|array => $this->handleDemo(),
         success: 'Demo content prepared',
       );
-
-      // @todo Implement the demo mode.
-      // $this->handleDemo();
     }
     catch (\Exception $exception) {
       Tui::output()->setVerbosity(OutputInterface::VERBOSITY_NORMAL);
@@ -452,36 +455,29 @@ protected function header(): void {
 
   public function footer(): void {
     $output = '';
+    $prefix = '  ';
+
     if ($this->config->isVortexProject()) {
       $title = 'Finished updating Vortex 🚀🚀🚀';
       $output .= 'Please review the changes and commit the required files.';
     }
     else {
       $title = 'Finished installing Vortex 🚀🚀🚀';
       $output .= 'Next steps:' . PHP_EOL;
-      $output .= PHP_EOL;
-      $output .= '  Add and commit all files:' . PHP_EOL;
-      $output .= '    cd ' . $this->config->getDst() . PHP_EOL;
-      $output .= '    git add -A' . PHP_EOL;
-      $output .= '    git commit -m "Initial commit."' . PHP_EOL;
-      $output .= PHP_EOL;
 
       // Check for required tools and provide conditional instructions.
       $missing_tools = $this->checkRequiredTools();
       if (!empty($missing_tools)) {
-        $output .= '  Install required tools:' . PHP_EOL;
+        $tools_output = 'Install required tools:' . PHP_EOL;
         foreach ($missing_tools as $tool => $instructions) {
-          $output .= sprintf('    %s: %s', $tool, $instructions) . PHP_EOL;
+          $tools_output .= sprintf('  %s: %s', $tool, $instructions) . PHP_EOL;
         }
-        $output .= PHP_EOL;
+        $tools_output .= PHP_EOL;
+        $output .= Strings::wrapLines($tools_output, $prefix);
       }
 
-      $output .= '  Build project locally:' . PHP_EOL;
-      $output .= '    ahoy build' . PHP_EOL;
-      $output .= PHP_EOL;
-      $output .= '  Setup integration with your CI/CD system and hosting:' . PHP_EOL;
-      $output .= '    See https://www.vortextemplate.com/docs/quickstart';
-      $output .= PHP_EOL;
+      // Allow post-install handlers to add their messages.
+      $output .= Strings::wrapLines($this->promptManager->runPostInstall(), $prefix);
     }
 
     Tui::box($output, $title);

.vortex/installer/src/Prompts/Handlers/AbstractHandler.php

@@ -163,6 +163,13 @@ public function setWebroot(string $webroot): static {
     return $this;
   }
 
+  /**
+   * {@inheritdoc}
+   */
+  public function postInstall(): ?string {
+    return NULL;
+  }
+
   /**
    * Check that Vortex is installed for this project.
    *

.vortex/installer/src/Prompts/Handlers/AiCodeInstructions.php

@@ -21,7 +21,7 @@ public function label(): string {
    * {@inheritdoc}
    */
   public function hint(array $responses): ?string {
-    return 'Helps AI coding assistants to understand the project better.';
+    return 'Provides AI coding assistants with better context about the project.';
   }
 
   /**

.vortex/installer/src/Prompts/Handlers/CiProvider.php

@@ -25,17 +25,17 @@ public function label(): string {
    * {@inheritdoc}
    */
   public function hint(array $responses): ?string {
-    return 'Both providers support equivalent workflow.';
+    return 'Use ⬆ and ⬇ to select the CI provider.';
   }
 
   /**
    * {@inheritdoc}
    */
   public function options(array $responses): ?array {
     $options = [
-      self::NONE => 'None',
       self::GITHUB_ACTIONS => 'GitHub Actions',
       self::CIRCLECI => 'CircleCI',
+      self::NONE => 'None',
     ];
 
     if (isset($responses[CodeProvider::id()]) && $responses[CodeProvider::id()] !== CodeProvider::GITHUB) {

.vortex/installer/src/Prompts/Handlers/CodeProvider.php

@@ -22,10 +22,17 @@ public function label(): string {
   /**
    * {@inheritdoc}
    */
-  public function hint(array $responses): ?string {
+  public static function description(array $responses): string {
     return 'Vortex offers full automation with GitHub, while support for other providers is limited.';
   }
 
+  /**
+   * {@inheritdoc}
+   */
+  public function hint(array $responses): ?string {
+    return 'Use ⬆ and ⬇ to select your code repository provider.';
+  }
+
   /**
    * {@inheritdoc}
    */

.vortex/installer/src/Prompts/Handlers/DatabaseDownloadSource.php

@@ -32,7 +32,7 @@ public function label(): string {
    * {@inheritdoc}
    */
   public function hint(array $responses): ?string {
-    return 'The database can be downloaded as an exported dump file or pre-packaged in a container image.';
+    return 'Use ⬆ and ⬇ to select the database download source.';
   }
 
   /**
@@ -45,7 +45,7 @@ public function options(array $responses): ?array {
       self::ACQUIA => '💧 Acquia backup',
       self::LAGOON => '🌊 Lagoon environment',
       self::CONTAINER_REGISTRY => '🐳 Container registry',
-      self::NONE => '🙅 None',
+      self::NONE => '🚫 None',
     ];
 
     if (isset($responses[HostingProvider::id()])) {

.vortex/installer/src/Prompts/Handlers/DependencyUpdatesProvider.php

@@ -25,16 +25,16 @@ public function label(): string {
    * {@inheritdoc}
    */
   public function hint(array $responses): ?string {
-    return 'Use a self-hosted service if you cannot install a GitHub app.';
+    return 'Use ⬆ and ⬇ to select the dependency updates provider.';
   }
 
   /**
    * {@inheritdoc}
    */
   public function options(array $responses): ?array {
     return [
-      self::RENOVATEBOT_CI => '🤖 +  🔄 Renovate self-hosted in CI',
       self::RENOVATEBOT_APP => '🤖 Renovate GitHub app',
+      self::RENOVATEBOT_CI => '🤖 +  🔄 Renovate self-hosted in CI',
       self::NONE => '🚫 None',
     ];
   }
@@ -43,7 +43,7 @@ public function options(array $responses): ?array {
    * {@inheritdoc}
    */
   public function default(array $responses): null|string|bool|array {
-    return self::RENOVATEBOT_CI;
+    return self::RENOVATEBOT_APP;
   }
 
   /**

.vortex/installer/src/Prompts/Handlers/DeployType.php

@@ -29,7 +29,7 @@ public function label(): string {
    * {@inheritdoc}
    */
   public function hint(array $responses): ?string {
-    return 'You can deploy code using one or more methods.';
+    return 'Use ⬆, ⬇ and Space bar to select one or more deployment types.';
   }
 
   /**

.vortex/installer/src/Prompts/Handlers/HandlerInterface.php

@@ -126,7 +126,7 @@ public function transform(): ?callable;
    *
    * If this returns a non-empty value, the caller should use this value
    * instead of prompting the user for input. This allows handlers to
-   * encapsulate logic for when values are discovered from environment,
+   * encapsulate logic for when values are discovered from the environment,
    * auto-selected based on other responses, or otherwise pre-determined.
    *
    * @param array $responses
@@ -177,4 +177,9 @@ public function setWebroot(string $webroot): static;
    */
   public function process(): void;
 
+  /**
+   * Actions to perform and messages to print after installation is complete.
+   */
+  public function postInstall(): ?string;
+
 }

.vortex/installer/src/Prompts/Handlers/HostingProvider.php

@@ -29,7 +29,7 @@ public function label(): string {
    * {@inheritdoc}
    */
   public function hint(array $responses): ?string {
-    return 'Select the hosting provider where the project is hosted. The web root directory will be set accordingly.';
+    return 'Use ⬆, ⬇ and Space bar to select your hosting provider.';
   }
 
   /**