create-rails-app

Interactive CLI wizard for rails new — walks you through every option, remembers your choices, and saves reusable presets.

• Supported Ruby Versions
• Installation
• Features
• Usage
• Configuration
• Supported Rails Versions
• Development
• Contributing
• Changelog
• Versioning
• License

Ruby 3.2+ is required.

gem install create-rails-app

• Interactive step-by-step wizard for all rails new options
• Supports Rails 7.2+ with version-aware option filtering
• Remembers last-used choices and saves reusable presets
• Back navigation (Ctrl+B) to change previous answers
• Dry-run mode to preview the generated command
• Smart skip rules (e.g., skips database prompt if Active Record is disabled)
• Color-coded terminal UI

Start the wizard:

create-rails-app

With an app name:

create-rails-app myapp

Preview the generated command without running it:

create-rails-app --dry-run

Use a saved preset:

create-rails-app --preset api

List available presets:

create-rails-app --list-presets

Presets and last-used choices are stored in ~/.config/create-rails-app/config.yml (follows the XDG Base Directory Specification).

After checking out the repo, run bin/setup to install dependencies. Then, run bundle exec rake to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install.

Sibling project: create-ruby-gem — the same idea for bundle gem.

Bug reports and pull requests are welcome on GitHub. See CONTRIBUTING.md for development setup, code style, and PR guidelines.

This project follows the Contributor Covenant Code of Conduct.

See CHANGELOG.md for a detailed history of changes, following Keep a Changelog format.

This project follows Semantic Versioning 2.0.0

The gem is available as open source under the terms of the MIT License.