create-rails-app Gem Version Codecov CI

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

Table of Contents

Supported Ruby Versions

Ruby 3.2+ is required.

Installation

gem install create-rails-app

Features

  • 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

Usage

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

Configuration

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

Supported Rails Versions

Version Supported
8.1 :white_check_mark:
8.0 :white_check_mark:
7.2 :white_check_mark:

Development

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.

Contributing

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.

Changelog

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

Versioning

This project follows Semantic Versioning 2.0.0

License

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