EnvInfo.DotVVM 4.2.6

EnvInfo

EnvInfo is a collection of Mvc/RazorPages tag helpers and DotVVM controls that provides environment information for your application. It is useful for identifing between different environments like Development, Staging, and Production.

Features

• display environment name (e.g., DEV, STAG, PROD) based on the current environment
• ability to change environment name or visility using configuration
• display Bootstrap breakpoint name (e.g., xs, sm, md, lg, xl) based on the current screen width
• ability to change predefined styles using custom css

Usage

Install nuget package for each UI framework you use in your project. Then register required service in Program.cs or Startup.cs file

builder.Services.AddEnvInfo();

By default, the Name is derived from the environment name and Visible is set to true for the development environment. Then tries to load the configuration section EnvInfo and set the values.

"EnvInfo": {
    "Name": "ALPHA",
    "Visible": true
}

You can provide custom configuration section.

services.AddEnvInfo(Configuration.GetSection("App.EnvInfo"));

Or you can override Name directly in code

builder.Services.AddEnvInfo("APLHA");

Or simply provide custom configuration object

services.AddEnvInfo(new EnvInfoOptions
{
    Name = "CUSTOM",
    Visible = true
});

MVC / Razor Pages

Add tag helpers import to _ViewImports.cshtml file

@addTagHelper *, EnvInfo.Mvc

Below is basic usage snippet that displays environment name. Place it before </body> element in your .cshtml file

<env-info>
    <env-name />
</env-info>

Inside env-info tag you can use any html element or any of predefined tag helpers:

• <env-name /> - displays environment name
• <bs4-breakpoints /> - displays Bootstrap 4 breakpoint name
• <bs5-breakpoints /> - displays Bootstrap 5 breakpoint name
• <bs-breakpoints breakpoints="xxs xs sm md lg xl xxl 3xl" /> - displays custom Bootstrap breakpoint name

Below is an example of usage with custom html and predefined tag helper

<env-info>
    <env-name />
    <span>|</span>
    <bs4-breakpoints />
</env-info>

DotVVM

Add control registration to Configure method in DotvvmStartup file.

config.AddEnvInfoConfiguration();

Below is basic usage snippet that displays environment name. Place it before </body> element in your .dotmaster or .dothtml file

<dot:EnvInfo>
    <dot:EnvName />
</dot:EnvInfo>

Inside env-info tag you can use any html element or any of predefined controls:

• <dot:EnvName /> - displays environment name
• <dot:Bootstrap4Breakpoints /> - displays Bootstrap 4 breakpoint name
• <dot:Bootstrap5Breakpoints /> - displays Bootstrap 5 breakpoint name
• <dot:BootstrapBreakpoints Breakpoints="xxs xs sm md lg xl xxl 3xl" /> - displays custom Bootstrap breakpoint name

Below is an example of usage with custom html and predefined control

<dot:EnvInfo>
    <dot:EnvName />
    <span>|</span>
    <dot:Bootstrap4Breakpoints />
</dot:EnvInfo>