JetBrains Rider 2025.3 Help

Get started ASP.NET Web apps

JetBrains Rider provides first-class support for developing ASP.NET and ASP.NET Core web applications on Windows, macOS, and Linux. This guide outlines the minimal steps required to create and run your first web application.

Prerequisites

Besides having JetBrains Rider on your machine, you only need to install .NET SDK — the latest stable version is recommended. You can verify the SDK installation by opening the Terminal window and running:

dotnet --version

Create a New ASP.NET Project

  1. Launch Rider and click New Solution on the Welcome screen. If Rider is already open, select File | New Solution from the menu.

  2. In the New Solution dialog that opens, select Web under the Project Type on the left.

  3. Fill in basic settings:

    • Solution name — if you are new to .NET, a solution is the typical unit for an independent piece of development, similar to a workspace in most other frameworks.

    • Project name — automatically generated to be the same as the solution name, but you can change it if you plan to have multiple projects in the solution.

    • Solution directory — where to save the solution.

    • Put solution and project in the same directory — you can select this checkbox if you do not plan to add more projects to your solution.

    • Create Git repository — select this checkbox if you want to version your code with Git and use integrated Git features. You can create a Git repository at any time later.

    • Target framework — the latest stable version available on your machine is preselected automatically.

    • Language — we will use C# in this tutorial.

  4. Select a project template. The most popular templates include:

    • Web App (Razor Pages) — page-focused applications with an easy learning curve. We will use it in this tutorial.

    • Web App (Model-View-Controller) — classic MVC pattern, enterprise-like apps.

    • Blazor Web App — interactive web UI with C#.

    • Web API — allows building backend/microservices based on pure REST/HTTP API with no views

  5. Click Create.

JetBrains Rider: New Solution dialog for ASP.NET Web app

Rider generates the necessary files and folders and opens the solution.

Understand project structure

Typical ASP.NET Core projects include:

  • Program.cs — application entry point and middleware pipeline

  • Pages/ — container for Razor .cshtml files representing Web pages

  • appsettings.json — configuration

  • wwwroot/ — static files (CSS, JS, images)

Rider provides navigation, inspections, and refactorings across all these components.

First run

Most project templates include a minimal configuration and basic startup logic, so you can run your project right away by clicking Run Run on the toolbar.

JetBrains Rider: Run a new ASP.NET solution

Rider builds the solution, starts the built-in web server, and opens a new browser tab with the project page.

JetBrains Rider: ASP.NET solution in the browser

To quickly check the relation between the source code of the project and its output, find the source code of the initial web page (pages/index.cshtml), change the page title from Welcome to Hello, click Apply Changes and reload the browser page.

JetBrains Rider: Hot reload

Next steps

Depending on your goals, you can continue learning how the ASP.NET app works by doing one of the following:

  • Set a breakpoint in program.cs and click Debug Debug on the toolbar. When the program stops, explore values of the variables and step through the program to understand how the program is executed.

  • Add a new page — right-click the Pages folder in the Solution Explorer and choose Add | Razor page. For example, if we add a page file About.cshtml, it will be available by the follwoing hyperlink: http://localhost:5227/About

23 January 2026