ASP.NET Core MVC / Razor Pages: The Basic Theme

The Basic Theme is a theme implementation for the ASP.NET Core MVC / Razor Pages UI. It is a minimalist theme that doesn't add any styling on top of the plain Bootstrap. You can take the Basic Theme as the base theme and build your own theme or styling on top of it. See the Customization section.

The Basic Theme has RTL (Right-to-Left language) support.

If you are looking for a professional, enterprise ready theme, you can check the Lepton Theme, which is a part of the ABP.

See the Theming document to learn about themes.

Installation

If you need to manually this theme, follow the steps below:

  • Install the Volo.Abp.AspNetCore.Mvc.UI.Theme.Basic NuGet package to your web project.
  • Add AbpAspNetCoreMvcUiBasicThemeModule into the [DependsOn(...)] attribute for your module class in the web project.
  • Install the @abp/aspnetcore.mvc.ui.theme.basic NPM package to your web project (e.g. npm install @abp/aspnetcore.mvc.ui.theme.basic or yarn add @abp/aspnetcore.mvc.ui.theme.basic).
  • Run abp install-libs command in a command line terminal in the web project's folder.

Layouts

The Basic Theme implements the standard layouts. All the layouts implement the following parts;

The Application Layout

basic-theme-application-layout

Application Layout implements the following parts, in addition to the common parts mentioned above;

  • Branding
  • Main Menu
  • Main Toolbar with Language Selection & User Menu

The Account Layout

basic-theme-account-layout

Application Layout implements the following parts, in addition to the common parts mentioned above;

  • Branding
  • Main Menu
  • Main Toolbar with Language Selection & User Menu
  • Tenant Switch Area

Empty Layout

Empty layout is empty, as its name stands for. However, it implements the common parts mentioned above.

Customization

You have two options two customize this theme:

Overriding Styles/Components

In this approach, you continue to use the the theme as NuGet and NPM packages and customize the parts you need to. There are several ways to customize it;

Override the Styles

  1. Create a CSS file in the wwwroot folder of your project:

example-global-styles

  1. Add the style file to the global bundle, in the ConfigureServices method of your module:
Configure<AbpBundlingOptions>(options =>
{
    options.StyleBundles.Configure(BasicThemeBundles.Styles.Global, bundle =>
    {
        bundle.AddFiles("/styles/global-styles.css");
    });
});

Override the Components

See the User Interface Customization Guide to learn how you can replace components, customize and extend the user interface.

Copy & Customize

You can run the following ABP CLI command in Web project directory to copy the source code to your solution:

abp add-module Volo.BasicTheme --with-source-code --add-to-solution-file


Or, you can download the source code of the Basic Theme, manually copy the project content into your solution, re-arrange the package/module dependencies (see the Installation section above to understand how it was installed to the project) and freely customize the theme based on your application requirements.

See Also

Contributors


Last updated: July 31, 2024 Edit this page on GitHub

Was this page helpful?

Please make a selection.

To help us improve, please share your reason for the negative feedback in the field below.

Please enter a note.

Thank you for your valuable feedback!

Please note that although we cannot respond to feedback, our team will use your comments to improve the experience.

In this document
Community Talks

Building Modular Monolith Applications Using .NET and ABP Framework

17 Oct, 17:00
Online
Watch the Event
Mastering ABP Framework Book
Mastering ABP Framework

This book will help you gain a complete understanding of the framework and modern web application development techniques.

Learn More