Templates
Shiny.Templates is the fastest way to spin up a new project on the Shiny stack — MAUI apps, ASP.NET API/service hosts, and Blazor WebAssembly clients. Skip the boilerplate — permissions, plists, entitlements, platform files, DI wiring, auth, persistence, and logging are all set up for you. Just pick your options and start building.
| GitHub | |
| Downloads |
What’s in the box
Section titled “What’s in the box”Three project templates, three item templates, and a browser-based builder that produces the same output as dotnet new — without installing the SDK pack.
| Template | Short name | Description |
|---|---|---|
| .NET MAUI Application | shinymaui | Cross-platform iOS / Android / Mac Catalyst / Windows app with the full Shiny client stack |
| ASP.NET Application | shinyaspnet | API + service host with Mediator endpoints, EF Core or DocumentDb, JWT auth, Orleans, SignalR, and Scalar |
| Blazor WebAssembly | shinyblazor | Standalone WASM client with optional MudBlazor / Radzen / FluentUI and Shiny extensions |
Features
Section titled “Features”- All three templates use .NET 10 (
net10.0) as the baseline - Multiple UI markup options — XAML, Blazor Hybrid, or C# Markup (MAUI); MudBlazor, Radzen, or FluentUI (Blazor / Blazor Hybrid)
- MVVM choices — Shiny MAUI Shell, Prism, ReactiveUI, or none
- Push notifications — native, Azure Notification Hubs, or Firebase Cloud Messaging
- Authentication — MAUI Web Authenticator, MSAL (Basic / B2C / Broker); ASP.NET adds JWT + Google / Facebook / Apple
- DocumentDb provider choice — SQLite, SqlCipher, SQL Server, MySQL, PostgreSQL, Cosmos DB, MongoDB, LiteDB, DuckDB (server), or IndexedDB (browser)
- AI tools — Microsoft.Extensions.AI, Shiny Mediator AI Tools, Shell AI Tools, DocumentDB AI Tools, and Shiny AI Conversation
- Speech (STT/TTS) and audio — Shiny.Speech wired for MAUI native APIs and the browser Web Speech API
- Shiny.Maui.Controls suite — Scheduler, BottomSheet, ImageViewer, PillView, SecurityPin, Fab/FabMenu, Markdown, Mermaid Diagrams, Barcodes & QR codes, and a Desktop pack (Tray, Docking, On-Screen Keyboard)
- Shiny.Blazor.Controls suite — Markdown, Mermaid Diagrams, Barcodes, and a Kiosk pack
- Per-platform MAUI toggles —
useios,useandroid,usemaccatalyst,usewindowsscope the TFM list and prunePlatforms/{platform}/folders - Localization — source-generated Shiny localization on by default for ASP.NET, optional for MAUI / Blazor
- AppSettings.json — generated with strongly-typed settings classes (MAUI) and platform overlays
- Dependency injection — pre-configured with
Shiny.Extensions.DependencyInjectionsource generators - Shiny startup services — scaffolded and registered (delegates, push, jobs, gps, geofencing, BLE, BLE hosting, deep links, app actions)
- Android Auto & iOS CarPlay — optional MAUI support
- Apple PrivacyInfo.xcprivacy — generation assistance included
- MAUI DevFlow — debug-only visual tree / profiling / network monitor / AI agent toolkit
- 50+ curated community and Microsoft libraries — pre-configured and AOT-compatible where possible
-
Install the templates:
Terminal window dotnet new install Shiny.Templates -
Create a new project:
Terminal window # MAUIdotnet new shinymaui -n MyApp# ASP.NETdotnet new shinyaspnet -n MyApi# Blazor WASMdotnet new shinyblazor -n MyClient
Works with Visual Studio 2022 (Windows & Mac), JetBrains Rider 2024+, and the .NET CLI on macOS, Linux, and Windows. For interactive option pickers without installing the pack, use the Template Builder.
What’s Included
Section titled “What’s Included”MAUI App Template (shinymaui)
Section titled “MAUI App Template (shinymaui)”The shinymaui template scaffolds a full cross-platform mobile app with:
- Per-platform TFM toggles for iOS, Android, Mac Catalyst, and Windows
- Dependency injection pre-wired in
MauiProgram.cs - AppSettings.json with strongly-typed settings classes and platform overlays
- Shiny startup service scaffolding (push, jobs, gps, geofencing, BLE, deep links, app actions)
- DocumentDb (SQLite) for local persistence with optional AI tools
- Optional MAUI DevFlow for debug-time diagnostics
- Optional Sentry.IO error tracking and performance monitoring
- Localization setup with source-generated resource accessors
ASP.NET Template (shinyaspnet)
Section titled “ASP.NET Template (shinyaspnet)”The shinyaspnet template scaffolds an API + service host with:
- Shiny Mediator endpoints, middleware, and source-generated handlers
- Entity Framework Core (SQL Server or PostgreSQL, with optional NetTopologySuite spatial)
- Shiny.DocumentDb with provider choice (10 providers, including Cosmos DB and MongoDB)
- JWT bearer authentication with refresh tokens + sample sign-in / sign-out handlers
- Optional Google, Facebook, and Apple social auth
- Microsoft Orleans (clustering, persistence, reminders, streams, dashboard)
- SignalR sample hub
- Scalar OpenAPI documentation UI
- Sample
apple-app-site-associationandassetlinks.jsonfor mobile deep links
Blazor WebAssembly Template (shinyblazor)
Section titled “Blazor WebAssembly Template (shinyblazor)”The shinyblazor template scaffolds a standalone WASM client with:
- UI component library choice — MudBlazor, Radzen, or Microsoft FluentUI
- Shiny Mediator with Blazor extensions
- Shiny Blazor Controls plus Markdown, Mermaid, Barcodes, and Kiosk add-ons
- IndexedDB document store (
Shiny.DocumentDb.IndexedDb) - Web Bluetooth, browser geolocation, and web push (Chromium browsers)
- Web Speech (STT/TTS) and AI Conversation
- Shiny Extensions — Stores, Reflector, DI, Localization
Item Templates
Section titled “Item Templates”- BluetoothLE Hosted Managed Characteristic — scaffold a BLE GATT characteristic
- Shiny Job — scaffold a background job
Included Libraries
Section titled “Included Libraries”The templates integrate a curated set of Shiny, Microsoft, and community libraries. See Shiny Libraries and 3rd Party Libraries for the full list — every entry is opt-in via the template options.