IntelliJ IDEA 2016.3 Help

Creating Rails-Based Projects

In this section:

Basics

In IntelliJ IDEA, one can create several Rails-based project types.

  • Rails applications are intended for productive web development with Ruby on Rails.
  • Rails mountable engine projects are used to provide additional functionality to their host applications.
  • Rails API projects are intended for building REST APIs with Rails.
  • RailsApp Sample projects are intended for mastering Rails.

Creating Rails-based projects

To create a Rails-based project, follow these general steps

  1. Do one of the following:
    • On the main menu, choose File | New | Project
    • On the Welcome screen, click New Project

    New Project dialog box opens.

  2. Specify the following:
    • In the Project SDK drop-down list, select the Ruby SDK you want to use from the list of available Ruby interpreters, installed on your computer. Refer to the section Configuring Ruby SDK for the procedures of installing interpreters.

      If the desired Ruby interpreter is not found in the list, you can specify a new one by clicking the button New..., and locating Ruby SDK in the file system.

    • In the Rails Version drop-down list, select the desired Rails version from those installed on your machine.

      If the desired version is missing, choose Install Rails Gem... command from the drop-down list. IntelliJ IDEA downloads the list of gems. Next, you have to choose one from the drop-down list in the Install rails gem dialog box:

      /help/img/idea/2016.3/rails_gem_version.png
    • In the field Rails Template, type the fully qualified path to the desired template file, or click the button /help/img/idea/2016.3/browseButton.png, and locate the template file in the file system.
    • For the Ruby an Rails application , you can select the JavaScript library to be used to generate the target application.
    • For the Ruby an Rails application or Rails API project types, specify which database will be used for your new application.

      By default, IntelliJ IDEA suggests using SQLite3. If you want to use a different database, select the Preconfigure for the selected database check box, and choose the desired database from the drop-down list.

    • For the Ruby an Rails application specify whether IntelliJ IDEA should generate the testing directory structure and template files. To do that, select or clear the check box Skip Test::Unit files. If you leave the check box cleared, IntelliJ IDEA will produce the test folder, marked as a test root /help/img/idea/2016.3/rootTest.gif, with all the necessary infrastructure. If you select this check box, the testing infrastructure will not be generated.
    • For the RailsApps Sample project type, select the sample type from the list of available types.

    When ready, click Finish. The generator executes and displays its output in the console of the Run tool window.

Creating Rails samples

If you are going to study Rails, choose the option RailsApps Sample. Specify the project location and Ruby SDK, and then choose the exact sample project.

If there are changes to the list of sample projects, click /help/img/idea/2016.3/refresh.png.

Notes for OS X and Linux users:

  • When choosing the project interpreter, keep in mind that Ruby version may be different from the one provided in the file .ruby-version.
  • If you choose rvm with the a gemset, note that this gemset applies to the file .ruby-gemset.

In both cases, IntelliJ IDEA provides the ability to revert:

/help/img/idea/2016.3/rm_RailsAppSamples_interpreter.png

See Also

Concepts:

Language and Framework-Specific Guidelines:

Last modified: 29 November 2016