railstart 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06f6eda8bd62deeef7ba87448cd471a783f36a31c8a0026a6f4813883dc4ea7e
-  data.tar.gz: d493a6c6f85c095e45f0fbc8f5c380488af1fc57fbdd07802f7fe8481e528f4d
+  metadata.gz: a11ff1fa7939d71ae25db7c053cb82f0d20babc2ea36f80d5b455ef909ac9a5b
+  data.tar.gz: 81dbc554f5bb0f4b77ddf1786d10c5b70018a49e319bbdec40397586338b6f58
 SHA512:
-  metadata.gz: 0a45f5201a19322362da2029b79b5a96439c4c68d0f1201f605bc88008adfc602a28bba0423f3db3a7b43acc5d4ded66a42ad11f3ed281483b417ec31ab32c16
-  data.tar.gz: 95f319acae2e68a8ed747cb98fc20f6194e9d85947c5b63a345bf4b0d95b72c21f3a08a9638347f75ca7a619f278e10ef29ea26d52b620c2d18f7ffc34006c5a
+  metadata.gz: 75b456127f40e5636561bb7fdedf260eafadc8a32a89f4ba8088807735a0746a52cafa6975beef669f869fe47e8ea870cc7a30f471ef525c9d8e492a6d472185
+  data.tar.gz: 1a02ea13c31ed012b01a7ec83ca6388f09407b74d7fa72c4134bd46f860e71435ccd586931e6569e7809cd109c55504112f6d7b747a6ede87561af6d75513106

data/CHANGELOG.md

@@ -6,6 +6,43 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [0.2.0] - 2025-11-22
+
+### Added
+- Three-layer preset system (builtin → user → preset config merging)
+- CLI flags: `--preset NAME` and `--default` for preset selection
+- Preset resolution: user presets (`~/.config/railstart/presets/`) override built-in gem presets
+- Built-in presets: `default.yaml` (PostgreSQL + Tailwind + Importmap) and `api-only.yaml`
+- Config overlay schema with id-based merging for questions and post_actions
+- New `Railstart::UI` module for enhanced CLI presentation
+- ASCII art logo displayed at startup
+- Styled welcome box with dynamic Rails version detection
+- Boxed configuration summary with syntax highlighting
+- Icon-based status messages (success ✓, info ℹ, warning ⚠, error ✗)
+- Section headers with visual separators
+- `tty-box` dependency for frame rendering
+
+### Changed
+- `Config.load` now accepts optional `preset_path` parameter
+- Generator modes respect preset overlays for both interactive and non-interactive flows
+- Generator always confirms before generation, even in `--default` mode
+- Improved TTY::Prompt integration to use hash format for select/multi_select choices
+- Welcome message now displays detected Rails version instead of hardcoded "Rails 8"
+- Summary display redesigned with bordered box and colored output
+- Status messages now use consistent icons and colors throughout
+- Generator runs Rails commands outside bundler context using `Bundler.with_unbundled_env`
+- Bundle install post-action now disabled by default
+
+### Fixed
+- Proper deep merging with id-based array merging for questions and post_actions
+- TTY::Prompt select/multi_select displaying duplicate options (switched from array pairs to hash format)
+- Default value selection not working correctly (now uses 1-based index as expected by TTY::Prompt)
+- Bundle install post-action incorrectly prompting when user explicitly skips bundle install
+- CLI error handling improved (Thor::UndefinedCommandError)
+
+### Removed
+- Plain text summary formatting replaced with styled box display
+
 ## [0.1.0] - 2025-11-21
 
 ### Added

data/README.md

@@ -16,9 +16,13 @@ gem install railstart
 
 ## Usage
 
-### Generate a new Rails app
+### Quick Start
 
 ```bash
+# Generate config files (optional, for customization)
+railstart init
+
+# Generate a new Rails app
 railstart new my_app
 
 # Or run without arguments for help
@@ -79,25 +83,88 @@ Creating Rails app...
 ✨ Rails app created successfully at ./my_app
 ```
 
-### Skip interactive mode (use defaults)
+### Use Presets
+
+Presets are configuration overlays that let you define different defaults and even different questions/post-actions for specific use cases.
+
+**Important:** When you use `--default` without `--preset`, Railstart automatically applies the `default` preset (from `~/.config/railstart/presets/default.yaml` or the gem's built-in version). This means defaults may differ from the base `rails8_defaults.yaml` config.
 
-Use the `--default` flag to skip all questions and apply built-in defaults:
+**Modes:**
+- **Interactive** (default): prompts for each question from the config schema
+- **With --default**: skips questions, loads "default" preset, shows summary and confirms
+- **With --preset**: loads specified preset as config overlay (can be interactive or with --default)
 
 ```bash
+# Interactive mode (builtin defaults)
+railstart new my_app
+
+# Non-interactive with "default" preset (asks no questions, shows summary + confirms)
+# Note: --default automatically loads the "default" preset (user or gem)
 railstart new my_app --default
+
+# Interactive with custom preset
+railstart new my_app --preset api-only
+
+# Non-interactive with custom preset
+railstart new my_app --preset api-only --default
+```
+
+**Create custom presets** at `~/.config/railstart/presets/my-preset.yaml`:
+
+Presets use the same YAML schema as config files - they can override question defaults, change choices, add new questions, or modify post-actions:
+
+```yaml
+# ~/.config/railstart/presets/api-only.yaml
+# Presets merge on top of user config (and built-in config)
+questions:
+  - id: database
+    choices:
+      - name: PostgreSQL
+        value: postgresql
+        default: true  # Different default for this preset
+
+  - id: api_only
+    default: true  # Override default to true for API preset
+
+post_actions:
+  - id: init_git
+    enabled: false  # Disable git init for this preset
 ```
 
-This creates a PostgreSQL + Tailwind + Importmap Rails app instantly.
+Then use it:
+
+```bash
+# Interactive with api-only config
+railstart new my_app --preset api-only
+
+# Non-interactive with api-only config
+railstart new my_app --preset api-only --default
+```
 
 ## Configuration
 
+### Initialize Configuration Files
+
+The easiest way to get started with custom configuration is to generate example files:
+
+```bash
+railstart init
+```
+
+This creates:
+- `~/.config/railstart/config.yaml` - Example user config with common customizations
+- `~/.config/railstart/presets/` - Directory for your presets
+- `~/.config/railstart/presets/example.yaml` - Example preset to get started
+
+You can then edit these files to match your preferences.
+
 ### Built-in Defaults
 
 Railstart ships with sensible Rails 8 defaults defined in `config/rails8_defaults.yaml`. These drive the interactive questions and their defaults.
 
 ### Customize for Your Team
 
-Create a `~/.config/railstart/config.yaml` file to override defaults:
+You can create `~/.config/railstart/config.yaml` manually or use `railstart init` to generate an example file:
 
 ```yaml
 questions:
@@ -204,7 +271,7 @@ bin/console
 
 # Install locally to test as a real gem
 gem build railstart.gemspec
-gem install railstart-0.1.0.gem
+gem install railstart-[version].gem
 railstart new my_app
 ```
 
@@ -226,10 +293,28 @@ bundle exec rake test && bundle exec rubocop
 
 ## Architecture
 
-- **Config System** (`lib/railstart/config.rb`) - Loads and merges YAML configurations
+### Three-Layer Configuration System
+
+Railstart merges configuration from three sources (in order):
+
+1. **Built-in config**: `config/rails8_defaults.yaml` (shipped with gem)
+2. **User config**: `~/.config/railstart/config.yaml` (optional global overrides)
+3. **Preset** (optional): `~/.config/railstart/presets/NAME.yaml` (per-run overlay)
+
+Each layer can:
+- Override question defaults
+- Replace choice lists entirely (by question ID)
+- Add new questions
+- Add/modify post-actions
+- Enable/disable post-actions
+
+Merging is by `id` for both `questions` and `post_actions`, allowing surgical overrides without duplicating entire configs.
+
+### Core Components
+
 - **Generator** (`lib/railstart/generator.rb`) - Orchestrates interactive flow
 - **Command Builder** (`lib/railstart/command_builder.rb`) - Translates answers to `rails new` flags
-- **CLI** (`lib/railstart/cli.rb`) - Thor command interface
+- **CLI** (`lib/railstart/cli.rb`) - Thor command interface with `--preset` option
 
 ## Contributing
 

data/config/presets/api-only.yaml

@@ -0,0 +1,46 @@
+---
+# API-Only Preset - Minimal Rails app for JSON APIs
+
+questions:
+  - id: database
+    choices:
+      - name: PostgreSQL
+        value: postgresql
+        default: true
+
+  - id: css
+    choices:
+      - name: None
+        value: none
+        default: true
+
+  - id: javascript
+    choices:
+      - name: Importmap (default)
+        value: importmap
+        default: true
+
+  - id: skip_features
+    default:
+      - action_mailer
+      - action_text
+      - hotwire
+
+  - id: api_only
+    default: true
+
+  - id: skip_git
+    default: false
+
+  - id: skip_docker
+    default: false
+
+  - id: skip_bundle
+    default: false
+
+post_actions:
+  - id: init_git
+    enabled: true
+
+  - id: bundle_install
+    enabled: true

data/config/presets/default.yaml

@@ -0,0 +1,45 @@
+---
+# Default Preset - Sensible defaults for quick start
+# This preset is automatically loaded when using --default flag without --preset
+# Can be overridden by user preset at ~/.config/railstart/presets/default.yaml
+
+questions:
+  - id: database
+    choices:
+      - name: PostgreSQL
+        value: postgresql
+        default: true
+
+  - id: css
+    choices:
+      - name: Tailwind
+        value: tailwind
+        default: true
+
+  - id: javascript
+    choices:
+      - name: Importmap (default)
+        value: importmap
+        default: true
+
+  - id: skip_features
+    default: []
+
+  - id: api_only
+    default: false
+
+  - id: skip_git
+    default: false
+
+  - id: skip_docker
+    default: false
+
+  - id: skip_bundle
+    default: false
+
+post_actions:
+  - id: init_git
+    enabled: true
+
+  - id: bundle_install
+    enabled: true

data/config/rails8_defaults.yaml

@@ -115,7 +115,7 @@ post_actions:
 
   - id: bundle_install
     name: "Install gems"
-    enabled: true
+    enabled: false
     prompt: "Run bundle install?"
     default: true
     if:

data/lib/railstart/cli.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "thor"
+require "fileutils"
 require_relative "generator"
 
 module Railstart
@@ -11,22 +12,206 @@ module Railstart
   # @example Print version
   #   Railstart::CLI.start(%w[version])
   class CLI < Thor
-    desc "new [APP_NAME]", "Start a new interactive Rails app setup"
-    option :default, type: :boolean, default: false, desc: "Use default configuration without prompting"
+    def self.exit_on_failure?
+      true
+    end
+
+    # Show help by default when no command is given
+    def self.start(given_args = ARGV, config = {})
+      if given_args.empty?
+        # Show command list instead of requiring a command argument
+        puts "Railstart - Interactive Rails 8 application generator"
+        puts ""
+        puts "Usage:"
+        puts "  railstart init                      # Generate config files"
+        puts "  railstart new [APP_NAME] [OPTIONS]  # Generate a new Rails app"
+        puts "  railstart version                   # Show version"
+        puts "  railstart help [COMMAND]            # Show help for a command"
+        puts ""
+        puts "Quick Start:"
+        puts "  railstart init                      # Create config files (optional)"
+        puts "  railstart new my_app                # Interactive mode"
+        puts "  railstart new my_app --default      # Use defaults"
+        puts "  railstart new my_app --preset api-only  # Use preset"
+        puts ""
+        puts "Run 'railstart help init' or 'railstart help new' for details"
+        return
+      end
+      super
+    end
+
+    # Custom banner to show available options
+    class << self
+      # rubocop:disable Style/OptionalBooleanParameter
+      def banner(command, _namespace = nil, _subcommand = false)
+        "#{basename} #{command.usage}"
+      end
+
+      # Override to show only positive form of boolean options
+      def help(shell, subcommand = false)
+        # rubocop:enable Style/OptionalBooleanParameter
+        list = printable_commands(true, subcommand)
+        Thor::Util.thor_classes_in(self).each do |klass|
+          list += klass.printable_commands(false)
+        end
+
+        shell.say "Commands:"
+        shell.print_table(list, indent: 2, truncate: true)
+        shell.say
+        class_options_help(shell)
+      end
+    end
+
+    # Override to customize option display
+    # rubocop:disable Style/OptionalBooleanParameter
+    def help(command = nil, subcommand = false)
+      # rubocop:enable Style/OptionalBooleanParameter
+      if command
+        if self.class.subcommands.include?(command)
+          self.class.subcommand_classes[command].help(shell, subcommand)
+        else
+          cmd = self.class.all_commands[command]
+          raise Thor::UndefinedCommandError, "Could not find command '#{command}'." unless cmd
+
+          shell.say "Usage:"
+          shell.say "  #{self.class.banner(cmd)}"
+          shell.say
+          if cmd.long_description
+            shell.say "Description:"
+            shell.print_wrapped(cmd.long_description, indent: 2)
+          else
+            shell.say cmd.description
+          end
+
+          print_custom_options(cmd)
+        end
+      else
+        super
+      end
+    end
+
+    no_commands do
+      def print_custom_options(cmd)
+        return unless cmd.options.any?
+
+        shell.say
+        shell.say "Options:"
+        cmd.options.each do |name, option|
+          print_option(name, option)
+        end
+      end
+
+      def print_option(name, option)
+        # For boolean options, only show the positive form
+        if option.type == :boolean
+          shell.say "  [--#{name}]#{" " * [20 - name.length, 0].max}# #{option.description}"
+        else
+          print_non_boolean_option(name, option)
+        end
+      end
+
+      def print_non_boolean_option(name, option)
+        banner_text = option.banner || name.to_s.upcase
+        padding = [20 - (name.length + banner_text.length + 3), 0].max
+        shell.say "  [--#{name}=#{banner_text}]#{" " * padding}# #{option.description}"
+      end
+    end
+    desc "new [APP_NAME]", "Generate a new Rails 8 application"
+    long_desc <<~DESC
+      Generate a new Rails 8 application with an interactive wizard.
+
+      Modes:
+        - Interactive (default): prompts for each question
+        - With preset: uses preset config (different questions/defaults), interactive or non-interactive
+
+      Examples:
+        railstart new my_app                          # Interactive mode
+        railstart new my_app --default                # Non-interactive with default preset (if exists)
+        railstart new my_app --preset api-only        # Interactive with api-only preset config
+        railstart new my_app --preset api-only --default  # Non-interactive with api-only preset
+
+      Presets are stored in: ~/.config/railstart/presets/*.yaml
+    DESC
+    option :default, type: :boolean, default: false, desc: "Use defaults non-interactively"
+    option :preset, type: :string, desc: "Preset name from ~/.config/railstart/presets/", banner: "NAME"
     #
     # @param app_name [String, nil] desired Rails app name, prompted if omitted
     # @return [void]
     # @raise [Railstart::Error] when generation fails due to configuration or runtime errors
     # @example Start wizard with prompts
     #   Railstart::CLI.start(%w[new my_app])
+    # @example Use preset
+    #   Railstart::CLI.start(%w[new my_app --preset api-only])
+    # @example Use default preset non-interactively
+    #   Railstart::CLI.start(%w[new my_app --default])
     def new(app_name = nil)
-      generator = Generator.new(app_name, use_defaults: options[:default])
+      preset_name = determine_preset_name
+      preset_path = preset_name ? preset_file_for(preset_name) : nil
+
+      config = Config.load(preset_path: preset_path)
+
+      generator = Generator.new(
+        app_name,
+        config: config,
+        use_defaults: options[:default]
+      )
+
       generator.run
     rescue Railstart::Error => e
       puts "Error: #{e.message}"
       exit 1
     end
 
+    desc "init", "Generate config directory and starter files"
+    long_desc <<~DESC
+      Creates ~/.config/railstart directory structure with example configuration files.
+
+      This generates:
+        - ~/.config/railstart/config.yaml (example user config)
+        - ~/.config/railstart/presets/ directory
+        - ~/.config/railstart/presets/example.yaml (example preset)
+
+      You can then customize these files for your preferences.
+    DESC
+    option :force, type: :boolean, default: false, desc: "Overwrite existing files"
+    #
+    # @return [void]
+    # @example Generate config files
+    #   Railstart::CLI.start(%w[init])
+    def init
+      config_dir = File.expand_path("~/.config/railstart")
+      presets_dir = File.join(config_dir, "presets")
+
+      # Create directories
+      FileUtils.mkdir_p(presets_dir)
+      puts "✓ Created #{config_dir}"
+      puts "✓ Created #{presets_dir}"
+
+      # Generate example user config
+      user_config_path = File.join(config_dir, "config.yaml")
+      if File.exist?(user_config_path) && !options[:force]
+        puts "⊗ Skipped #{user_config_path} (already exists, use --force to overwrite)"
+      else
+        File.write(user_config_path, example_user_config)
+        puts "✓ Created #{user_config_path}"
+      end
+
+      # Generate example preset
+      example_preset_path = File.join(presets_dir, "example.yaml")
+      if File.exist?(example_preset_path) && !options[:force]
+        puts "⊗ Skipped #{example_preset_path} (already exists, use --force to overwrite)"
+      else
+        File.write(example_preset_path, example_preset_config)
+        puts "✓ Created #{example_preset_path}"
+      end
+
+      puts "\n✨ Configuration files initialized!"
+      puts "\nNext steps:"
+      puts "  1. Edit ~/.config/railstart/config.yaml to customize defaults"
+      puts "  2. Create custom presets in ~/.config/railstart/presets/"
+      puts "  3. Use with: railstart new my_app --preset example"
+    end
+
     desc "version", "Print Railstart version"
     #
     # @return [void]
@@ -35,5 +220,104 @@ module Railstart
     def version
       puts "Railstart v#{Railstart::VERSION}"
     end
+
+    PRESET_DIR = File.expand_path("~/.config/railstart/presets")
+    GEM_PRESET_DIR = File.expand_path("../../config/presets", __dir__)
+
+    private
+
+    def determine_preset_name
+      # Explicit --preset flag takes priority
+      return options[:preset] if options[:preset]
+
+      # --default maps to "default" preset
+      return "default" if options[:default]
+
+      nil
+    end
+
+    def preset_file_for(name)
+      # Check user presets first
+      user_path = File.join(PRESET_DIR, "#{name}.yaml")
+      return user_path if File.exist?(user_path)
+
+      # Fall back to built-in gem presets
+      gem_path = File.join(GEM_PRESET_DIR, "#{name}.yaml")
+      return gem_path if File.exist?(gem_path)
+
+      # If explicit --preset was used, raise error
+      raise Railstart::ConfigLoadError, "Preset '#{name}' not found in #{PRESET_DIR} or gem presets" if options[:preset]
+
+      # For --default with missing preset, return nil (fall back to builtin config)
+      nil
+    end
+
+    def example_user_config
+      <<~YAML
+        ---
+        # Railstart User Configuration
+        # This file overrides built-in defaults for all your Rails projects.
+        #
+        # Merge behavior: questions and post_actions are merged by 'id'.
+        # Override individual fields or add new entries.
+
+        questions:
+          # Example: Change database default to PostgreSQL
+          - id: database
+            choices:
+              - name: PostgreSQL
+                value: postgresql
+                default: true
+
+          # Example: Change CSS default to Tailwind
+          - id: css
+            choices:
+              - name: Tailwind
+                value: tailwind
+                default: true
+
+        post_actions:
+          # Example: Disable bundle install (manage gems manually)
+          # - id: bundle_install
+          #   enabled: false
+
+          # Example: Add custom post-action
+          # - id: setup_linting
+          #   name: "Setup RuboCop and StandardRB"
+          #   enabled: true
+          #   command: "bundle add rubocop rubocop-rails standard --group development"
+      YAML
+    end
+
+    def example_preset_config
+      <<~YAML
+        ---
+        # Example Preset - Customize this for your use case
+        # Use with: railstart new my_app --preset example
+
+        questions:
+          - id: database
+            choices:
+              - name: PostgreSQL
+                value: postgresql
+                default: true
+
+          - id: css
+            choices:
+              - name: Tailwind
+                value: tailwind
+                default: true
+
+          - id: api_only
+            default: false
+
+        post_actions:
+          - id: init_git
+            enabled: true
+
+          - id: bundle_install
+            enabled: true
+      YAML
+    end
   end
 end

data/lib/railstart/config.rb

@@ -17,19 +17,25 @@ module Railstart
 
     class << self
       #
-      # Load, merge, and validate configuration from built-in and user sources.
+      # Load, merge, and validate configuration from built-in, user, and preset sources.
       #
       # @param builtin_path [String] path to default config YAML shipped with the gem
       # @param user_path [String] optional user override YAML path
+      # @param preset_path [String] optional preset YAML path (third overlay)
       # @return [Hash] deep-copied, merged, validated configuration hash
       # @raise [Railstart::ConfigLoadError] when YAML files are missing or unreadable
       # @raise [Railstart::ConfigValidationError] when validation fails
       # @example
       #   config = Railstart::Config.load
-      def load(builtin_path: BUILTIN_CONFIG_PATH, user_path: USER_CONFIG_PATH)
+      # @example With preset
+      #   config = Railstart::Config.load(preset_path: "~/.config/railstart/presets/api-only.yaml")
+      def load(builtin_path: BUILTIN_CONFIG_PATH, user_path: USER_CONFIG_PATH, preset_path: nil)
         builtin = read_yaml(builtin_path, required: true)
         user = read_yaml(user_path, required: false)
+        preset = preset_path ? read_yaml(preset_path, required: false) : {}
+
         merged = merge_config(builtin, user)
+        merged = merge_config(merged, preset) unless preset.empty?
         validate!(merged)
         merged
       end

data/lib/railstart/generator.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "tty-prompt"
+require_relative "ui"
 
 module Railstart
   # Orchestrates the interactive Rails app generation flow.
@@ -11,11 +12,13 @@ module Railstart
   # @example Run generator with provided config
   #   config = Railstart::Config.load
   #   Railstart::Generator.new("blog", config: config).run
+  # @example Run generator non-interactively
+  #   Railstart::Generator.new("blog", use_defaults: true).run
   class Generator
     #
     # @param app_name [String, nil] preset app name, prompted if nil
     # @param config [Hash, nil] injected config for testing, defaults to Config.load
-    # @param use_defaults [Boolean] skip interactive mode and use all defaults
+    # @param use_defaults [Boolean] skip interactive questions, use config defaults
     # @param prompt [TTY::Prompt] injectable prompt for testing
     def initialize(app_name = nil, config: nil, use_defaults: false, prompt: nil)
       @app_name = app_name
@@ -28,13 +31,27 @@ module Railstart
     #
     # Run the complete generation flow, prompting the user and invoking Rails.
     #
+    # Mode selection:
+    #   - use_defaults: false (default) → interactive wizard
+    #   - use_defaults: true → collect config defaults, show summary, confirm, run
+    #
     # @return [void]
     # @raise [Railstart::ConfigError, Railstart::ConfigValidationError] when configuration is invalid
-    # @example Run interactively using defaults or custom answers
-    #   Railstart::Generator.new.run
+    # @example Run interactively
+    #   Railstart::Generator.new("blog").run
+    # @example Run with defaults (noninteractive questions)
+    #   Railstart::Generator.new("blog", use_defaults: true).run
     def run
+      show_welcome_screen unless @use_defaults
+
       ask_app_name unless @app_name
-      ask_questions
+
+      if @use_defaults
+        collect_defaults
+      else
+        ask_interactive_questions
+      end
+
       show_summary
       return unless confirm_proceed?
 
@@ -44,24 +61,24 @@ module Railstart
 
     private
 
+    def show_welcome_screen
+      UI.show_logo
+      UI.show_welcome
+    end
+
     def ask_app_name
       @app_name = @prompt.ask("App name?", default: "my_app") do |q|
         q.validate(/\A[a-z0-9_-]+\z/, "Must be lowercase letters, numbers, underscores, or hyphens")
       end
     end
 
-    def ask_questions
-      if @use_defaults
-        collect_defaults
-      else
-        ask_interactive_questions
-      end
-    end
-
     def collect_defaults
       Array(@config["questions"]).each do |question|
+        next if should_skip_question?(question)
+
+        question_id = question["id"]
         default_value = find_default(question)
-        @answers[question["id"]] = default_value unless default_value.nil?
+        @answers[question_id] = default_value unless default_value.nil?
       end
     end
 
@@ -102,14 +119,23 @@ module Railstart
     end
 
     def ask_select(question)
-      choices = question["choices"].map { |c| [c["name"], c["value"]] }
+      # Convert to hash format: { 'Display Name' => 'value' }
+      choices = question["choices"].each_with_object({}) do |choice, hash|
+        hash[choice["name"]] = choice["value"]
+      end
       default_val = find_default(question)
 
-      @prompt.select(question["prompt"], choices, default: default_val)
+      # TTY::Prompt expects 1-based index for default
+      default_index = (question["choices"].index { |c| c["value"] == default_val }&.+(1) if default_val)
+
+      @prompt.select(question["prompt"], choices, default: default_index)
     end
 
     def ask_multi_select(question)
-      choices = question["choices"].map { |c| [c["name"], c["value"]] }
+      # Convert to hash format: { 'Display Name' => 'value' }
+      choices = question["choices"].each_with_object({}) do |choice, hash|
+        hash[choice["name"]] = choice["value"]
+      end
       defaults = question["default"] || []
 
       @prompt.multi_select(question["prompt"], choices, default: defaults)
@@ -131,10 +157,11 @@ module Railstart
     end
 
     def show_summary
-      puts "\n════════════════════════════════════════"
-      puts "Summary"
-      puts "════════════════════════════════════════"
-      puts "App name: #{@app_name}"
+      puts
+      UI.section("Configuration Summary")
+      puts
+
+      summary_lines = ["App name: #{UI.pastel.bright_cyan(@app_name)}"]
 
       Array(@config["questions"]).each do |question|
         question_id = question["id"]
@@ -154,34 +181,53 @@ module Railstart
                       answer.to_s
                     end
 
-        puts "#{label}: #{value_str}"
+        summary_lines << "#{label}: #{UI.pastel.bright_white(value_str)}"
       end
-      puts "════════════════════════════════════════\n"
+
+      box = TTY::Box.frame(
+        width: 60,
+        padding: [0, 2],
+        border: :light,
+        style: {
+          border: { fg: :bright_black }
+        }
+      ) { summary_lines.join("\n") }
+
+      puts box
+      puts
     end
 
     def confirm_proceed?
-      return true if @use_defaults
-
       @prompt.yes?("Proceed with app generation?")
     end
 
     def generate_app
       command = CommandBuilder.build(@app_name, @config, @answers)
 
-      puts "Running: #{command}\n\n"
-      success = system(command)
+      UI.info("Running: #{command}")
+      puts
+
+      # Run rails command outside of bundler context to use system Rails
+      success = if defined?(Bundler)
+                  Bundler.with_unbundled_env { system(command) }
+                else
+                  system(command)
+                end
 
       return if success
 
+      UI.error("Failed to generate Rails app. Check the output above for details.")
       raise Error, "Failed to generate Rails app. Check the output above for details."
     end
 
     def run_post_actions
       Dir.chdir(@app_name)
+
       Array(@config["post_actions"]).each { |action| process_post_action(action) }
-      puts "\n✨ Rails app created successfully at ./#{@app_name}"
+      puts
+      UI.success("Rails app created successfully at ./#{@app_name}")
     rescue Errno::ENOENT
-      warn "Could not change to app directory. Post-actions skipped."
+      UI.warning("Could not change to app directory. Post-actions skipped.")
     end
 
     def process_post_action(action)
@@ -198,9 +244,9 @@ module Railstart
     end
 
     def execute_action(action)
-      puts "→ #{action["name"]}"
+      UI.info(action["name"].to_s)
       success = system(action["command"])
-      warn "Warning: Post-action '#{action["name"]}' failed. Continuing anyway." unless success
+      UI.warning("Post-action '#{action["name"]}' failed. Continuing anyway.") unless success
     end
 
     def should_run_action?(action)

data/lib/railstart/ui.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+require "tty-box"
+
+module Railstart
+  # Provides UI enhancement utilities for the Railstart CLI.
+  #
+  # Handles ASCII art headers, styled boxes, and visual polish
+  # to create a Laravel-like installer experience.
+  module UI
+    # ASCII art logo for Railstart
+    LOGO = <<~LOGO
+      ╔═╗┌─┐┬┬  ┌─┐┌┬┐┌─┐┬─┐┌┬┐
+      ╠╦╝├─┤││  └─┐ │ ├─┤├┬┘ │
+      ╩╚═┴ ┴┴┴─┘└─┘ ┴ ┴ ┴┴└─ ┴
+    LOGO
+
+    module_function
+
+    #
+    # Display the Railstart ASCII art logo with version and optional color.
+    #
+    # @param color [Symbol] color name (e.g., :cyan, :green, :magenta)
+    # @return [void]
+    def show_logo(color: :cyan)
+      require_relative "version"
+      puts pastel.send(color, LOGO)
+      puts pastel.dim("      v#{Railstart::VERSION}")
+      puts
+    end
+
+    #
+    # Display a styled welcome message in a box.
+    #
+    # @param message [String] the welcome text to display (defaults to Rails version message)
+    # @return [void]
+    def show_welcome(message = nil)
+      message ||= "Interactive Rails #{rails_version} Application Generator"
+
+      box = TTY::Box.frame(
+        width: 60,
+        height: 3,
+        align: :center,
+        padding: [0, 1],
+        border: :thick,
+        style: {
+          fg: :bright_white,
+          border: { fg: :cyan }
+        }
+      ) { message }
+
+      puts box
+      puts # blank line
+    end
+
+    #
+    # Detect the installed Rails version.
+    #
+    # @return [String] Rails version or "Unknown" if not found
+    def rails_version
+      require "bundler"
+      Bundler.with_unbundled_env do
+        version_output = `rails --version 2>/dev/null`.strip
+        version_output[/Rails (\d+\.\d+\.\d+)/, 1] || "Unknown"
+      end
+    rescue StandardError
+      "Unknown"
+    end
+
+    #
+    # Display a section header with optional separator line.
+    #
+    # @param title [String] section title
+    # @param separator [Boolean] whether to show a line underneath
+    # @return [void]
+    def section(title, separator: true)
+      puts pastel.cyan.bold(title.to_s)
+      puts pastel.dim("─" * 60) if separator
+    end
+
+    #
+    # Display a success message with checkmark.
+    #
+    # @param message [String] the success message
+    # @return [void]
+    def success(message)
+      puts pastel.green("✓ #{message}")
+    end
+
+    #
+    # Display a warning message with icon.
+    #
+    # @param message [String] the warning message
+    # @return [void]
+    def warning(message)
+      puts pastel.yellow("⚠ #{message}")
+    end
+
+    #
+    # Display an error message with icon.
+    #
+    # @param message [String] the error message
+    # @return [void]
+    def error(message)
+      puts pastel.red("✗ #{message}")
+    end
+
+    #
+    # Display an info message with icon.
+    #
+    # @param message [String] the info message
+    # @return [void]
+    def info(message)
+      puts pastel.blue("ℹ #{message}")
+    end
+
+    #
+    # Lazy-load Pastel for color formatting.
+    #
+    # @return [Pastel] pastel instance
+    def pastel
+      @pastel ||= begin
+        require "pastel"
+        Pastel.new
+      rescue LoadError
+        # Fallback to no-op if pastel is not available
+        # (tty-prompt depends on pastel, so this should never happen)
+        NullPastel.new
+      end
+    end
+
+    # Null object pattern for when Pastel is unavailable
+    class NullPastel
+      def method_missing(_method, *args)
+        args.first.to_s
+      end
+
+      def respond_to_missing?(*)
+        true
+      end
+    end
+  end
+end

data/lib/railstart/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Railstart
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railstart
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - dpaluy
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-box
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: tty-prompt
   requirement: !ruby/object:Gem::Requirement
@@ -53,6 +67,8 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- config/presets/api-only.yaml
+- config/presets/default.yaml
 - config/rails8_defaults.yaml
 - exe/railstart
 - lib/railstart.rb
@@ -61,6 +77,7 @@ files:
 - lib/railstart/config.rb
 - lib/railstart/errors.rb
 - lib/railstart/generator.rb
+- lib/railstart/ui.rb
 - lib/railstart/version.rb
 homepage: https://github.com/dpaluy/railstart
 licenses:
@@ -86,7 +103,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Rails application starter and development utilities
 test_files: []