# 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](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/latest-version-retrieval).

## 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](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details#css-theme).
* [JS Interop file](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details#javascript-file).

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

* [Required `@using` directives](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details#namespaces) to the `~/_Imports.razor` file.
* `TelerikLayout.razor` component containing the [`TelerikRootComponent`](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details#telerikrootcomponent).
* Registration of the [Telerik services](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details#service).

## Getting the Wizard

To use the **Create New Telerik Project** wizard, install the Telerik UI for Blazor Visual Studio Extension. You can get the extension from:

* The Visual Studio Marketplace (for [Visual Studio 2022 for Windows](https://marketplace.visualstudio.com/items?itemName=TelerikInc.ProgressTelerikBlazorVSExtensions) and [Visual Studio 2019 for Windows](https://marketplace.visualstudio.com/items?itemName=TelerikInc.TelerikBlazorVSExtensions)).
* The [Telerik UI for Blazor automated installer](https://www.telerik.com/blazor-ui/documentation/installation/automated) (for Windows and Mac).
* Your [Telerik.com account](https://www.telerik.com/account/product-download?product=BLAZOR) (for Mac only). Download the `.mpack` file and use the "Install from file..." button on the Visual Studio Extensions dialog.

> Our extention for Visual Studio for Mac will be discontinued in 2024 [after Visual Studio for Mac is discontinued](https://learn.microsoft.com/en-us/visualstudio/mac/what-happened-to-vs-for-mac).

## Starting the Wizard

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

* [The Extensions Menu](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/new-project-wizard#extensions-menu)
* [The VS Extensions Menu](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/new-project-wizard#project-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.

   ![Start the New Project Wizard](https://www.telerik.com/blazor-ui/documentation/assets/85d1d112ef866f331b1819cf1b6653fa/vs-ext-create-new-project-entry.png)

## 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](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/new-project-wizard#step-1-select-initial-project-configuration).
2. [Select Project Template](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/new-project-wizard#step-2-select-project-template).
3. [Select a visual theme](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/new-project-wizard#step-3-select-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](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details#css-theme-and-javascript-files) or from the [Telerik CDN](https://www.telerik.com/blazor-ui/documentation/common-features/cdn). Note that this can affect the future [upgrade process of the theme](https://www.telerik.com/blazor-ui/documentation/upgrade/overview#upgrade-process).
  * Enable [localization](https://www.telerik.com/blazor-ui/documentation/globalization/localization).
  * Use [font icons](https://www.telerik.com/blazor-ui/documentation/common-features/icons) instead of the default SVG icons.
* Location from where the application will get the Telerik UI for Blazor package—[remote NuGet feed](https://www.telerik.com/blazor-ui/documentation/installation/nuget) 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`](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details).

> The **Admin**, **Dashboard**, **CRUD**, **Form**, and **Chart** templates were deprecated. Their source code is available in the [`blazor-ui` repo](https://github.com/telerik/blazor-ui/tree/master/common/legacy-project-templates).

### Step 3: Select Theme

Finally, you can apply one of the available [themes](https://www.telerik.com/blazor-ui/documentation/styling-and-themes/overview) 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](https://www.telerik.com/blazor-ui/documentation/installation/license-key), and will install or update it.

## See Also

* [Telerik UI for Blazor Visual Studio Extensions Overview](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/introduction)
* [Downloading the Latest Telerik UI for Blazor Versions](https://www.telerik.com/blazor-ui/documentation/installation/vs-integration/latest-version-retrieval)
* [Getting Started with Telerik UI for Blazor](https://www.telerik.com/blazor-ui/documentation/getting-started/web-app)
* [Workflow for Using the UI Components for Blazor](https://www.telerik.com/blazor-ui/documentation/getting-started/workflow-details)
