# Telerik UI for ASP.NET Core Visual Studio Code Integration Overview

The **Telerik UI for ASP.NET Core Productivity Tools** is an extension for [Visual Studio Code](https://code.visualstudio.com/) that enhances the application development experience with Telerik UI for ASP.NET Core.

As its primary advantage, the VS Code extension facilitates the creation of projects through a wizard directly in Visual Studio Code.

## Get Telerik UI for ASP.NET Core Productivity Tools

You can get the extension:

* from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=TelerikInc.aspnetcoretemplatewizard)

* by opening the **Extensions** tab in Visual Studio Code, then searching for **Telerik UI for ASP.NET Core Productivity Tools** and clicking **Install**

## Create a Telerik Project

To create a Telerik-enabled ASP.NET Core project:

1. Press `Ctrl`+`Shift`+`P` in Windows/Linux or `Cmd`+`Shift`+`P` on Mac to open the VSCode extension launcher.

2. Type/Select `Telerik UI for ASP.NET Core Template Wizard: Launch` and press `Enter` to launch the extension.

3. Enter a project name and select the location.

4. Choose whether to start from a [**Blank Project** or use one of the available Telerik project templates](https://www.telerik.com/aspnet-core-ui/documentation/vs-code-integration/introduction#project-templates) as a base:

   ![UI for ASP.NET Core choose Telerik template, project name and location](https://www.telerik.com/aspnet-core-ui/documentation/assets/0c0fee0c09c50abaaa224276eb17daba/project-name-and-location.png)

## Install or Update License Key

If necessary, the Telerik Visual Studio Code extension will notify you about a missing or outdated [license key](https://www.telerik.com/aspnet-core-ui/documentation/installation/activating-your-license/setting-up-your-license), and will install or update it.

## Configure the Project

With the template wizard, you can configure the following project options:

* Project template
* License type
* Target framework
* Tag or HTML Helpers
* Localization
* Visual theme

### Project Templates

The following project templates are available:

<table>
    <colgroup>
        <col width="25%"></col>
        <col></col>
    </colgroup>
    <tbody>
        <tr>
            <th>Project</th>
            <th>Description</th>
        </tr>
        <tr>
            <td><strong>Blank Project</strong></td>
            <td><p>The Blank template has the package references and the client-side resources loaded in the <code>_Layout.cshtml</code> file. It also features the expected <a href="https://docs.telerik.com/aspnet-core/installation/json-serialization">JSON serialization configuration</a> in the <code>Program.cs</code> file. The default editor templates are included in the <code>~Views\Shared\EditorTemplates</code> folder.</p></td>
        </tr>
        <tr>
            <td><strong>Standard</strong></td>
            <td><p>The Standard template features:</p>
                <ul>
                    <li> Everything from the <strong>Blank Project<strong>.</li>
                    <li> A Responsive Panel and Menu in <code>_Layout.cshtml</code>.</li>
                    <li> A PanelBar in <code>Index.cshtml</code>.</li>
                    <li> A TabStrip in <code>Contact.cshtml</code>.</li>
                    <li> An HTML styled with <a href="https://docs.telerik.com/aspnet-core/knowledge-base/cards">Cards</a> in <code>About.cshtml</code>.</li>
                </ul>
            </td>
        </tr>
        <tr>
            <td><strong>The Content Security Policy (CSP)</strong></td>
            <td><p>Content Security Policy (CSP) template features:</p>
                <ul>
                    <li> A Menu in <code>_Layout.cshtml</code>.</li>
                    <li> A Detail Grid with a TabStrip in <code>Index.cshtml</code>.</li>
                    <li> A Child Grid in <code>_Child_Grid.cshtml</code>.</li>
                    <li> A <a href='https://docs.telerik.com/aspnet-core/html-helpers/helper-basics/deferred-initialization#deferring-components-globally' target="_blank">DeferredToScriptFiles</a> setting in <code>Program.cs</code>.
                    </li>
                    <li>
                       A <code>KendoDeferredScripts</code> Middleware in <code>Program.cs</code>.
                    </li>
                </ul>
            </td>
        </tr>
        <tr>
            <td><strong>Grid and Menu</strong></td>
            <td><p>The Grid and Menu template features:</p>
                <ul>
                    <li> Everything from the <strong>Blank Project</strong>.</li>
                    <li> Buttons and Grid in <code>Index.cshtml</code>.</li>
                    <li> A Responsive Panel and Menu in <code>_Layout.cshtml</code>.</li>
                </ul>
            </td>
        </tr>
        <tr>
            <td><strong>Grid Razor Pages</strong></td>
            <td><p>The Grid Razor Pages template includes everything from the <strong>Blank Project</strong>. It features an editable Grid in the <code>Index.cshtml</code> that uses handlers for the CRUD data operations. The <code>AntiForgeryToken</code> is set up, as well.</p></td>
        </tr>
        <tr>
            <td><strong>Dashboard</strong></td>
            <td><p>The Dashboard template features:</p>
                <ul>
                    <li> Everything from the <strong>Blank Project</strong> except the editor templates folder.</li>
                    <li> A TileLayout with Charts and Grids in the <code>Index.cshtml</code>, as well as shared DataSource and dynamically populated templates.</li>
                </ul>
            </td>
        </tr>
        <tr>
            <td><strong>Admin</strong></td>
            <td><p>The Admin is a Razor Pages template configured with <a href="https://docs.telerik.com/aspnet-core/tag-helpers/overview">TagHelpers</a>. It features:</p>
                <ul>
                    <li>Everything from the <strong>Blank Project</strong>.</li>
                    <li>Authentication functionallity (Registration, Login, and Logout) in <code>Areas/Login/Pages</code>.</li>
                    <li>A navigation that is created by using the <a href="https://docs.telerik.com/aspnet-core/tag-helpers/navigation/drawer/overview">Drawer</a> and <a href="https://docs.telerik.com/aspnet-core/tag-helpers/navigation/appbar/overview">AppBar</a> components.</li>
                    <li>A <a href="https://docs.telerik.com/aspnet-core/tag-helpers/layout/tilelayout/overview">TileLayout</a> with <a href="https://docs.telerik.com/aspnet-core/styles-and-layout/cards">Cards</a>, <a href="https://docs.telerik.com/aspnet-core/tag-helpers/gauges/arcgauge/overview">Arc Gauge</a>, <a href="https://docs.telerik.com/aspnet-core/tag-helpers/charts/overview">Chart</a> and <a href="https://docs.telerik.com/aspnet-core/tag-helpers/data-management/grid/overview">Grid</a> in <code>Index.cshtml</code>.</li>
                    <li>A <a href="https://docs.telerik.com/aspnet-core/tag-helpers/layout/tilelayout/overview">TileLayout</a> with a variety of <a href="https://docs.telerik.com/aspnet-core/tag-helpers/charts/overview">Charts</a> and <a href="https://docs.telerik.com/aspnet-core/tag-helpers/gauges/radialgauge/overview">Gauges</a> in <code>Performance.cshtml</code>.</li>
                    <li>A <a href="https://docs.telerik.com/aspnet-core/tag-helpers/layout/tilelayout/overview">TileLayout</a> with <a href="https://docs.telerik.com/aspnet-core/tag-helpers/charts/overview">Bubble Chart</a> and <a href="https://docs.telerik.com/aspnet-core/html-helpers/data-management/listview/overview">ListView</a> with editable <a href="https://docs.telerik.com/aspnet-core/styles-and-layout/cards">Cards</a> in <code>Products.cshtml</code> as well as <a href="https://docs.telerik.com/aspnet-core/tag-helpers/data-management/pager/overview">Pager</a> and search panel.</li>
                    <li>A <a href="https://docs.telerik.com/aspnet-core/tag-helpers/layout/tilelayout/overview">TileLayout</a> with <a href="https://docs.telerik.com/aspnet-core/tag-helpers/layout/form/overview">Form</a> and <a href="https://docs.telerik.com/aspnet-core/tag-helpers/scheduling/calendar/overview">Calendar</a> in <code>Settings.cshtml</code>.</li>
                </ul>
            </td>
        </tr>
    </tbody>
</table>

### License Type

Select the type of your Telerik license (trial or commercial).

![UI for ASP.NET Core choose Telerik license](https://www.telerik.com/aspnet-core-ui/documentation/assets/dbaf081c019c30c3fa0e01b1a59a0875/license-type.png)

### Target Framework

Choose the desired target framework version.

![UI for ASP.NET Core choose target framework](https://www.telerik.com/aspnet-core-ui/documentation/assets/096162187115ffaf1ffe2d49dc5abf9d/target-framewok.png)

### Helper Selection

You can choose if you want the template project to use [HtmlHelpers or TagHelpers](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/helper-basics/overview) version of the components.

![UI for ASP.NET Core HTML/Tag helper options](https://www.telerik.com/aspnet-core-ui/documentation/assets/e61c7fc6d230aa4cd9d453043a731c48/helper-type.png)

### Localization

If you enable the localization option, the language specific files will be copied to `~/wwwroot/lib/kendo-ui/js/messages/` folder. For more information, refer to the [localization documentation](https://www.telerik.com/aspnet-core-ui/documentation/globalization/localization).

![UI for ASP.NET Core enable project localization](https://www.telerik.com/aspnet-core-ui/documentation/assets/6cbdc80c3ef32e0731e923b7739d1204/enable-localization.png)

### Themes

You can add styling to your application by selecting one of the [Kendo UI Sass-Based themes](https://www.telerik.com/aspnet-core-ui/documentation/styles-and-layout/sass-themes/overview) (Default, Bootstrap, Material, Fluent, or Classic) and pick from a variety of [swatches](https://www.telerik.com/aspnet-core-ui/documentation/styles-and-layout/sass-themes/overview#swatch) that come with each theme. When you make your choice, the wizard will add to the `_Layout.cshtml` only these files that are required by the selected theme.

![UI for ASP.NET Core Theme options](https://www.telerik.com/aspnet-core-ui/documentation/assets/42c7154d002986ddf272e1bb0dbda56c/themes.png)

## Run the Project

After configuring the settings of the project, click **Create Project** to start creating the new UI for ASP.NET Core application.

To run the project:

1. Open the terminal and navigate to the project folder.
2. Execute `dotnet run` and open the link in the console output in your browser.

Alternatively, open the solution file with Visual Studio and build the application. Once the NuGet packages get restored and the build passes, you will have your Telerik UI for ASP.NET Core project up and running.

## See Also

* [Troubleshooting the Telerik UI for ASP.NET Core Productivity Tools Extension](https://www.telerik.com/aspnet-core-ui/documentation/knowledge-base/vs-code-extension-issues)
