From 11f7dd8f79f8915bd19348cb096f324ebd445921 Mon Sep 17 00:00:00 2001
From: Ilkay Ilknur <ilkay@ilkayilknur.com>
Date: Wed, 18 Nov 2020 14:30:43 +0300
Subject: [PATCH] global scripts and styles documentation.

---
 docs/en/UI/Blazor/Global-Scripts-Styles.md | 37 +++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/docs/en/UI/Blazor/Global-Scripts-Styles.md b/docs/en/UI/Blazor/Global-Scripts-Styles.md
index ae473351f0..561eed27f6 100644
--- a/docs/en/UI/Blazor/Global-Scripts-Styles.md
+++ b/docs/en/UI/Blazor/Global-Scripts-Styles.md
@@ -1,3 +1,38 @@
 # Blazor UI: Managing Global Scripts & Styles
 
-TODO
\ No newline at end of file
+Some modules may require additional styles or scripts that need to be referenced in **index.html** file. It's not easy to find and update these types of references in Blazor apps. ABP offers a simple, powerful, and modular way to manage global style and scripts in Blazor apps.
+
+To update script & style references without worrying about dependencies, ordering, etc in a project, you can use the [bundle command](../../CLI.md#bundle).
+
+You can also add custom styles and scripts and let ABP manage them for you. In your Blazor project, you can create a class implementing `IBundleContributer` interface.
+
+`IBundleContributer` interface contains two methods.
+
+* `AddScripts(...)`
+* `AddStyles(...)`
+
+Both methods get `BundleContext` as a parameter. You can add scripts and styles to the `BundleContext` and run [bundle command](../../CLI.md#bundle). Bundle command detects custom styles and scripts with module dependencies and updates `index.html` file.
+
+## Example Usage
+```csharp
+namespace MyProject.Blazor
+{
+    public class MyProjectBundleContributer : IBundleContributer
+    {
+        public void AddScripts(BundleContext context)
+        {
+            context.Add("site.js");
+        }
+
+        public void AddStyles(BundleContext context)
+        {
+            context.Add("main.css");
+            context.Add("custom-styles.css");
+        }
+    }
+}
+```
+
+> There is a BundleContributer class implementing `IBundleContributer` interface coming by default with the startup templates. So, most of the time, you don't need to add it manually.
+
+> Bundle command adds style and script references individually. Bundling and minification support will be added to incoming releases.
\ No newline at end of file