railstart 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a11ff1fa7939d71ae25db7c053cb82f0d20babc2ea36f80d5b455ef909ac9a5b
-  data.tar.gz: 81dbc554f5bb0f4b77ddf1786d10c5b70018a49e319bbdec40397586338b6f58
+  metadata.gz: 3b7aaa542b7abf7c01dbbbb6bfcb71ce8dede1ae7b1535683e4538ac0aad138e
+  data.tar.gz: 150539a6c55e31e18b33a0852f2e0840057518f5789644073320e060190399bd
 SHA512:
-  metadata.gz: 75b456127f40e5636561bb7fdedf260eafadc8a32a89f4ba8088807735a0746a52cafa6975beef669f869fe47e8ea870cc7a30f471ef525c9d8e492a6d472185
-  data.tar.gz: 1a02ea13c31ed012b01a7ec83ca6388f09407b74d7fa72c4134bd46f860e71435ccd586931e6569e7809cd109c55504112f6d7b747a6ede87561af6d75513106
+  metadata.gz: e180fd3ba85eaad0ca8f0f20726c66b4567e7799000d7bac4e35919d0519deab21772c1f44968d3ff152a74019e33551c8b0f9cba544f814a3f14b006a3ac7de
+  data.tar.gz: 1733110d3c2f9901d6154a87cd3b479596df1d949fff1b9f02e29cd3415c834eba3eb738d30c7a1f1124c8934338f65ef2fb43e38714775f55c349ae578e7bf7

data/CHANGELOG.md

@@ -6,6 +6,40 @@ 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.3.0] - 2025-11-22
+
+### Added
+- **CSS framework**: Added Sass option to CSS framework choices
+- **CSS framework**: Added "None (skip CSS setup)" option for skipping CSS configuration
+- **JavaScript bundler**: Added Bun as a JavaScript bundler option (Rails 8 native support)
+- **JavaScript bundler**: Added Vite (via vite_rails gem) with automatic post-installation setup
+- **JavaScript bundler**: Added "None (skip JavaScript)" option using `--skip-javascript` flag
+- **Test framework**: New test framework selection question (Minitest default, RSpec option)
+- **Post-action**: RSpec automatic setup (`bundle add rspec-rails` + `rails generate rspec:install`) when selected
+- **Post-action**: Vite Rails automatic setup (`bundle add vite_rails` + `bundle exec vite install`) when selected
+- **Post-action**: Bundlebun optional setup (`bundle add bundlebun` + `rake bun:install`) for Bun packaged as a gem
+- **Preset**: New `vite-bun.yaml` preset for modern frontend with Vite + Bundlebun (use with `--preset vite-bun`)
+- **Command builder**: Choice-level `rails_flag` support for SELECT questions
+- **Command builder**: Different choices can now have different flags or no flag at all
+- **Tests**: Comprehensive test coverage for choice-level rails_flag feature
+
+### Changed
+- **JavaScript question**: Renamed prompt from "Which JavaScript bundler?" to "Which JavaScript approach?"
+- **Command builder**: SELECT questions now check for choice-level flags before falling back to question-level flags
+- **Command builder**: Vite choice doesn't add any rails flag (handled via post-action instead)
+- **Config**: JavaScript choices now use choice-level `rails_flag` instead of question-level for flexibility
+
+### Technical
+- Enhanced `CommandBuilder.process_select` to support per-choice flag configuration
+- Backward compatible with existing configs using question-level flags
+- All tests pass (33 runs, 97 assertions, 0 failures)
+- Rubocop clean (no offenses)
+
+## [0.2.1] - 2025-11-22
+
+### Fixed
+- Thor::UndefinedCommandError raised with incorrect number of arguments (now passes command, nil, and all_commands.keys)
+
 ## [0.2.0] - 2025-11-22
 
 ### Added
@@ -38,7 +72,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 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

data/README.md

@@ -141,6 +141,70 @@ railstart new my_app --preset api-only
 railstart new my_app --preset api-only --default
 ```
 
+## Creating Custom Presets
+
+Presets are powerful tools for defining opinionated Rails configurations for specific stacks or team standards. For comprehensive guidance on creating presets, see **[Creating Presets Guide](docs/railstart-preset-builder/SKILL.md)**.
+
+### Quick Preset Creation
+
+Create a new preset file in `config/presets/{name}.yaml`:
+
+```yaml
+---
+# My Team Preset - PostgreSQL + RSpec + Vite
+
+questions:
+  - id: database
+    choices:
+      - name: PostgreSQL
+        value: postgresql
+        default: true
+
+  - id: javascript
+    choices:
+      - name: Vite (via vite_rails gem)
+        value: vite
+        default: true
+
+  - id: test_framework
+    choices:
+      - name: RSpec
+        value: rspec
+        default: true
+
+post_actions:
+  - id: setup_vite
+    enabled: true
+
+  - id: setup_rspec
+    enabled: true
+```
+
+Then use it:
+
+```bash
+railstart new myapp --preset my-team
+```
+
+### Built-in Presets
+
+Railstart includes several ready-to-use presets:
+
+- **`default`** - PostgreSQL + Tailwind + Importmap (sensible defaults)
+- **`api-only`** - Minimal Rails for JSON APIs (no views, no frontend)
+- **`vite-bun`** - Modern SPA with Vite + Bundlebun
+
+### Learn More
+
+For detailed documentation including:
+- Available questions and post-actions
+- ID-based merging system
+- Step-by-step workflow
+- Real-world examples
+- Best practices and troubleshooting
+
+See the comprehensive **[Creating Presets Guide](docs/railstart-preset-builder/SKILL.md)**.
+
 ## Configuration
 
 ### Initialize Configuration Files

data/config/presets/vite-bun.yaml

@@ -0,0 +1,59 @@
+---
+# Vite + Bundlebun Preset - Modern frontend with Vite and Bun packaged as a gem
+# This preset configures Rails with Vite for fast HMR and Bundlebun for unified JavaScript runtime
+
+questions:
+  - id: database
+    choices:
+      - name: PostgreSQL
+        value: postgresql
+        default: true
+
+  - id: css
+    choices:
+      - name: Tailwind
+        value: tailwind
+        default: true
+
+  - id: javascript
+    choices:
+      - name: Vite (via vite_rails gem)
+        value: vite
+        default: true
+
+  - id: test_framework
+    choices:
+      - name: Minitest (default)
+        value: minitest
+        default: true
+
+  - id: skip_features
+    default: []
+
+  - id: api_only
+    default: false
+
+  - id: skip_git
+    default: true
+
+  - id: skip_docker
+    default: false
+
+  - id: skip_bundle
+    default: false
+
+post_actions:
+  - id: setup_vite
+    name: "Setup Vite Rails"
+    enabled: true
+    command: "bundle add vite_rails && bundle install && bundle exec vite install"
+
+  - id: setup_bundlebun
+    name: "Setup Bundlebun (Bun packaged as a gem)"
+    enabled: true
+    command: "bundle add bundlebun && bundle install && bundle exec rake bun:install"
+
+  - id: init_git
+    name: "Initialize git repository"
+    enabled: true
+    command: "git init && git add . && git commit -m 'Initial commit with Vite + Bundlebun'"

data/config/rails8_defaults.yaml

@@ -30,24 +30,35 @@ questions:
         value: bulma
       - name: PostCSS (no framework)
         value: postcss
-      - name: None
+      - name: Sass
+        value: sass
+      - name: None (skip CSS setup)
         value: none
     rails_flag: "--css=%{value}"
 
   - id: javascript
     type: select
-    prompt: "Which JavaScript bundler?"
+    prompt: "Which JavaScript approach?"
     choices:
       - name: Importmap (default)
         value: importmap
         default: true
+        rails_flag: "--javascript=importmap"
+      - name: Bun
+        value: bun
+        rails_flag: "--javascript=bun"
       - name: esbuild
         value: esbuild
-      - name: Webpack
-        value: webpack
+        rails_flag: "--javascript=esbuild"
       - name: Rollup
         value: rollup
-    rails_flag: "--javascript=%{value}"
+        rails_flag: "--javascript=rollup"
+      - name: Webpack
+        value: webpack
+        rails_flag: "--javascript=webpack"
+      - name: None (skip JavaScript)
+        value: none
+        rails_flag: "--skip-javascript"
 
   - id: skip_features
     type: multi_select
@@ -102,6 +113,17 @@ questions:
     default: false
     rails_flag: "--skip-bundle"
 
+  - id: test_framework
+    type: select
+    prompt: "Which test framework?"
+    choices:
+      - name: Minitest (default)
+        value: minitest
+        default: true
+      - name: RSpec
+        value: rspec
+        rails_flag: "--skip-test"
+
 post_actions:
   - id: init_git
     name: "Initialize git repository"
@@ -122,3 +144,11 @@ post_actions:
       question: skip_bundle
       equals: true
     command: "bundle install"
+
+  - id: setup_rspec
+    name: "Setup RSpec"
+    enabled: true
+    if:
+      question: test_framework
+      equals: rspec
+    command: "bundle add rspec-rails --group development,test && bundle exec rails generate rspec:install"

data/lib/railstart/cli.rb

@@ -71,7 +71,7 @@ module Railstart
           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
+          raise Thor::UndefinedCommandError.new(command, nil, self.class.all_commands.keys) unless cmd
 
           shell.say "Usage:"
           shell.say "  #{self.class.banner(cmd)}"

data/lib/railstart/command_builder.rb

@@ -42,13 +42,29 @@ module Railstart
 
       def process_question_flags(flags, question, answer)
         case question["type"]
-        when "select", "yes_no", "input"
+        when "select"
+          process_select(flags, question, answer)
+        when "yes_no", "input"
           add_flags(flags, question, answer)
         when "multi_select"
           process_multi_select(flags, question, answer)
         end
       end
 
+      def process_select(flags, question, answer)
+        # Check if the selected choice has a choice-level rails_flag
+        selected_choice = Array(question["choices"]).find { |choice| choice["value"] == answer }
+
+        if selected_choice && (selected_choice["rails_flag"] || selected_choice["rails_flags"])
+          # Use choice-level flag
+          add_flags(flags, selected_choice, answer)
+        elsif question["rails_flag"] || question["rails_flags"]
+          # Fall back to question-level flag
+          add_flags(flags, question, answer)
+        end
+        # If neither exists, no flag is added (e.g., for choices that don't need flags)
+      end
+
       def process_multi_select(flags, question, answer)
         Array(question["choices"]).each do |choice|
           next unless Array(answer).include?(choice["value"])

data/lib/railstart/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railstart
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - dpaluy
@@ -69,6 +69,7 @@ files:
 - Rakefile
 - config/presets/api-only.yaml
 - config/presets/default.yaml
+- config/presets/vite-bun.yaml
 - config/rails8_defaults.yaml
 - exe/railstart
 - lib/railstart.rb