From 4fb5e1511e71cb00e554b6f9db95f811e3384898 Mon Sep 17 00:00:00 2001
From: Alessio Marinelli <defkon1@gmail.com>
Date: Wed, 8 Oct 2025 10:20:56 +0200
Subject: [PATCH 1/8] Added CodeQL

Params:
- ignore push on main
- triggered by pull request on main
- triggered manually
---
 .github/workflows/bitblazor-codeql.yml | 52 ++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 .github/workflows/bitblazor-codeql.yml

diff --git a/.github/workflows/bitblazor-codeql.yml b/.github/workflows/bitblazor-codeql.yml
new file mode 100644
index 0000000..b85b67a
--- /dev/null
+++ b/.github/workflows/bitblazor-codeql.yml
@@ -0,0 +1,52 @@
+name: CodeQL
+
+on:
+  push:
+    branches-ignore: [ main ]
+    paths: [ 'src/**' ]
+  pull_request:
+    branches: [ main ]
+    paths: [ 'src/**' ]
+  workflow_dispatch:
+  schedule:
+    - cron: '0 0 1,15 * *'
+    
+env:
+  NET_VERSION: '9.x'
+    
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'csharp' ]
+  
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v3
+      with:
+        fetch-depth: 0 # avoid shallow clone so nbgv can do its work.
+        
+    - name: Setup .NET SDK ${{ env.NET_VERSION }}
+      uses: actions/setup-dotnet@v3
+      with:
+        dotnet-version: ${{ env.NET_VERSION }}
+        dotnet-quality: 'ga'
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v2
+      with:
+        languages: ${{ matrix.language }}
+        
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v2
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v2

From 0b8b8a81a14e07fbec7256df700188cef2a41d7c Mon Sep 17 00:00:00 2001
From: Alessio Marinelli <defkon1@gmail.com>
Date: Wed, 8 Oct 2025 10:43:09 +0200
Subject: [PATCH 2/8] Update CodeQL to v3

Updated deprecated action from v2 to v3

Ref: https://github.blog/changelog/2025-01-10-code-scanning-codeql-action-v2-is-now-deprecated/
---
 .github/workflows/bitblazor-codeql.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/bitblazor-codeql.yml b/.github/workflows/bitblazor-codeql.yml
index b85b67a..70fba44 100644
--- a/.github/workflows/bitblazor-codeql.yml
+++ b/.github/workflows/bitblazor-codeql.yml
@@ -41,12 +41,12 @@ jobs:
         dotnet-quality: 'ga'
 
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
+      uses: github/codeql-action/init@v3
       with:
         languages: ${{ matrix.language }}
         
     - name: Autobuild
-      uses: github/codeql-action/autobuild@v2
+      uses: github/codeql-action/autobuild@v3
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+      uses: github/codeql-action/analyze@v3

From 994f40c9679b9ab606e2ca30b23fc9242dd7c582 Mon Sep 17 00:00:00 2001
From: Alessio Marinelli <defkon1@gmail.com>
Date: Wed, 8 Oct 2025 10:50:32 +0200
Subject: [PATCH 3/8] Create Test Runner action

Params:
- triggered pull request on main
- triggered manually
---
 .github/workflows/bitblazor-testrunner.yml | 57 ++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 .github/workflows/bitblazor-testrunner.yml

diff --git a/.github/workflows/bitblazor-testrunner.yml b/.github/workflows/bitblazor-testrunner.yml
new file mode 100644
index 0000000..a4b41d7
--- /dev/null
+++ b/.github/workflows/bitblazor-testrunner.yml
@@ -0,0 +1,57 @@
+name: BitBlazor - Test runner
+
+on:
+  push:
+    branches:
+    - main
+  pull_request:
+    branches:
+    - main
+  workflow_dispatch:
+
+permissions:
+  checks: write
+    
+jobs:
+  build_and_test:
+
+    env:
+      BUILD_CONFIG: 'Release'
+      SOLUTION: 'BitBlazor.sln'
+      PROJECT_NAME: src/BitBlazor
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0 # avoid shallow clone so nbgv can do its work.
+
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v3
+      with:
+        dotnet-version: 7.x
+        
+    - name: Nerdbank.GitVersioning 
+      uses: dotnet/nbgv@v0.4
+      id: nbgv
+      with:        
+        path: ${{ env.PROJECT_NAME }}
+
+    - name: Restore dependencies
+      run: dotnet restore $SOLUTION
+
+    - name: Build
+      run: dotnet build $SOLUTION --configuration $BUILD_CONFIG
+      
+    - name: Test
+      run: dotnet test $SOLUTION --configuration $BUILD_CONFIG --logger "trx;LogFileName=test-runner-results.trx" || true
+      
+    - name: Test Report
+      uses: dorny/test-reporter@v1
+      if: always()
+      with:
+        name: DotNET Tests
+        path: "**/test-runner-results.trx"                            
+        reporter: dotnet-trx
+        fail-on-error: true

From c1e5ab75bde7563c065942a9e30479a28d75cd5a Mon Sep 17 00:00:00 2001
From: Alessio Marinelli <defkon1@gmail.com>
Date: Wed, 8 Oct 2025 10:55:01 +0200
Subject: [PATCH 4/8] Fixed Test Runner

Set the correct SDK version
Removed NerdBank Git Versioning step
---
 .github/workflows/bitblazor-testrunner.yml | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/.github/workflows/bitblazor-testrunner.yml b/.github/workflows/bitblazor-testrunner.yml
index a4b41d7..38c1f2d 100644
--- a/.github/workflows/bitblazor-testrunner.yml
+++ b/.github/workflows/bitblazor-testrunner.yml
@@ -30,13 +30,7 @@ jobs:
     - name: Setup .NET
       uses: actions/setup-dotnet@v3
       with:
-        dotnet-version: 7.x
-        
-    - name: Nerdbank.GitVersioning 
-      uses: dotnet/nbgv@v0.4
-      id: nbgv
-      with:        
-        path: ${{ env.PROJECT_NAME }}
+        dotnet-version: 9.x
 
     - name: Restore dependencies
       run: dotnet restore $SOLUTION

From 0e863d41345a2cc9ebc26799eadd4a66693834df Mon Sep 17 00:00:00 2001
From: Alessio Marinelli <defkon1@gmail.com>
Date: Wed, 8 Oct 2025 11:03:29 +0200
Subject: [PATCH 5/8] Added Test Runner and CodeQL to README.md

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ec01884..f2cdb4d 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,8 @@
 # BitBlazor
 
+[![Tests](https://github.com/albx/bitblazor/actions/workflows/bitblazor-testrunner.yml/badge.svg)](https://github.com/albx/bitblazor/actions/workflows/bitblazor-testrunner.yml) [![CodeQL](https://github.com/albx/bitblazor/actions/workflows/bitblazor-codeql.yml/badge.svg)](https://github.com/albx/bitblazor/actions/workflows/bitblazor-codeql.yml)
+
+
 BitBlazor is a UI library that provides accessible, reusable Blazor components styled with [Bootstrap Italia](https://italia.github.io/bootstrap-italia/docs).  
 The goal is to offer a comprehensive set of components for .NET 9 applications, following accessibility best practices and the official Bootstrap Italia design system.
 
@@ -43,4 +46,4 @@ If you have any issues, feedback, or feature requests, please see the [CONTRIBUT
 
 ## License
 
-The project is released under [MIT](https://github.com/albx/bitblazor/blob/main/LICENSE) license.
\ No newline at end of file
+The project is released under [MIT](https://github.com/albx/bitblazor/blob/main/LICENSE) license.

From a31cb7b12a473271c5699eaf782b93dad07b00df Mon Sep 17 00:00:00 2001
From: Defkon1 <defkon1@gmail.com>
Date: Fri, 17 Oct 2025 08:48:48 +0200
Subject: [PATCH 6/8] Added base component

---
 .../Components/Breadcrumb/BitBreadcrumb.razor | 39 +++++++++++++++
 .../Breadcrumb/BitBreadcrumb.razor.cs         | 50 +++++++++++++++++++
 .../Breadcrumb/BitBreadcrumbItem.cs           | 28 +++++++++++
 3 files changed, 117 insertions(+)
 create mode 100644 src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
 create mode 100644 src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
 create mode 100644 src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs

diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
new file mode 100644
index 0000000..8c906a4
--- /dev/null
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
@@ -0,0 +1,39 @@
+@namespace BitBlazor.Components
+
+@using BitBlazor.Components.Breadcrumb
+@inherits BitComponentBase
+
+<nav class="breadcrumb-container" aria-label="@Label">
+    <ol class="@ComputeCssClasses()">
+        @foreach (var item in Items)
+        {
+            @if (IsLeaf(item))
+            {
+                <li class="breadcrumb-item active" aria-current="page">
+                    @BreadcrumbIconFragment(item)
+                    @item.Text
+                </li>
+            }
+            else
+            {
+                <li class="breadcrumb-item"><a href="@item.Link">@item.Text</a><span class="separator">@Separator</span></li>
+            }
+        }
+    </ol>
+</nav>
+
+
+@code {
+
+    /// <summary>
+    /// Gets the item icon fragment, if specified.
+    /// </summary>
+    private RenderFragment BreadcrumbIconFragment(BitBreadcrumbItem item) => __builder =>
+    {
+        @if (item.HasIcon())
+        {
+            <BitIcon IconName="@item.Icon" aria-hidden="true"/>
+        }
+    };
+
+}
diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
new file mode 100644
index 0000000..6ef91a0
--- /dev/null
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
@@ -0,0 +1,50 @@
+using BitBlazor.Components.Breadcrumb;
+using BitBlazor.Core;
+using Microsoft.AspNetCore.Components;
+
+namespace BitBlazor.Components;
+
+public partial class BitBreadcrumb : BitComponentBase
+{
+    /// <summary>
+    /// Gets or sets the ARIA label for the breadcrumb component.
+    /// </summary>
+    [Parameter]
+    public string? Label { get; set; }
+
+    /// <summary>
+    /// Gets or sets the items shown on the breadcrumb.
+    /// </summary>
+    [Parameter]
+    public IEnumerable<BitBreadcrumbItem>? Items { get; set; }
+
+    /// <summary>
+    /// Gets or sets the separator to show between breadcrumb components.
+    /// </summary>
+    [Parameter]
+    public string? Separator { get; set; } = "/";
+
+    /// <summary>
+    /// Gets or sets a value indicating whether the component is rendered on a dark background, or not.
+    /// </summary>
+    [Parameter]
+    public bool Dark { get; set; } = false;
+
+    private string ComputeCssClasses()
+    {
+        var builder = new CssClassBuilder("breadcrumb");
+
+        if (Dark)
+        {
+            builder.Add("dark");
+        }
+
+        return builder.Build();
+    }
+
+    private bool IsLeaf(BitBreadcrumbItem? item)
+    {
+        return item is not null && Items?.LastOrDefault() == item;
+    }
+}
+
diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs
new file mode 100644
index 0000000..c128348
--- /dev/null
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs
@@ -0,0 +1,28 @@
+namespace BitBlazor.Components.Breadcrumb;
+
+/// <summary>
+/// Represents an item in a <see cref="BitBreadcrumb"/> navigation component.
+/// </summary>
+public class BitBreadcrumbItem
+{
+    /// <summary>
+    /// Gets or sets the text to display for the item.
+    /// </summary>
+    public string Text { get; set; }
+
+    /// <summary>
+    /// Gets or sets the icon name to display before the item.
+    /// </summary>
+    public string? Icon { get; set; }
+
+    /// <summary>
+    /// Gets or sets the URL to link to the item.
+    /// </summary>
+    public string? Link { get; set; }
+
+    /// <summary>
+    /// Gets a value indicating whether the item has an icon.
+    /// </summary>
+    /// <returns><code>true</code> if the item has an icon specified, <code>false</code> otherwise</returns>
+    public bool HasIcon() => !string.IsNullOrEmpty(Icon);
+}

From cda4fa56fdde3ccbd03cf9a2a98639f0ad8d9025 Mon Sep 17 00:00:00 2001
From: Defkon1 <defkon1@gmail.com>
Date: Wed, 14 Jan 2026 12:12:39 +0100
Subject: [PATCH 7/8] Enhanced BitBreadcrumb component Added rendering tests
 Added docs

---
 BitBlazor.sln                                 |   5 +-
 docs/README.md                                |   5 +
 docs/components/breadcrumb.md                 | 153 ++++++++++++++++++
 .../Components/Breadcrumb/BitBreadcrumb.razor |  19 ++-
 .../Breadcrumb/BitBreadcrumb.razor.cs         |  10 +-
 .../Breadcrumb/BitBreadcrumbItem.cs           |   4 +-
 .../Components/BitBreadcrumb.stories.razor    |  77 +++++++++
 .../BitBreadcrumbTest.Rendering.razor         | 122 ++++++++++++++
 8 files changed, 385 insertions(+), 10 deletions(-)
 create mode 100644 docs/components/breadcrumb.md
 create mode 100644 stories/BitBlazor.Stories/Components/Stories/Components/BitBreadcrumb.stories.razor
 create mode 100644 tests/BitBlazor.Test/Components/Breadcrumb/BitBreadcrumbTest.Rendering.razor

diff --git a/BitBlazor.sln b/BitBlazor.sln
index 6fde770..240f987 100644
--- a/BitBlazor.sln
+++ b/BitBlazor.sln
@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 18
-VisualStudioVersion = 18.0.11123.170
+# Visual Studio Version 17
+VisualStudioVersion = 17.12.35527.113 d17.12
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{827E0CD3-B72D-47B6-A68D-7590B98EB39B}"
 EndProject
@@ -36,6 +36,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "components", "components",
 		docs\components\alert.md = docs\components\alert.md
 		docs\components\avatar.md = docs\components\avatar.md
 		docs\components\badge.md = docs\components\badge.md
+		docs\components\breadcrumb.md = docs\components\breadcrumb.md
 		docs\components\button-badge.md = docs\components\button-badge.md
 		docs\components\button.md = docs\components\button.md
 		docs\components\card.md = docs\components\card.md
diff --git a/docs/README.md b/docs/README.md
index bade0ef..73c2e99 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -36,6 +36,11 @@ Small and adaptable labels for adding information.
 - Support for rounded shapes
 - Various colors available
 
+#### [Breadcrumb](components/breadcrumb.md)
+Breadcrumb navigation component to display the current location within a hierarchy.
+- Support for the customization of items and the separator
+- Accessibility support
+
 #### [Button](components/button.md)
 Interactive buttons with support for icons and different styles.
 - Solid and outline variants
diff --git a/docs/components/breadcrumb.md b/docs/components/breadcrumb.md
new file mode 100644
index 0000000..4a1a5ee
--- /dev/null
+++ b/docs/components/breadcrumb.md
@@ -0,0 +1,153 @@
+# BitBreadcrumb
+
+The `BitBreadcrumb` component renders a [breadcrumb navigation](https://getbootstrap.com/docs/5.3/components/breadcrumb/) to display the user's current location within a hierarchy, supporting customization of items, separators, and accessibility features.
+
+## Namespace
+
+```csharp
+BitBlazor.Components
+```
+
+## Description
+
+The Breadcrumb component provides a navigational aid that helps users understand and navigate the hierarchy of a website or application. It displays the current page's location within a navigational hierarchy and allows users to quickly move to previous levels.
+
+## Parameters
+
+| Name      | Type                                 | Required | Default | Description                                                                 |
+|-----------|--------------------------------------|----------|---------|-----------------------------------------------------------------------------|
+| `Label`   | `string?`                            | ✗       | `null`  | The ARIA label for the breadcrumb component, improving accessibility.       |
+| `Items`   | `IReadOnlyList<BitBreadcrumbItem>?`  | ✓        | -       | The collection of breadcrumb items to display.                              |
+| `Separator` | `string?`                          | ✗       | `"/"`   | The separator string shown between breadcrumb items.                        |
+| `Dark`    | `bool`                               | ✗       | `false` | Indicates if the breadcrumb is rendered on a dark background.               |
+
+## BitBreadcrumbItem
+
+Each breadcrumb item is represented by a `BitBreadcrumbItem` object. Typically, this includes properties such as:
+
+| Property   | Type     | Description                                 |
+|------------|----------|---------------------------------------------|
+| `Text`     | `string` | The display text for the breadcrumb item.   |
+| `Href`     | `string` | The URL to navigate to when the item is clicked. (Optional for the last item) |
+| `Icon`     | `string?` | The icon to show before the item (Optional) |
+
+> **Note:** The last item in the `Items` list is considered the current page and is not rendered as a link.
+
+## Usage Examples
+
+### Basic breadcrumb
+
+C#:
+```csharp
+    List<BitBreadcrumbItem> items =
+        [
+            new BitBreadcrumbItem { Text = "Home", Link = "#" },
+            new BitBreadcrumbItem { Text = "Category", Link = "#" },
+            new BitBreadcrumbItem { Text = "Subcategory", Link = "#" },
+            new BitBreadcrumbItem { Text = "Item" }
+        ];
+```
+
+Razor:
+```razor
+<BitBreadcrumb Items="@items" />
+```
+
+### Breadcrumb with custom separator
+
+C#:
+```csharp
+    List<BitBreadcrumbItem> items =
+        [
+            new BitBreadcrumbItem { Text = "Home", Link = "#" },
+            new BitBreadcrumbItem { Text = "Category", Link = "#" },
+            new BitBreadcrumbItem { Text = "Subcategory", Link = "#" },
+            new BitBreadcrumbItem { Text = "Item" }
+        ];
+```
+
+Razor:
+```razor
+<BitBreadcrumb Items="@items" Separator=">" />
+```
+
+### Breadcrumb with icons
+
+C#:
+```csharp
+    List<BitBreadcrumbItem> items =
+        [
+            new BitBreadcrumbItem { Text = "Home", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Category", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Subcategory", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Item", Icon= BitBlazor.Utilities.Icons.ItLink }
+        ];
+```
+
+Razor:
+```razor
+<BitBreadcrumb Items="@items" />
+```
+
+### Breadcrumb with dark background
+
+C#
+```csharp
+    List<BitBreadcrumbItem> items =
+        [
+            new BitBreadcrumbItem { Text = "Home", Link = "#" },
+            new BitBreadcrumbItem { Text = "Category", Link = "#" },
+            new BitBreadcrumbItem { Text = "Subcategory", Link = "#" },
+            new BitBreadcrumbItem { Text = "Item" }
+        ];
+```
+
+Razor:
+```razor
+<BitBreadcrumb Items="@items" Dark="true" />
+```
+
+
+## Accessibility
+
+- The `Label` parameter sets the `aria-label` attribute for the breadcrumb navigation, enhancing accessibility for assistive technologies.
+
+## Generated CSS Classes
+
+The component generates the following CSS classes based on parameters:
+
+- `breadcrumb`: Base class for the breadcrumb container.
+- `dark`: Added when `Dark` is `true`.
+- `px-3`: Added when `Dark` is `true` for horizontal padding.
+
+## Generated HTML Structure
+
+```html
+<nav class="breadcrumb-container">
+        <ol class="breadcrumb">
+            <li class="breadcrumb-item">
+                <a href="#">Home</a>
+                <span class="separator">/</span>
+            </li>
+            <li class="breadcrumb-item">
+                <a href="#">Category</a>
+                <span class="separator">/</span>
+            </li>
+            <li class="breadcrumb-item">
+                <a href="#">Subcategory</a>
+                <span class="separator">/</span>
+            </li>
+            <li class="breadcrumb-item active" aria-current="page">
+                Item
+            </li>
+        </ol>
+    </nav>
+```
+
+
+## Notes
+
+- The `Separator` parameter allows customization of the character or string used between breadcrumb items.
+- When `Dark` is set to `true`, additional CSS classes are applied for better contrast on dark backgrounds.
+- The last item in the `Items` list is rendered as plain text to indicate the current page.
+- If `Items` is `null` or empty, the component renders nothing.
\ No newline at end of file
diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
index 8c906a4..dd8f920 100644
--- a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
@@ -1,8 +1,10 @@
 @namespace BitBlazor.Components
 
-@using BitBlazor.Components.Breadcrumb
 @inherits BitComponentBase
 
+<!-- BitBreadcrumb renders a breadcrumb navigation component to display the current location within a hierarchy.
+     The component supports customization of items, separators, and accessibility features. -->
+
 <nav class="breadcrumb-container" aria-label="@Label">
     <ol class="@ComputeCssClasses()">
         @foreach (var item in Items)
@@ -16,7 +18,11 @@
             }
             else
             {
-                <li class="breadcrumb-item"><a href="@item.Link">@item.Text</a><span class="separator">@Separator</span></li>
+                <li class="breadcrumb-item">
+                    @BreadcrumbIconFragment(item)
+                    <a href="@item.Link">@item.Text</a>
+                    <span class="separator">@Separator</span>
+                </li>
             }
         }
     </ol>
@@ -32,7 +38,14 @@
     {
         @if (item.HasIcon())
         {
-            <BitIcon IconName="@item.Icon" aria-hidden="true"/>
+            if (!Dark)
+            {
+                <BitIcon IconName="@item.Icon" Size="IconSize.ExtraSmall" aria-hidden="true" />
+            }
+            else
+            {
+                <BitIcon IconName="@item.Icon" Size="IconSize.ExtraSmall" Color="IconColor.White" aria-hidden="true" />
+            }
         }
     };
 
diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
index 6ef91a0..2e290d9 100644
--- a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
@@ -1,9 +1,12 @@
-using BitBlazor.Components.Breadcrumb;
-using BitBlazor.Core;
+using BitBlazor.Core;
 using Microsoft.AspNetCore.Components;
 
 namespace BitBlazor.Components;
 
+/// <summary> 
+/// BitBreadcrumb renders a breadcrumb navigation component to display the current location within a hierarchy.
+/// The component supports customization of items, separators, and accessibility features.
+/// </summary>
 public partial class BitBreadcrumb : BitComponentBase
 {
     /// <summary>
@@ -16,7 +19,7 @@ public partial class BitBreadcrumb : BitComponentBase
     /// Gets or sets the items shown on the breadcrumb.
     /// </summary>
     [Parameter]
-    public IEnumerable<BitBreadcrumbItem>? Items { get; set; }
+    public IReadOnlyList<BitBreadcrumbItem>? Items { get; set; }
 
     /// <summary>
     /// Gets or sets the separator to show between breadcrumb components.
@@ -37,6 +40,7 @@ private string ComputeCssClasses()
         if (Dark)
         {
             builder.Add("dark");
+            builder.Add("px-3");
         }
 
         return builder.Build();
diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs
index c128348..2edd5ae 100644
--- a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs
@@ -1,4 +1,4 @@
-namespace BitBlazor.Components.Breadcrumb;
+namespace BitBlazor.Components;
 
 /// <summary>
 /// Represents an item in a <see cref="BitBreadcrumb"/> navigation component.
@@ -25,4 +25,4 @@ public class BitBreadcrumbItem
     /// </summary>
     /// <returns><code>true</code> if the item has an icon specified, <code>false</code> otherwise</returns>
     public bool HasIcon() => !string.IsNullOrEmpty(Icon);
-}
+}
\ No newline at end of file
diff --git a/stories/BitBlazor.Stories/Components/Stories/Components/BitBreadcrumb.stories.razor b/stories/BitBlazor.Stories/Components/Stories/Components/BitBreadcrumb.stories.razor
new file mode 100644
index 0000000..3d7c0d5
--- /dev/null
+++ b/stories/BitBlazor.Stories/Components/Stories/Components/BitBreadcrumb.stories.razor
@@ -0,0 +1,77 @@
+@attribute [Stories("Components/BitBreadcrumb")]
+
+<Stories TComponent="BitBreadcrumb">
+    <ArgType For="_ => _.Dark" DefaultValue="false" />
+    <ArgType For="_ => _.Separator" DefaultValue="@("/")" />
+
+    <Story Name="Default">
+        <Arguments>
+            <Arg For="_ => _.Dark" Value="false" />
+        </Arguments>
+        <Template>
+            <div class="px-2 py-2 d-flex align-items-center justify-content-around flex-wrap flex-sm-nowrap">
+                <BitBreadcrumb @attributes="context.Args" Items="@_items" />
+            </div>
+        </Template>
+    </Story>
+
+    <Story Name="Breadcrumb with custom separator">
+        <Arguments>
+            <Arg For="_ => _.Dark" Value="false" />
+        </Arguments>
+        <Template>
+            <div class="px-2 py-2 d-flex align-items-center justify-content-around flex-wrap flex-sm-nowrap">
+                <BitBreadcrumb @attributes="context.Args" Items="@_items" Separator=">" />
+            </div>
+        </Template>
+    </Story>
+
+    <Story Name="Breadcrumb with icons">
+        <Arguments>
+            <Arg For="_ => _.Dark" Value="false" />
+            <ArgType For="_ => _.Separator" DefaultValue="@("/")" />
+        </Arguments>
+        <Template>
+            <div class="px-2 py-2 d-flex align-items-center justify-content-around flex-wrap flex-sm-nowrap">
+                <BitBreadcrumb @attributes="context.Args" Items="@_itemsWithIcons" />
+            </div>
+            <div class="px-2 py-2 d-flex align-items-center justify-content-around flex-wrap flex-sm-nowrap">
+                <BitBreadcrumb @attributes="context.Args" Items="@_itemsWithIcons" Separator="@(">")" />
+            </div>
+        </Template>
+    </Story>
+
+    <Story Name="Breadcrumb with dark background">
+        <Arguments>
+            <Arg For="_ => _.Dark" Value="true" />
+            <ArgType For="_ => _.Separator" DefaultValue="@("/")" />
+        </Arguments>
+        <Template>
+            <div class="px-2 py-2 d-flex align-items-center justify-content-around flex-wrap flex-sm-nowrap">
+                <BitBreadcrumb @attributes="context.Args" Items="@_itemsWithIcons" Dark="true" />
+            </div>
+            <div class="px-2 py-2 d-flex align-items-center justify-content-around flex-wrap flex-sm-nowrap">
+                <BitBreadcrumb @attributes="context.Args" Items="@_itemsWithIcons" Separator="@(">")" Dark="true" />
+            </div>
+        </Template>
+    </Story>
+</Stories>
+
+@code
+{
+    private List<BitBreadcrumbItem> _items = new()
+    {
+        new BitBreadcrumbItem { Text = "Home", Link = "#" },
+        new BitBreadcrumbItem { Text = "Category", Link = "#" },
+        new BitBreadcrumbItem { Text = "Subcategory", Link = "#" },
+        new BitBreadcrumbItem { Text = "Item"}
+    };
+
+    private List<BitBreadcrumbItem> _itemsWithIcons = new()
+    {
+        new BitBreadcrumbItem { Text = "Home", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+        new BitBreadcrumbItem { Text = "Category", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+        new BitBreadcrumbItem { Text = "Subcategory", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+        new BitBreadcrumbItem { Text = "Item", Icon= BitBlazor.Utilities.Icons.ItLink }
+    };
+}
diff --git a/tests/BitBlazor.Test/Components/Breadcrumb/BitBreadcrumbTest.Rendering.razor b/tests/BitBlazor.Test/Components/Breadcrumb/BitBreadcrumbTest.Rendering.razor
new file mode 100644
index 0000000..6c1d565
--- /dev/null
+++ b/tests/BitBlazor.Test/Components/Breadcrumb/BitBreadcrumbTest.Rendering.razor
@@ -0,0 +1,122 @@
+@inherits TestContext
+
+@code {
+    [Theory]
+    [InlineData("/")]
+    [InlineData(">")]
+    public void BitBreadcrumb_Should_Render_Correctly(string separator)
+    {
+        List<BitBreadcrumbItem> items =
+        [
+            new BitBreadcrumbItem { Text = "Home", Link = "#" },
+            new BitBreadcrumbItem { Text = "Category", Link = "#" },
+            new BitBreadcrumbItem { Text = "Subcategory", Link = "#" },
+            new BitBreadcrumbItem { Text = "Item" }
+        ];
+
+        var component = Render(@<BitBreadcrumb Items="@items" Separator="@separator" />);
+
+        component.MarkupMatches(
+    @<nav class="breadcrumb-container">
+        <ol class="breadcrumb">
+            <li class="breadcrumb-item">
+                <a href="#">Home</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item">
+                <a href="#">Category</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item">
+                <a href="#">Subcategory</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item active" aria-current="page">
+                Item
+            </li>
+        </ol>
+    </nav>);
+    }
+
+    [Theory]
+    [InlineData("/")]
+    [InlineData(">")]
+    public void BitBreadcrumbWithIcons_Should_Render_Correctly(string separator)
+    {
+        List<BitBreadcrumbItem> items =
+        [
+            new BitBreadcrumbItem { Text = "Home", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Category", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Subcategory", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Item", Icon= BitBlazor.Utilities.Icons.ItLink }
+        ];
+
+        var component = Render(@<BitBreadcrumb Items="@items" Separator="@separator" />);
+
+        component.MarkupMatches(
+    @<nav class="breadcrumb-container">
+        <ol class="breadcrumb">
+            <li class="breadcrumb-item">
+                <svg class="icon icon-xs" aria-hidden="true"><use href="/_content/BitBlazor/bootstrap-italia/svg/sprites.svg#it-link"></use></svg>
+                <a href="#">Home</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item">
+                <svg class="icon icon-xs" aria-hidden="true"><use href="/_content/BitBlazor/bootstrap-italia/svg/sprites.svg#it-link"></use></svg>
+                <a href="#">Category</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item">
+                <svg class="icon icon-xs" aria-hidden="true"><use href="/_content/BitBlazor/bootstrap-italia/svg/sprites.svg#it-link"></use></svg>
+                <a href="#">Subcategory</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item active" aria-current="page">
+                <svg class="icon icon-xs" aria-hidden="true"><use href="/_content/BitBlazor/bootstrap-italia/svg/sprites.svg#it-link"></use></svg>
+                Item
+            </li>
+        </ol>
+    </nav>);
+    }
+
+    [Theory]
+    [InlineData("/")]
+    [InlineData(">")]
+    public void BitBreadcrumbWithDarkBackground_Should_Render_Correctly(string separator)
+    {
+        List<BitBreadcrumbItem> items =
+        [
+            new BitBreadcrumbItem { Text = "Home", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Category", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Subcategory", Link = "#", Icon= BitBlazor.Utilities.Icons.ItLink },
+            new BitBreadcrumbItem { Text = "Item", Icon= BitBlazor.Utilities.Icons.ItLink }
+        ];
+
+        var component = Render(@<BitBreadcrumb Items="@items" Separator="@separator" Dark="true" />);
+
+        component.MarkupMatches(
+    @<nav class="breadcrumb-container">
+        <ol class="breadcrumb dark px-3">
+            <li class="breadcrumb-item">
+                <svg class="icon icon-xs icon-white" aria-hidden="true"><use href="/_content/BitBlazor/bootstrap-italia/svg/sprites.svg#it-link"></use></svg>
+                <a href="#">Home</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item">
+                <svg class="icon icon-xs icon-white" aria-hidden="true"><use href="/_content/BitBlazor/bootstrap-italia/svg/sprites.svg#it-link"></use></svg>
+                <a href="#">Category</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item">
+                <svg class="icon icon-xs icon-white" aria-hidden="true"><use href="/_content/BitBlazor/bootstrap-italia/svg/sprites.svg#it-link"></use></svg>
+                <a href="#">Subcategory</a>
+                <span class="separator">@separator</span>
+            </li>
+            <li class="breadcrumb-item active" aria-current="page">
+                <svg class="icon icon-xs icon-white" aria-hidden="true"><use href="/_content/BitBlazor/bootstrap-italia/svg/sprites.svg#it-link"></use></svg>
+                Item
+            </li>
+        </ol>
+    </nav>);
+    }
+}

From b710f20490aa8938754a687183621b5c35870f1b Mon Sep 17 00:00:00 2001
From: Defkon1 <defkon1@gmail.com>
Date: Wed, 28 Jan 2026 11:03:38 +0100
Subject: [PATCH 8/8] Added review suggestions (parameters nullability and
 default values)

---
 docs/components/breadcrumb.md                              | 6 +++---
 src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor    | 2 +-
 src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs | 5 ++---
 src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs   | 2 +-
 4 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/docs/components/breadcrumb.md b/docs/components/breadcrumb.md
index 4a1a5ee..5c49722 100644
--- a/docs/components/breadcrumb.md
+++ b/docs/components/breadcrumb.md
@@ -17,7 +17,7 @@ The Breadcrumb component provides a navigational aid that helps users understand
 | Name      | Type                                 | Required | Default | Description                                                                 |
 |-----------|--------------------------------------|----------|---------|-----------------------------------------------------------------------------|
 | `Label`   | `string?`                            | ✗       | `null`  | The ARIA label for the breadcrumb component, improving accessibility.       |
-| `Items`   | `IReadOnlyList<BitBreadcrumbItem>?`  | ✓        | -       | The collection of breadcrumb items to display.                              |
+| `Items`   | `IReadOnlyList<BitBreadcrumbItem>`   | ✓        | empty list       | The collection of breadcrumb items to display.                              |
 | `Separator` | `string?`                          | ✗       | `"/"`   | The separator string shown between breadcrumb items.                        |
 | `Dark`    | `bool`                               | ✗       | `false` | Indicates if the breadcrumb is rendered on a dark background.               |
 
@@ -27,8 +27,8 @@ Each breadcrumb item is represented by a `BitBreadcrumbItem` object. Typically,
 
 | Property   | Type     | Description                                 |
 |------------|----------|---------------------------------------------|
-| `Text`     | `string` | The display text for the breadcrumb item.   |
-| `Href`     | `string` | The URL to navigate to when the item is clicked. (Optional for the last item) |
+| `Text`     | `string` | The display text for the breadcrumb item. (Default empty string)   |
+| `Href`     | `string` | The URL to navigate to when the item is clicked. (Default `"#"`, optional for the last item) |
 | `Icon`     | `string?` | The icon to show before the item (Optional) |
 
 > **Note:** The last item in the `Items` list is considered the current page and is not rendered as a link.
diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
index dd8f920..4bc1f04 100644
--- a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor
@@ -20,7 +20,7 @@
             {
                 <li class="breadcrumb-item">
                     @BreadcrumbIconFragment(item)
-                    <a href="@item.Link">@item.Text</a>
+                    <a href="@(string.IsNullOrWhiteSpace(item.Link) ? "#" : item.Link)">@item.Text</a>
                     <span class="separator">@Separator</span>
                 </li>
             }
diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
index 2e290d9..6ece548 100644
--- a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumb.razor.cs
@@ -19,7 +19,7 @@ public partial class BitBreadcrumb : BitComponentBase
     /// Gets or sets the items shown on the breadcrumb.
     /// </summary>
     [Parameter]
-    public IReadOnlyList<BitBreadcrumbItem>? Items { get; set; }
+    public IReadOnlyList<BitBreadcrumbItem> Items { get; set; } = Enumerable.Empty<BitBreadcrumbItem>().ToList();
 
     /// <summary>
     /// Gets or sets the separator to show between breadcrumb components.
@@ -39,8 +39,7 @@ private string ComputeCssClasses()
 
         if (Dark)
         {
-            builder.Add("dark");
-            builder.Add("px-3");
+            builder.AddRange(new[] { "dark", "px-3" });
         }
 
         return builder.Build();
diff --git a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs
index 2edd5ae..34ba500 100644
--- a/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs
+++ b/src/BitBlazor/Components/Breadcrumb/BitBreadcrumbItem.cs
@@ -8,7 +8,7 @@ public class BitBreadcrumbItem
     /// <summary>
     /// Gets or sets the text to display for the item.
     /// </summary>
-    public string Text { get; set; }
+    public string Text { get; set; } = string.Empty;
 
     /// <summary>
     /// Gets or sets the icon name to display before the item.