Circuids.Bridge 1.0.1

Prefix Reserved
.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Circuids.Bridge --version 1.0.1
                    


                    

                
NuGet\Install-Package Circuids.Bridge -Version 1.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Circuids.Bridge" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Circuids.Bridge" Version="1.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Circuids.Bridge" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Circuids.Bridge --version 1.0.1
                    


                    

                
#r "nuget: Circuids.Bridge, 1.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Circuids.Bridge@1.0.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Circuids.Bridge&version=1.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Circuids.Bridge&version=1.0.1
                    


                            Install as a Cake Tool

Circuids.Bridge

Bridge helps shared Razor UI understand the host it is running in without scattering platform checks through your components. It gives Blazor WebAssembly, Blazor Server, and MAUI Blazor Hybrid apps one common model for host, platform, form factor, connectivity, theme, and safe-area state.

Use the core package when you are building shared Razor UI. It contains the public contracts, enums, value objects, providers, components, and host handlers. Host apps should install one of the implementation packages listed below.

Choose The Right Package

Project type Install Why
Shared Razor Class Library Circuids.Bridge Compile against Bridge components and interfaces without choosing a host runtime.
Blazor WebAssembly app Circuids.Bridge.Blazor Registers browser-backed implementations using JS interop.
Blazor Server app Circuids.Bridge.Blazor Registers server-compatible Blazor implementations that initialize after the circuit is interactive.
MAUI Blazor Hybrid app Circuids.Bridge.Maui Registers native MAUI implementations for device, window, connectivity, theme, and safe-area state.

Circuids.Bridge.Blazor and Circuids.Bridge.Maui both reference this core package transitively. You normally install Circuids.Bridge directly only in shared Razor Class Libraries.

What Bridge Provides

Need Component Service
Host-specific rendering BridgeHost IBridge
Platform-specific rendering BridgePlatform IBridge
Phone, tablet, or desktop layout BridgeFormFactor IBridgeFormFactor
Online/offline UI BridgeConnectivity IBridgeConnectivity
Light/dark UI BridgeTheme IBridgeTheme
Notch, cutout, and gesture-safe padding BridgeSafeArea IBridgeSafeArea

Shared UI Example

@using Circuids.Bridge

<BridgeHost>
    <Maui>
        <NativeToolbar />
    </Maui>
    <Blazor>
        <WebToolbar />
    </Blazor>
</BridgeHost>

<BridgeFormFactor Context="viewport">
    <DashboardFrame Layout="viewport.FormFactor" Width="viewport.Width" Height="viewport.Height" />

    <Phone>
        <MobileDashboard />
    </Phone>
    <Desktop>
        <DesktopDashboard />
    </Desktop>
    <Default>
        <CompactDashboard />
    </Default>
</BridgeFormFactor>

The plain child content receives the current context. Named slots such as Phone, Desktop, Maui, and Blazor stay simple branch fragments.

Host Setup

Install the host package in the application that runs your UI, then wrap the shared UI in BridgeProvider.

@using Circuids.Bridge

<BridgeProvider>
    @Body
</BridgeProvider>

See the host package README for registration details:

Host Package
Blazor WebAssembly or Blazor Server Circuids.Bridge.Blazor
MAUI Blazor Hybrid Circuids.Bridge.Maui

Learn More

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Circuids.Bridge:

Package Downloads
Circuids.Bridge.Blazor

Package Description
Circuids.Bridge.Maui

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.1 125 5/24/2026
1.0.0 127 4/27/2026

1.0.0

Initial stable release of the Bridge core package.

- Added shared contracts for host/platform, form factor, connectivity, theme, and safe-area state.
- Added Razor components for host, platform, responsive layout, connectivity, theme, and safe-area rendering.
- Added BridgeProvider and individual feature providers for controlled initialization.
- Added immutable value objects and enums for shared runtime state.
- Added host handler abstractions for host-specific C# behavior from shared code.
- Intended for shared Razor Class Libraries; install Circuids.Bridge.Blazor or Circuids.Bridge.Maui in host apps.