new-project-wizard.md

title	page_title	description	slug	position
Creating New Projects	Creating New Project - Visual Studio Integration	Learn how to create a new Telerik UI for Blazor project with the supported Visual Studio templates.	getting-started-vs-integration-new-project	2

Creating New Projects

This article demonstrates how to use the Telerik Visual Studio extensions to create a new project that is pre-configured for the Progress® Telerik® UI for Blazor components.

To create a new Telerik UI for Blazor application, use the Create New Project wizard. The wizard detects all installed versions of Telerik UI for Blazor and lists them in the Version dropdown for selection. To make sure the components are up-to-date, you can also get the latest version.

How It Works

The Create New Project wizard automates a set of steps that you otherwise must perform manually.

The wizard adds the following client assets to your project:

• Telerik stylesheet.
• JS Interop file.

The wizard also configures the project to use the Telerik UI for Blazor components by adding the following utilities:

• Required @using directives to the ~/_Imports.razor file.
• TelerikLayout.razor component containing the TelerikRootComponent.
• Registration of the Telerik services.

Getting the Wizard

To use the Create New Telerik Project wizard, install the Telerik UI for Blazor Visual Studio Extension. @template

Starting the Wizard

To start the wizard, use either of the following options:

• The Extensions Menu
• The VS Extensions Menu

Extensions Menu

1. Open the Extensions menu.
2. Click Telerik > Telerik UI for Blazor > Create New Project.
3. Follow the instructions.

Project Menu

1. Click File > New > Project.
2. Find and click the Telerik C# Blazor Application option (you can use the search, or filter by Blazor templates).
3. Follow the instructions.

Using the Wizard

In the order of their appearance, the Create New Project wizard presents several screens with options that will assist you to configure your new app.

After you select the Create New Project option from the Extensions menu, Visual Studio opens a Configure your new project window where you can set the location and the name for your project.

Clicking the Create button in this window opens the wizard and you will go through the following steps:

1. Select Initial Project Configuration.
2. Select Project Template.
3. Select a visual theme.

Step 1: Select Initial Project Configuration

In this screen, you can choose:

• Target .NET framework
• Hosting model—the options vary depending on the selected target framework.
• Configure additional project settings like:
  • Load the required Telerik UI stylesheet and JS Interop file as static assets or from the Telerik CDN. Note that this can affect the future upgrade process of the theme.
  • Enable localization.
  • Use font icons instead of the default SVG icons.
• Location from where the application will get the Telerik UI for Blazor package—remote NuGet feed or local files.
• Telerik UI for Blazor version.

Step 2: Select Project Template

The Create New Project wizard generates a project that is based on the Microsoft template. The app includes some Telerik UI components and the required NuGet package reference, static assets, localization service, and the TelerikRootComponent.

The Admin, Dashboard, CRUD, Form, and Chart templates were deprecated. Their source code is available in the blazor-ui repo.

Step 3: Select Theme

Finally, you can apply one of the available themes to your project.

Step 4: Install or Update License Key

If necessary, the Telerik Visual Studio extension will notify you about a missing or outdated license key, and will install or update it.

See Also

• Telerik UI for Blazor Visual Studio Extensions Overview
• Downloading the Latest Telerik UI for Blazor Versions
• Getting Started with Client-Side Apps
• Getting Started with Server-Side Apps
• Workflow for Using the UI Components for Blazor