Bootstrap Blazor enterprise-level UI component library

Server-Side Blazor Installation Tutorial

Environmental preparation

Make sure the system is installed

visual studio 2019 or visual studio 2022
net5 or net6

BootstrapBlazor Currently supported net5/net6

Create a project using the BootstrapBlazor Project Template extension

you can pass [portal] After downloading and installing the extension, create a project through the extension

Create a project with Visual Studio 1

Step 1. Create a project

1. Open Visual Studio 2022

2. Create a new project

3. choose Blazor App and click Next step, Choose a name and location for the project, then click Create

4. choose Blazor Server Appproject type, then click Create

Step 2. Add the BootstrapBlazor component to the existing project

1. pass nuget.org source search BootstrapBlazor

Right click on the project in the solution and select Manage Nuget Packages

dotnet add package BootstrapBlazor --version 7.4.4-beta01

2. Install the BootstrapBlazor package

3. Add stylesheet file

Add a theme style sheet to the host file

~/Pages/_Host.cshtml .NET5
~/Pages/_Layout.cshtml .NET6

Tips

If you use the Blazor App template to create a project, please remove the default Bootstrap style link <link rel='stylesheet' href='css/bootstrap/bootstrap.min.css' />. Install FontAwesome related resources by yourself or get the nuget package BootstrapBlazor.FontAwesome

<head>
    ...

    <!-- Need to reference BootstrapBlazor.FontAwesome package !-->
    <link href="_content/BootstrapBlazor.FontAwesome/css/font-awesome.min.css" rel="stylesheet">
    <link href="_content/BootstrapBlazor/css/bootstrap.blazor.bundle.min.css" rel="stylesheet">

    ...
    <link href="css/site.css" rel="stylesheet">
    <link href="BlazorApp1.styles.css" rel="stylesheet">
</head>

4. Add Javascript files

~/Pages/_Host.cshtml .NET5
~/Pages/_Layout.cshtml .NET6

<body>
    ...
    <!-- add code !-->
    <script src="_content/BootstrapBlazor/js/bootstrap.blazor.bundle.min.js"></script>
    ...
    <script src="_framework/blazor.server.js"></script>
</body>

5. Register the BootstrapBlazor service

Starup.cs .NET5
Program.cs .NET6

Startup.cs

namespace MyBlazorAppName
{
    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddServerSideBlazor();

            // Add this line of code
            services.AddBootstrapBlazor();
        }
    }
}

Program.cs

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddServerSideBlazor();

// Add this line of code
builder.Services.AddBootstrapBlazor();

var app = builder.Build();
//more code may be present here

6. Add namespace reference

Add the following to ~/_Imports.razor file so that Razor Components are recognized in the file

@using BootstrapBlazor.Components

7. Increase BootstrapBlazorRoot component to ~/App.razor in file

<BootstrapBlazorRoot>
    <Router AppAssembly="@typeof(App).Assembly">
        <Found Context="routeData">
            <PageTitle>Title</PageTitle>
            <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
            <FocusOnNavigate RouteData="@routeData" Selector="h1" />
        </Found>
        <NotFound>
            <PageTitle>Not found</PageTitle>
            <LayoutView Layout="@typeof(MainLayout)">
                <p> under development ...</p>
            </LayoutView>
        </NotFound>
    </Router>
</BootstrapBlazorRoot>

Step 3. Use components in the page

The last step is to use in the page BootstrapBlazor component and run it in the browser. E.g：

1. add one to the page Button button

<Button Color="Color.Primary" Icon="fa-solid fa-font-awesome" Text="test" />

2. exist Visual studio 2022 middle F5 run the application