# Create a new project

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/ruby/2026.3/llms.txt).

> **Note:**
> This section describes the functionality available out of the box. If you are using a framework plugin, refer to the corresponding documentation section.

## New empty project

This is a basic project intended for pure Ruby programming.

Procedure:

1. Launch RubyMine.

To start a new project, do one of the following:

* Click `New | Project` on the RubyMine Home screen.

* Select `File | New | Project` from the main menu.

* If you already have a project open, click the Project widget in the main window header and select New Project. ![Create a new project using the Project widget](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new_project_from_widget.png)

2. From the list on the left, select Empty Project.

3. In the Name field, type a name of a project.

4. In the Location field, type or select a path to the project location.

5. In the Interpreter field, select the [Ruby interpreter](configuring-language-interpreter.html) that you want to use in your project.

6. Click Create.

![Creating a new empty project](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new-empty-project.png)

## 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.

Procedure:

1. Launch RubyMine.

To start a new project, do one of the following:

* Click `New | Project` on the RubyMine Home screen.

* Select `File | New | Project` from the main menu.

* If you already have a project open, click the Project widget in the main window header and select New Project. ![Create a new project using the Project widget](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new_project_from_widget.png)

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](configuring-language-interpreter.html) that you want to use in your project.

5. Select the [testing framework](testing-frameworks.html#supported_frameworks) 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](https://www.contributor-covenant.org/version/2/0/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](https://resources.jetbrains.com/help/img/idea/2026.3/rm_create_gem_new_project_dialog.png)

## New Rails project

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

Rails Application:

Procedure:

1. Launch RubyMine.

To start a new project, do one of the following:

* Click `New | Project` on the RubyMine Home screen.

* Select `File | New | Project` from the main menu.

* If you already have a project open, click the Project widget in the main window header and select New Project. ![Create a new project using the Project widget](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new_project_from_widget.png)

2. From the list on the left, select Application in the Rails group.

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

> **Note:**
> RubyMine validates the Name field and has the following naming restrictions:
>
>
>
> * The project name can only contain Latin characters, spaces, dots, hyphens, and underscores.
>
> * The project name must not start with a number.
>
> * The project name must not be a reserved constant name or a reserved keyword: "application", "destroy", "test", "plugin", "Rails", or "rails".

4. In the Interpreter field, select the [Ruby interpreter](configuring-language-interpreter.html) 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 interpreter or the necessary Rails version is missing, click ![the Install Rails Gem button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 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](https://resources.jetbrains.com/help/img/idea/2026.3/rm_install_rails_gem_dialog.png)

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](https://guides.rubyonrails.org/command_line.html#rails-new) 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.

> **Tip:**
> If you're using Rails 7 and later, you can select a CSS framework when creating your application. For this purpose, use the `--css` Rails option. For example, `--css=tailwind`.

9. Click Create.

![New Project dialog: Rails application](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new_project_dialog_rails.png)

Rails Mountable Engine:

Procedure:

1. Launch RubyMine.

To start a new project, do one of the following:

* Click `New | Project` on the RubyMine Home screen.

* Select `File | New | Project` from the main menu.

* If you already have a project open, click the Project widget in the main window header and select New Project. ![Create a new project using the Project widget](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new_project_from_widget.png)

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.

> **Note:**
> RubyMine validates the Name field and has the following naming restrictions:
>
>
>
> * The project name can only contain Latin characters, spaces, dots, hyphens, and underscores.
>
> * The project name must not start with a number.
>
> * The project name must not be a reserved constant name or a reserved keyword: "application", "destroy", "test", "plugin", "Rails", or "rails".

4. In the Interpreter field, select the [Ruby interpreter](configuring-language-interpreter.html) 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 interpreter or the necessary Rails version is missing, click ![the Install Rails Gem button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 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](https://resources.jetbrains.com/help/img/idea/2026.3/rm_install_rails_gem_dialog.png)

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](https://guides.rubyonrails.org/command_line.html#rails-new) 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.

> **Tip:**
> If you're using Rails 7 and later, you can select a CSS framework when creating your application. For this purpose, use the `--css` Rails option. For example, `--css=tailwind`.

8. Click Create.

![New Project dialog: Rails application](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new_rails_mountable_engine.png)

Rails API:

Procedure:

1. Launch RubyMine.

To start a new project, do one of the following:

* Click `New | Project` on the RubyMine Home screen.

* Select `File | New | Project` from the main menu.

* If you already have a project open, click the Project widget in the main window header and select New Project. ![Create a new project using the Project widget](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new_project_from_widget.png)

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.

> **Note:**
> RubyMine validates the Name field and has the following naming restrictions:
>
>
>
> * The project name can only contain Latin characters, spaces, dots, hyphens, and underscores.
>
> * The project name must not start with a number.
>
> * The project name must not be a reserved constant name or a reserved keyword: "application", "destroy", "test", "plugin", "Rails", or "rails".

4. In the Interpreter field, select the [Ruby interpreter](configuring-language-interpreter.html) 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 interpreter or the necessary Rails version is missing, click ![the Install Rails Gem button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 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](https://resources.jetbrains.com/help/img/idea/2026.3/rm_install_rails_gem_dialog.png)

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](https://guides.rubyonrails.org/command_line.html#rails-new) 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.

> **Tip:**
> If you're using Rails 7 and later, you can select a CSS framework when creating your application. For this purpose, use the `--css` Rails option. For example, `--css=tailwind`.

8. Click Create.

![New Project dialog: Rails API application](https://resources.jetbrains.com/help/img/idea/2026.3/rm_new_rails_api.png)

## Other project types

### Angular CLI

| Location |     Specify the path to the folder where the project-related files will be stored.   |
| Node runtime | Specify the Node.js runtime that you want to use in this project. You can select a configured runtime 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` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (TextMate), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)). When creating an application, select the folder where the `@angular/cli` package is stored.    |
| Additional parameters | (Optional) Specify the extra [ng new options](https://github.com/angular/angular-cli/wiki/new) 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

> **Tip:**
> For more information, refer to [Node.js](developing-node-js-applications.html).

| Location |     Specify the path to the folder where the project-related files will be stored.   |
| Node runtime | Specify the Node.js runtime that you want to use in this project. You can select a configured runtime 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](http://expressjs.com/guide/using-template-engines.html) 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

> **Note:**
> Learn how to create a Next.js project in RubyMine: [Create a new Next.js application](next.html#create_new_next_js_app).

| Location |     Specify the path to the folder where the project-related files will be stored.   |
| Node runtime | Specify the Node.js runtime that you want to use in this project. You can select a configured runtime 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 CLI |     Select the generator to use.         * Accept the default `[npx create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite)` to have your development environment preconfigured for using Vite.    * Select `[npx create-react-app](https://github.com/facebook/create-react-app)` to have your development environment preconfigured for using webpack, Babel, and ESLint.    * To use a custom previously downloaded generator, click Select and specify the path to the generator in the dialog that opens.     ![Create React pp - select a generator](https://resources.jetbrains.com/help/img/idea/2026.3/react_create_project_select_generator.png)                                   > **Note:** > The recommended way to start a new React single page application is the [create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite) package, which RubyMine downloads and runs for you using [npx](https://www.npmjs.com/package/npx). As a result, your development environment is preconfigured to use Vite with React and TypeScript, learn more from the [Vite > official website](https://blog.logrocket.com/build-react-typescript-app-vite/#benefits-using-react-vite).    |
| 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

> **Note:**
> Learn how to create a Node.js project in RubyMine: [Creating a Node.js application](developing-node-js-applications.html#ws_node_quick_start).

| Location |     Specify the path to the folder where the project-related files will be stored.  |
| Node runtime | Specify the Node.js runtime that you want to use in this project. You can select a configured runtime 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](http://npmjs.org/), [pnpm](https://pnpm.io/), or [Yarn](https://yarnpkg.com/en/). For more information, refer to [npm, pnpm, and Yarn](installing-and-removing-external-software-using-node-package-manager.html)). |

### React

> **Note:**
> The recommended way to start a new React single page application is the [create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite) package, which RubyMine downloads and runs for you using [npx](https://www.npmjs.com/package/npx). As a result, your development environment is preconfigured to use Vite with React and TypeScript, learn more from the [Vite
> official website](https://blog.logrocket.com/build-react-typescript-app-vite/#benefits-using-react-vite).

| Location |     Specify the path to the folder where the project-related files will be stored.   |
| Node runtime | Specify the Node.js runtime that you want to use in this project. You can select a configured runtime 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 CLI |     Select the generator to use.         * Accept the default `[npx create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite)` to have your development environment preconfigured for using Vite.    * Select `[npx create-react-app](https://github.com/facebook/create-react-app)` to have your development environment preconfigured for using webpack, Babel, and ESLint.    * To use a custom previously downloaded generator, click Select and specify the path to the generator in the dialog that opens.     ![Create React pp - select a generator](https://resources.jetbrains.com/help/img/idea/2026.3/react_create_project_select_generator.png)                                   > **Note:** > The recommended way to start a new React single page application is the [create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite) package, which RubyMine downloads and runs for you using [npx](https://www.npmjs.com/package/npx). As a result, your development environment is preconfigured to use Vite with React and TypeScript, learn more from the [Vite > official website](https://blog.logrocket.com/build-react-typescript-app-vite/#benefits-using-react-vite).    |
| 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

> **Note:**
> Learn how to create a React Native project in RubyMine: [Creating a new React Native application](react-native.html#create_new_react_native_app).

| Location |     Specify the path to the folder where the project-related files will be stored.   |
| Node runtime | Specify the Node.js runtime that you want to use in this project. You can select a configured runtime 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` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (TextMate), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)). When creating an application, select the folder where the `react-native-cli` package is stored.     |

### Vite

> **Note:**
> Learn how to create a Vite project in RubyMine: [Create a new Vite application](vite.html#create_new_vite_app).

| Location |     Specify the path to the folder where the project-related files will be stored.  |
| Node runtime | Specify the Node.js runtime that you want to use in this project. You can select a configured runtime 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` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (TextMate), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)). When creating an application, select the folder where the `create-vite` package is stored.      |
| Template |  Select the [community maintained                             Vite template](https://github.com/vitejs/awesome-vite#templates) that targets the framework you are going to use in your application.  |

### Vue.js

> **Note:**
> Learn how to create a Vue.js project in RubyMine: [Create a new Vue.js application](vue-js.html#ws_vue_create_new_app).

| Location |     Specify the path to the folder where the project-related files will be stored.  |
| Node runtime | Specify the Node.js runtime that you want to use in this project. You can select a configured runtime 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` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (TextMate), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)). 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](https://babeljs.io/docs/en/) and [ESLint](https://eslint.org/), select the Use the default project setup checkbox.   |

