RubyMine 2023.3 Help

Create a new project

New empty project

This is a basic project intended for pure Ruby programming.

  1. Launch RubyMine.

    Do one of the following:

    • Click New Project on the Welcome screen.

    • Select File | New | Project from the main menu.

    • (Available in the new UI) Click the Project widget in the main window header and select New Project.

      Create a new project using the Project widget
  2. From the list on the left, select Empty Project.

  3. Name the new project and change its location if necessary.

  4. In the Interpreter field, select the Ruby interpreter that you want to use in your project.

  5. Click Create.

    Creating a new empty project

New Ruby Gem

In RubyMine, you can create Ruby gem applications, build, and publish them. This project type provides the necessary infrastructure and artifacts required for creating gems.

  1. Launch RubyMine.

    Do one of the following:

    • Click New Project on the Welcome screen.

    • Select File | New | Project from the main menu.

    • (Available in the new UI) Click the Project widget in the main window header and select New Project.

      Create a new project using the Project widget
  2. From the list on the left, select Gem.

  3. Name the new project and change its location if necessary.

  4. In the Interpreter field, select the Ruby interpreter that you want to use in your project.

  5. Select the testing framework that you want to use in your project: Minitest or RSpec.

  6. If necessary, select one or several generation options:

    • Code of conduct: adds a file containing a Code of Conduct to your project.

    • MIT license: adds a file with an MIT license to your project.

    • Binary executable: generates a binary executable in your project. RubyMine stores this binary in the exe/GEM_NAME directory and also adds it to the GEM_NAME.gemspec manifest.

    • C extension boilerplate: adds a boilerplate for C extension code to the generated project.

  7. Click Create.

    Creating a new Ruby gem

New Rails project

Rails project types are intended for Ruby-on-Rails development and contain specific infrastructure and necessary artifacts.

  1. Launch RubyMine.

    Do one of the following:

    • Click New Project on the Welcome screen.

    • Select File | New | Project from the main menu.

    • (Available in the new UI) Click the Project widget in the main window header and select New Project.

      Create a new project using the Project widget
  2. From the list on the left, select Application in the Rails group.

  3. Name the new project and change its location if necessary.

  4. In the Interpreter field, select the Ruby interpreter that you want to use in your project.

  5. In the Rails version field, select a Rails version that you want to use in your project. If the Rails gem is not installed in the selected SDK or the necessary Rails version is missing, click the Install Rails Gem button in the field. Wait until RubyMine downloads all available Rails versions and select the necessary one from the dropdown. Click OK to continue.

    Install rails gem

    If the selected version is not installed yet, RubyMine will install it upon project creation.

  6. In the Database field, select a database you want to use in your application.

  7. Toggle the JavaScript framework checkbox if you want to add a JavaScript framework to your Rails application. Then, select one of the frameworks from the dropdown.

  8. If necessary, provide additional Rails options for project creation in the Extra options field.

    For example, you can specify arguments that you will normally use to append the rails new command: --skip-tests to skip creation of test files, --skip-action-mailer to skip Action Mailer files, --skip-action-cable to skip Action Cable files, and so on.

    To get a full list of Rails options compatible with the Rails version in use, run the rails new --help command.

  9. Click Create.

    New Project dialog: Rails application
  1. Launch RubyMine.

    Do one of the following:

    • Click New Project on the Welcome screen.

    • Select File | New | Project from the main menu.

    • (Available in the new UI) Click the Project widget in the main window header and select New Project.

      Create a new project using the Project widget
  2. From the list on the left, select Mountable Engine in the Rails group.

  3. Name the new project and change its location if necessary.

  4. In the Interpreter field, select the Ruby interpreter that you want to use in your project.

  5. In the Rails version field, select a Rails version that you want to use in your project. If the Rails gem is not installed in the selected SDK or the necessary Rails version is missing, click the Install Rails Gem button in the field. Wait until RubyMine downloads all available Rails versions and select the necessary one from the dropdown. Click OK to continue.

    Install rails gem

    If the selected version is not installed yet, RubyMine will install it upon project creation.

  6. In the Database field, select a database you want to use in your application.

  7. If necessary, provide additional Rails options for project creation in the Extra options field.

    For example, you can specify arguments that you will normally use to append the rails new command: --skip-tests to skip creation of test files, --skip-action-mailer to skip Action Mailer files, --skip-action-cable to skip Action Cable files, and so on.

    To get a full list of Rails options compatible with the Rails version in use, run the rails new --help command.

  8. Click Create.

    New Project dialog: Rails application
  1. Launch RubyMine.

    Do one of the following:

    • Click New Project on the Welcome screen.

    • Select File | New | Project from the main menu.

    • (Available in the new UI) Click the Project widget in the main window header and select New Project.

      Create a new project using the Project widget
  2. From the list on the left, select Rails API in the Rails group.

  3. Name the new project and change its location if necessary.

  4. In the Interpreter field, select the Ruby interpreter that you want to use in your project.

  5. In the Rails version field, select a Rails version that you want to use in your project. If the Rails gem is not installed in the selected SDK or the necessary Rails version is missing, click the Install Rails Gem button in the field. Wait until RubyMine downloads all available Rails versions and select the necessary one from the dropdown. Click OK to continue.

    Install rails gem

    If the selected version is not installed yet, RubyMine will install it upon project creation.

  6. In the Database field, select a database you want to use in your application.

  7. If necessary, provide additional Rails options for project creation in the Extra options field.

    For example, you can specify arguments that you will normally use to append the rails new command: --skip-tests to skip creation of test files, --skip-action-mailer to skip Action Mailer files, --skip-action-cable to skip Action Cable files, and so on.

    To get a full list of Rails options compatible with the Rails version in use, run the rails new --help command.

  8. Click Create.

    New Project dialog: Rails API application

Other project types

Angular CLI

Location

Specify The path to the folder where the project-related files will be stored.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

Angular CLI

Select npx --package @angular/cli ng.

Alternatively, for npm version 5.1 and earlier, install the @angular/cli package yourself by running npm install -g @angular/cli in the Terminal Alt+F12. When creating an application, select the folder where the @angular/cli package is stored.

Additional parameters

(Optional) Specify the extra ng new options to pass to Angular CLI.

Bootstrap

Location

Specify The path to the folder where the project-related files will be stored.

Version

Choose the template version to use in your application.

Express

Location

Specify The path to the folder where the project-related files will be stored.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

express-generator

Select the application generator tool with the version to quickly create an application skeleton.

View Engine

Select the template engine that you want to use.

Stylesheet Engine

Select the CSS preprocessor for your project.

HTML5 Boilerplate

Location

Specify The path to the folder where the project-related files will be stored.

Version

Choose the template version to use in your application.

Next.js

Location

Specify The path to the folder where the project-related files will be stored.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

create-react-app

Select npx create-react-app.

Alternatively, for npm version 5.1 and earlier, install the create-react-app package yourself by running npm install --g create-react-app in the Terminal Alt+F12. When creating an application, select the folder where the create-react-app package is stored.

Create TypeScript project

To use TSX instead of JSX, select the Create TypeScript project checkbox. RubyMine will generate .tsx files for your application and a tsconfig.json configuration file.

Node.js

Location

Specify The path to the folder where the project-related files will be stored.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

Package manager

Select the package manager to use in your project (npm, pnpm, or Yarn. For more information, refer to npm, pnpm, and Yarn).

React

Location

Specify The path to the folder where the project-related files will be stored.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

create-react-app

Select npx create-react-app.

Alternatively, for npm version 5.1 and earlier, install the create-react-app package yourself by running npm install --g create-react-app in the Terminal Alt+F12. When creating an application, select the folder where the create-react-app package is stored.

Create TypeScript project

To use TSX instead of JSX, select the Create TypeScript project checkbox. RubyMine will generate .tsx files for your application and a tsconfig.json configuration file.

React Native

Location

Specify The path to the folder where the project-related files will be stored.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

React Native

From the React Native list, select npx --package react-native-cli react-native.

Alternatively, for npm version 5.1 and earlier, install the react-native-cli package yourself by running npm install -g react-native-cli in the Terminal Alt+F12. When creating an application, select the folder where the react-native-cli package is stored.

Vite

Location

Specify The path to the folder where the project-related files will be stored.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

Vite

From the Vite list, select npx create-vite.

Alternatively, for npm version 5.1 and earlier, install the create-vite package yourself by running npm install --g create-vite in the Terminal Alt+F12. When creating an application, select the folder where the create-vite package is stored.

Template

Select the community maintained Vite template that targets the framework you are going to use in your application.

Vue.js

Location

Specify The path to the folder where the project-related files will be stored.

Node interpreter

Specify the Node.js interpreter that you want to use in this project. You can select a configured interpreter from the list or click Add to configure a new one.

If you have no Node.js on your computer, select Download Node.js from the list.

Vue CLI

From the Vue CLI list, select npx --package @vue/cli vue.

Alternatively, for npm version 5.1 and earlier, install the @vue/cli package yourself by running npm install --g @vue/cli in the Terminal Alt+F12. When creating an application, select the folder where the @vue/cli package is stored.

Use the default project setup (babel, elint)

To bootstrap your application with babel and ESLint, select the Use the default project setup checkbox.

Last modified: 12 January 2024