Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions _contentTemplates/common/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

#prerequisites-download

* To successfully complete the steps in this tutorial, make sure you have an <a href="https://visualstudio.microsoft.com/vs/" target="_blank">up-to-date Visual Studio</a>, which is compatible with the .NET version of your choice. If you are not using Visual Studio, some of the steps require using the .NET CLI or editing files manually. In this case, also refer to the [Workflow Details tutorial](slug://getting-started/what-you-need).
* To successfully complete the steps in this tutorial, make sure you have an <a href="https://visualstudio.microsoft.com/vs/" target="_blank">up-to-date Visual Studio</a>, which is compatible with the [supported .NET version](slug://system-requirements#supported-net-versions) of your choice. If you are not using Visual Studio, some of the steps require using the .NET CLI or editing files manually. In this case, also refer to the [Workflow Details tutorial](slug://getting-started/what-you-need).

* To learn more about the compatibility of the Telerik UI for Blazor components with different browser and .NET versions, see the [system requirements](slug://system-requirements).

Expand Down Expand Up @@ -77,7 +77,7 @@ In this tutorial, you will use the [Telerik NuGet feed](slug://installation/nuge

![Telerik Blazor app in the browser](images/blazor-app-in-browser.png)

Well done! Now you have your first Telerik UI for Blazor component running in your Blazor app.
Well done! Now you have your first Telerik UI for Blazor component running in your Blazor app, showcasing the power of front-end development with Blazor.

@[template](/_contentTemplates/common/get-started.md#next-steps-after-getting-started)

Expand Down
13 changes: 7 additions & 6 deletions getting-started/web-app.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,17 @@
---
title: Blazor Web App
page_title: First Steps with Blazor Web Apps and Telerik UI for Blazor
description: Make your first steps with Telerik UI for Blazor and build a Web App that runs the UI for Blazor components.
page_title: First Steps with Blazor Web App and Telerik UI
meta_title: First Steps with Blazor Web App | Telerik UI for Blazor.
description: Learn how to use the Telerik UI for Blazor components in a Blazor Web App project template for .NET 8 and .NET 9.
slug: getting-started/web-app
tags: get,started,first,steps,web,app,template
published: true
position: 5
---

# First Steps with UI for Blazor in a Web App
# First Steps with Blazor Web App and Telerik UI

This article explains how to use the Telerik UI for Blazor components in a <a href="https://learn.microsoft.com/en-us/aspnet/core/blazor/project-structure?view=aspnetcore-9.0#blazor-web-app" target="_blank">Blazor Web App</a> project template that exists for .NET 8 and 9. You will create a new application from scratch, learn how to add the UI for Blazor components to a project, and finally, add a UI component to a view.
This article explains how to use the Telerik UI for Blazor components in a Blazor Web App project template that exists for .NET 8 and 9. You will create a new application from scratch, learn how to add the UI for Blazor components to a project, and finally, add a UI component to a view.

@[template](/_contentTemplates/common/get-started.md#prerequisites-tip)

Expand All @@ -28,15 +29,15 @@ This article explains how to use the Telerik UI for Blazor components in a <a hr

1. Click **Create**.

> Most Telerik Blazor components require interactivity. They will not respond to user actions and the Blazor framework will not refresh their UI in static render mode. Telerik Blazor components with JavaScript rendering (Barcodes, Charts, Gauges, Maps, and QR Codes) will not render in static render mode at all.
> Each component in a Blazor Web App utilizes a render mode to define its hosting model, determine its rendering location, and specify whether it is interactive. Most Telerik Blazor components require interactivity. They will not respond to user actions and the Blazor framework will not refresh their UI in [Static server-side rendering mode (static SSR)](https://learn.microsoft.com/en-us/aspnet/core/blazor/components/render-modes?view=aspnetcore-9.0#static-server-side-rendering-static-ssr). Telerik Blazor components with JavaScript rendering (Barcodes, Charts, Gauges, Maps, and QR Codes) will not render in static SSR at all.
>
> The `Account` section in the Blazor Web App template with identity is static by design. Most Telerik Blazor components cannot work in this section.

@[template](/_contentTemplates/common/get-started.md#add-nuget-feed)

## Step 3: Install the Telerik UI for Blazor Components

1. Right-click each project that will use Telerik Blazor components, and select **Manage NuGet Packages**.
1. To include the Telerik component library, right-click each project that will use Telerik Blazor components, and select **Manage NuGet Packages**.

* Apps with interactive Server render mode need the Telerik Nuget package in the server project.
* Apps with global interactive Auto or WebAssembly render mode need the Telerik NuGet package in the client project.
Expand Down
2 changes: 1 addition & 1 deletion knowledge-base/common-telerik-themes-libman.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ res_type: kb

This KB article answers the following questions:

* How to use LibMan to add Telerik themes to your Telerik Blazor app.
* How to use LibMan to add [Telerik themes](slug://styling-and-themes/overview) to your Telerik Blazor app.
* How to update local themes in `wwwroot` automatically when a new version is available.

[LibMan](https://learn.microsoft.com/en-us/aspnet/core/client-side/libman/) is a client-side dependency manager, which is included in ASP.NET Core. You can use it to automatically download a Telerik theme to the `wwwroot` folder of your app, instead of using [static NuGet assets](slug://themes-overview#loading-themes-from-the-nuget-package) or [Telerik CDN](slug://common-features-cdn).
Expand Down
8 changes: 4 additions & 4 deletions styling-and-themes/overview.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Themes Overview
page_title: Themes Overview
description: The UI for Blazor suite comes with a set of built-in themes that you can choose from. Bootstrap and Material themes are also included.
description: Telerik comes with built-in CSS Blazor themes that control the visual appearance of your UI components.
slug: themes-overview
tags: telerik,blazor,theme,built-in
published: True
Expand All @@ -15,7 +15,7 @@ Telerik UI for Blazor comes with a set of built-in CSS themes that control the v

>caption In This Article

* [Definitions for *theme* and *swatch*](#basics) and [how the themes relate to the components](#integration-with-the-telerik-components)
* [Definitions for *theme* and *swatch*](#basics) and [how the themes in Blazor relate to the components](#integration-with-the-telerik-components)
* [All built-in theme and swatch names](#built-in-themes) and how to [preview them](#comparing-themes-and-swatches)
* How to [register a theme in your app](#using-a-theme)
* How to [ensure compatibility between the Telerik components and the theme version](#compatibility-and-maintenance)
Expand Down Expand Up @@ -63,12 +63,12 @@ There are three ways to load a Telerik theme, in terms of physical CSS file loca
* Load a CSS theme as a local file in the `wwwroot` folder in the Blazor app. This option is relevant to the following cases:
* When using [custom themes](slug://themes-customize).
* When [creating](slug://getting-started-vs-integration-new-project) or [converting](slug://getting-started-vs-integration-convert-project) Telerik Blazor apps with the [Telerik UI for Blazor Visual Studio extension](slug://getting-started-vs-integration-overview).
* When using themes from the Telerik UI for Blazor [MSI installer](slug://installation/msi) or [ZIP archive](slug://installation/zip). The CSS files are in the `swatches` folder.
* When using themes in Blazor from the Telerik UI for Blazor [MSI installer](slug://installation/msi) or [ZIP archive](slug://installation/zip). The CSS files are in the `swatches` folder.
* When using [LibMan](slug://common-kb-telerik-themes-libman) or <a href="https://www.telerik.com/design-system/docs/themes/get-started/installation/" target="_blank">npm</a> to obtain a specific Telerik theme version. In this case, you can use all built-in theme swatches.

> The Blazor app must load only one Telerik theme file at a time. Upgrade the theme with every Telerik UI for Blazor version upgrade, unless you are loading the theme as a static NuGet asset.

### Loading Themes from the NuGet Package
### Loading Themes in Blazor from the NuGet Package

The easiest way to load a Telerik theme in a Blazor app is to reference a static asset from the NuGet package. The .NET SDK will copy the CSS file to the output folder during build automatically. Static assets provide the following benefits:

Expand Down
Loading