From 969e4ac3ad2ebb0d3e04317256a783e10c76fc0e Mon Sep 17 00:00:00 2001 From: Peter Kurhajec <61538034+PTKu@users.noreply.github.com> Date: Wed, 3 Dec 2025 09:29:02 +0100 Subject: [PATCH] Update docs --- docfx/articles/blazor/RENDERABLECONTENT.md | 33 ++++++++++++++++++---- 1 file changed, 27 insertions(+), 6 deletions(-) diff --git a/docfx/articles/blazor/RENDERABLECONTENT.md b/docfx/articles/blazor/RENDERABLECONTENT.md index 000d37ea..c3740522 100644 --- a/docfx/articles/blazor/RENDERABLECONTENT.md +++ b/docfx/articles/blazor/RENDERABLECONTENT.md @@ -238,18 +238,39 @@ Result: ### **Styling** -AXSharp.Presentation.Blazor contains in-built styles. Styling is provided by [Bootstrap library](https://getbootstrap.com/). In-built styles can be customized with Sass technology, which will produce SCSS files. SCSS files can be compiled into one CSS file which can be used as application-wide style. +AXSharp.Presentation.Blazor contains in-built styles. The styling is provided by `momentum.css`, a custom CSS file built with [Tailwind CSS](https://tailwindcss.com/). This approach consolidates all styling into a single dependency for better maintainability. -Currently, the framework contains a default style that can be added as a reference in the Blazor application file *_Host.cshtml* in the following way: +To add the styles to your Blazor application, reference the CSS file in your *_Host.cshtml* (or *App.razor* for .NET 8+ Blazor applications): +```html + ``` - + +If you are also using the Operon library, include its stylesheet as well: + +```html + ``` -It is possible to add built-in javascript libraries as well: + +#### Building Custom Styles + +If you need to customize the styles, you can modify the Tailwind CSS source file and rebuild the `momentum.css`. The source file is located at: + ``` - - +src/AXSharp.blazor/src/AXSharp.Presentation.Blazor.Controls/wwwroot/css/tailwind.css ``` + +To rebuild the styles: + +1. Ensure Node.js is installed on your system +2. Navigate to the `AXSharp.Presentation.Blazor.Controls` directory +3. Run `npm install` to install dependencies (if not already done) +4. Run the Tailwind CLI to build the CSS: + ``` + npx @tailwindcss/cli -i ./wwwroot/css/tailwind.css -o ./wwwroot/css/momentum.css --minify + ``` + +> **Note:** The build process automatically handles the Tailwind CSS compilation when you run the project build script. ### **Custom components libraries** AXSharp.Presentation.Controls framework provides possibility to create a custom library of components with corresponding views.