Updates

Author: aritchie

astro.config.mjs

@@ -236,6 +236,10 @@ export default defineConfig({
             {
               label: 'Extensions',
               link: 'release-notes/extensions'
+            },
+            {
+              label: 'Templates',
+              link: 'release-notes/templates'
             }
           ]
         }

src/content/docs/mediator/extensions/blazor.mdx

@@ -28,4 +28,43 @@ simply pass false to the first argument in `UseMaui`
 * [User Notification Errors](/mediator/exceptionhandlers)
 * [Offline](/mediator/middleware/offline)
 * [Replay Stream](/mediator/middleware/replay)
-* [Persistent Caching](/mediator/middleware/caching)
+* [Persistent Caching](/mediator/middleware/caching)
+
+## Connectivity Broadcaster
+Connectivity is used on almost every page or viewmodel in an app.  You almost always have to inject the a connectivity service and hook the StateChanged event
+to do things like disabling buttons, showing errors, or putting up an banner to let you users know why your app isn't showing fresh data.  That's a lot of extra
+code, cleanup, hooks, etc.  This is where connectivity broadcaster comes in
+
+<Steps>
+1. In your main lastout, add the `<InternetConnectivity />` component
+   ```razor
+   <InternetConnectivity />
+   ```
+
+2. In your pages, controls (in scope of current page), or services, implement the `IConnectivityEventHandler` interface
+   ```csharp
+   public class MyService : Shiny.Mediator.IConnectivityEventHandler
+   {
+    
+       public async Task Handle(ConnectivityChanged @event, IMediatorContext context, CancellationToken ct)
+       {
+           // that's it
+           SomeString = @event.Connected ? "Connected" : "Disconnected";
+       }        
+   }
+   ```
+
+   OR
+
+   ```razor
+   @implements Shiny.Mediator.IConnectivityEventHandler
+   @code {
+        public async Task Handle(ConnectivityChanged @event, IMediatorContext context, CancellationToken ct)
+        {
+            // that's it
+            SomeString = @event.Connected ? "Connected" : "Disconnected";
+            await InvokeAsync(StateHasChanged);
+        }
+   }
+   ```
+</Steps>

src/content/docs/release-notes/mediator.mdx

@@ -2,12 +2,17 @@
 title: Mediator Releases
 tableOfContents: true
 ---
-
 import Aside from '/src/components/Alert.tsx';
 import RN from '/src/components/ReleaseNote.astro';
 
 ## v4
 
+### 4.9.0 - TBD
+<RN type="feature">Blazor now has a connectivity event broadcaster.  Simply add `<InternetConnectivity />` to your main layout (don't add more than 1)</RN>
+<RN type="enhancement">Blazor now has a `IConnectivityEventHandler` that you can implement to receive connectivity events</RN>
+<RN type="fix">Blazor connectivity handler was not broadcasting changes</RN>
+<RN type="fix" repo="mediator" githubNumber="39">Only release semaphore slim call, if that call passed the waitstate</RN>
+
 ### 4.8.0 - July 18, 2025
 <RN type="enhancement">User notification exception handler will no longer try to react for subrequests</RN>
 <RN type="enhancement">IMediatorContext.Exception is now set if an exception is thrown in the scope of a send/request</RN>

src/content/docs/release-notes/templates.mdx

@@ -0,0 +1,16 @@
+---
+title: Templates
+tableOfContents: true
+---
+import Aside from '/src/components/Alert.tsx';
+import RN from '/src/components/ReleaseNote.astro';
+
+Shiny.Templates is the fastest way to get a .NET MAUI app up and running with all the Shiny libraries.  It also includes TONS of 3rd party libraries and ensures all permissions, plists, entitlements, and other platform specific files are all set up for you.  It is the best way to get started with Shiny.
+
+```bash
+dotnet new --install Shiny.Templates
+```
+
+## v4.0
+<RN type="enhancement">Reorganize all 3rd party libraries and place category in front of each to improve clarity and ensure it is nicely organized on Visual Studio</RN>
+<RN type="enhancement">Remove old libraries that haven't been receiving updates</RN>