BluetoothLE Hosting

Getting Started

• 
• 
• 

Frameworks

.NET

.NET MAUI

Operating Systems

Android

iOS

macOS

Windows

Linux

BluetoothLE Hosting allows your device to act as a BLE peripheral (server). You can advertise services, create GATT services with characteristics, and communicate with central devices that connect to you.

Features

• Advertise as a BLE peripheral
• Create GATT services with read/write/notify characteristics
• Managed characteristic classes with dependency injection
• Cross-platform: iOS, macOS, Android, Windows, Linux

Platform Notes

Feature	iOS	macOS	Android	Windows	Linux
Advertising	Foreground + limited background	Full	Full	Full	Full
GATT Server	Full	Full	Full	Full	Full
Managed Characteristics	Full	Full	Full	Full	Full

iOS

On iOS, advertising is limited when the app is in the background. The local name is not included and only service UUIDs are advertised.

Blazor WebAssembly

BLE peripheral / GATT server hosting is not possible in the browser. The Web Bluetooth API only exposes the central role — there is no spec or browser implementation for advertising as a peripheral. This isn’t a Shiny limitation; it cannot be worked around with JS interop.

Setup

MAUILinux (GTK)

• NuGet Packages
• Project File
• MauiProgram.cs
• AndroidManifest.xml
• Info.plist
• PrivacyInfo.xcprivacy
• Package.appxmanifest

Shiny.BluetoothLE.Hosting

Shiny.Hosting.Maui

Requesting Access

IBleHostingManager hostingManager; // injected

var access = await hostingManager.RequestAccess(advertise: true, connect: true);

Advertising

// Start advertising with a local name and service UUIDs
await hostingManager.StartAdvertising(new AdvertisementOptions(
    LocalName: "MyDevice",
    ServiceUuids: new[] { "Your-Service-UUID" }
));

// Check advertising state
var isAdvertising = hostingManager.IsAdvertising;

// Stop advertising
hostingManager.StopAdvertising();

AI Coding Assistant

Claude Code GitHub Copilot

Step 1 — Add the marketplace:

claude plugin marketplace add shinyorg/skills

Step 2 — Install the plugin:

claude plugin install shiny-client@shiny

Step 1 — Add the marketplace:

copilot plugin marketplace add https://github.com/shinyorg/skills

Step 2 — Install the plugin:

copilot plugin install shiny-client@shiny

View shiny-client Plugin

Samples

• MAUI Sample