Shiny.Core 5.4.0-beta-0075
Shiny Client for .NET
Shiny is a cross-platform framework designed to make working with device services and background processes easy, testable, and consistent while bringing things like dependency injection & logging in a structured way to your code!
Features
- Handles all of the cruft like Permissions, main thread traversal, persistent storage and app restarts
- Brings your infrastructure to the background
- Provides logging to ensure you know when your services fail in the background
- Gives a clean & testable API surface for your code
- Native AOT & trim-friendly across all modules
- Cross-platform: iOS, Android, Mac Catalyst, macOS, Windows, Linux, and Blazor WebAssembly (where the platform allows)
Modules
- Background Jobs - periodic background work backed by
BGTaskScheduler(iOS),WorkManager(Android), COM-activated background tasks (Windows), and an in-process managed runner for Linux/macOS/Blazor WASM - HTTP Transfers - resumable background uploads/downloads on
NSURLSession(iOS), anHttpClient-driven managed loop with Range-based resume (Android, Windows, Linux, macOS, .NET base), and Service Worker Background Sync (Blazor WASM). Pause/resume support - pause stops a transfer without cancelling it (downloads continue from where they left off, uploads restart). First-class Azure Blob Storage and AWS S3 (SigV4) request builders included - Data Sync - bidirectional JSON record sync over HTTP with the same platform tiers as HTTP Transfers: outbox + inbox on
NSURLSession(iOS/Mac Catalyst), Foreground Service + HttpClient (Android),HttpClient+ connectivity loop (Windows/Linux/macOS), and LocalStorage-backed HttpClient (Blazor WASM). Includes batched outbox, tombstones, conflict resolution, retry with exponential backoff, and AOT-safe serialization throughShiny.Json - BluetoothLE Client - scan, connect, GATT, and L2CAP CoC on iOS/macOS, Android, Windows, Linux (BlueZ), and Blazor WebAssembly (Web Bluetooth)
- BluetoothLE Hosting - GATT server, advertising, iBeacon broadcasting, and L2CAP CoC listeners on iOS/macOS, Android, Windows, and Linux (BlueZ AF_BLUETOOTH sockets)
- Locations - foreground/background GPS, geofence monitoring, and motion-activity recognition (CMMotionActivity / ActivityRecognition)
- Contacts - cross-platform device contact access with CRUD and a fluent async query builder (iOS/Android):
await store.Query().Search(text).OrderBy(ContactSortField.FamilyName).ToListAsync(ct) - Calendar - cross-platform calendar & event access with CRUD and a fluent async query builder on iOS/Mac Catalyst/macOS (EventKit), Android (CalendarContract), and Windows (
AppointmentStore, best-effort - system events are read-only, writes go to an app-owned calendar).await store.Query().ForCalendar(id).Between(from, to).OrderBy(CalendarEventSortField.Start).ToListAsync(ct)- the calendar id and date window are pushed down to the native fetch, which runs off the calling thread.DeleteEvent(id, deleteSeries)chooses between removing one occurrence of a recurring event or the rest of the series - Local Notifications - scheduled, repeating, and geofence-triggered notifications on iOS/macOS, Android, Windows, and Linux (
org.freedesktop.NotificationsD-Bus) - Push Notifications - native APNs/FCM, Firebase Cloud Messaging, Azure Notification Hubs, and Blazor (Web Push)
- Core - hosting, DI, key/value stores, object-store binding, lifecycle hooks, connectivity & battery monitoring, and the platform abstractions every Shiny module builds on
AI Tools
Optional *.Extensions.AI packages expose Shiny modules as Microsoft.Extensions.AI tool functions (AIFunctions) for LLM agents. You opt-in exactly which operations the model can see - a read/write allow-list you control on behalf of the agent (this is not an OS permission prompt; the underlying platform permissions must already be granted). Resolve the generated *AITools bundle from DI and pass .Tools to any IChatClient. All are AOT-compatible (hand-built schemas, no reflection).
- Shiny.Contacts.Extensions.AI -
AddContactsAITools(...)→search_contacts,get_contact, and (write)create_contact,update_contact,delete_contact - Shiny.Calendar.Extensions.AI -
AddCalendarAITools(...)→list_calendars,search_events,get_event, and independently opt-increate_event,update_event,delete_event(per-operationRead/Create/Update/Deletecapability flags). Capabilities apply to every calendar by default, or per calendar id -AddCalendar(workId, All)alongside a globalReadgives the agent read-only access everywhere but read/write on one calendar, andNonehides a calendar entirely - Shiny.Notifications.Extensions.AI -
AddNotificationAITools(...)→ reminder-framedlist_reminders, and (write)create_reminder(one-time or daily),cancel_reminder - Shiny.Locations.Extensions.AI -
AddLocationAITool()→ read-onlyget_current_location,get_distance_to,estimate_travel_time
builder.Services.AddContactStore();
builder.Services.AddContactsAITools(b => b.AddContacts(ContactAICapabilities.ReadWrite));
builder.Services.AddNotifications();
builder.Services.AddNotificationAITools(b => b.AddReminders(ReminderAICapabilities.ReadWrite));
builder.Services.AddGps();
builder.Services.AddLocationAITool();
// later, hand the tools to a chat client
var tools = sp.GetRequiredService<ContactAITools>().Tools;
var response = await chatClient.GetResponseAsync(messages, new ChatOptions { Tools = [.. tools] });
Links
Showing the top 20 packages that depend on Shiny.Core.
| Packages | Downloads |
|---|---|
|
Shiny.Hosting.Maui
Shiny
|
6 |
|
Shiny.Jobs
Shiny Background Jobs
|
6 |
|
Shiny.Support.Repositories
Shiny
|
6 |
|
Shiny.Support.DeviceMonitoring
Shiny Support Library for connectivity and battery
|
6 |
|
Shiny.Support.DeviceMonitoring
Shiny Support Library for connectivity and battery
|
5 |
|
Shiny.Support.Repositories
Shiny Internal Repository Library
|
5 |
|
Shiny.Support.Repositories
Shiny
|
5 |
https://shinylib.net/client/release-notes
.NET 10.0
- Microsoft.Extensions.DependencyInjection (>= 10.0.7)
- Microsoft.Extensions.Logging (>= 10.0.7)
- Shiny.Extensions.DependencyInjection (>= 5.1.4)
- Shiny.Extensions.Stores (>= 5.1.4)
- Shiny.Extensions.Serialization (>= 5.1.4)
.NET 10.0
- Microsoft.Extensions.Logging (>= 10.0.7)
- Shiny.Extensions.DependencyInjection (>= 5.1.4)
- Shiny.Extensions.Stores (>= 5.1.4)
- Shiny.Extensions.Serialization (>= 5.1.4)
- Microsoft.Extensions.DependencyInjection (>= 10.0.7)
.NET 10.0
- Microsoft.Extensions.DependencyInjection (>= 10.0.7)
- Microsoft.Extensions.Logging (>= 10.0.7)
- Shiny.Extensions.DependencyInjection (>= 5.1.4)
- Shiny.Extensions.Serialization (>= 5.1.4)
- Shiny.Extensions.Stores (>= 5.1.4)
.NET 10.0
- Shiny.Extensions.Serialization (>= 5.1.4)
- Shiny.Extensions.Stores (>= 5.1.4)
- Microsoft.Extensions.Logging (>= 10.0.7)
- Shiny.Extensions.DependencyInjection (>= 5.1.4)
- Microsoft.Extensions.DependencyInjection (>= 10.0.7)
.NET 10.0
- Microsoft.Extensions.DependencyInjection (>= 10.0.7)
- Microsoft.Extensions.Logging (>= 10.0.7)
- Shiny.Extensions.DependencyInjection (>= 5.1.4)
- Shiny.Extensions.Stores (>= 5.1.4)
- Shiny.Extensions.Serialization (>= 5.1.4)
.NET 10.0
- Microsoft.Extensions.DependencyInjection (>= 10.0.7)
- Shiny.Extensions.DependencyInjection (>= 5.1.4)
- Shiny.Extensions.Stores (>= 5.1.4)
- Microsoft.Extensions.Logging (>= 10.0.7)
- Xamarin.AndroidX.Lifecycle.Common (>= 2.11.0.1)
- Xamarin.AndroidX.Lifecycle.Process (>= 2.11.0.1)
- Shiny.Extensions.Serialization (>= 5.1.4)
- Xamarin.AndroidX.Lifecycle.Runtime (>= 2.11.0.1)
- Xamarin.AndroidX.Lifecycle.Runtime.Android (>= 2.11.0.1)
- Xamarin.AndroidX.Core (>= 1.19.0.1)