Configuration

CssFrameworkSettings carries every knob MonorailCSS exposes. Most of them — theme, custom utilities, applies, prose — are rich data structures covered later. Two are simple booleans you'll usually decide once, on day one.

Important

Important = true emits every generated declaration with !important. The use case is narrow: MonorailCSS is being layered on top of another stylesheet that already wins specificity wars, and you can't reorder the cascade. In greenfield projects keep this false (the default) and let normal cascade rules do the work.

public static CssFramework Build()
{
    return new CssFramework(new CssFrameworkSettings
    {
        Theme = new ThemeModel(),
        Important = true,
    });
}

If you only need !important on a few utilities, use Tailwind's per-class ! syntax instead — either trailing (bg-red-500!) or leading (!bg-red-500).

Preflight

IncludePreflight controls whether MonorailCSS emits its base reset styles — the rules that normalize browser defaults for headings, lists, form elements, and so on. The default is true, which is what you want for a standalone application.

Switch it off when MonorailCSS is generating just a slice of CSS that ships alongside another framework's reset (Bootstrap, an existing design system, a CMS theme), so you don't double-reset margins and form controls.

public static CssFramework Build()
{
    return new CssFramework(new CssFrameworkSettings
    {
        Theme = new ThemeModel(),
        IncludePreflight = false,
    });
}

Next step

Wire MonorailCSS into your app with ASP.NET integration.