Add GitHubStars component and update docs

aritchie · aritchie · commit d1ccc9fdcc18 · 2026-03-02T17:21:25.000-05:00
Introduce a GitHubStars.astro component that embeds a shields.io GitHub stars badge linking to a repo, and replace inline "GitHub Repository" links across multiple docs to use this component. Also fix NuGet badge URLs in NugetBadge.astro and NugetBadge.tsx by removing the duplicated ?style param and adding the NuGet logo (&amp;logo=nuget). Changes touch the new component and many docs (aspire, data, extensions, maui, mediator, etc.) to import and render the new badge.
diff --git a/src/components/GitHubStars.astro b/src/components/GitHubStars.astro
@@ -0,0 +1,12 @@
+---
+export interface Props {
+    org: string;
+    repo: string;
+}
+
+const { org, repo } = Astro.props as Props;
+
+const shieldsUrl = `https://img.shields.io/github/stars/${org}/${repo}?style=for-the-badge&logo=github`;
+const repoUrl = `https://github.com/${org}/${repo}`;
+---
+<a href={repoUrl} target="_blank" rel="noopener noreferrer"><img src={shieldsUrl} alt={`GitHub stars for ${org}/${repo}`} /></a>
diff --git a/src/components/NugetBadge.astro b/src/components/NugetBadge.astro
@@ -10,7 +10,7 @@ export interface Props {
 const { name, showPreviewVersion, showLabel } = Astro.props as Props;
 
 const v = showPreviewVersion === true ? 'vpre' : 'v';
-let imgUrl: string = `https://img.shields.io/nuget/${v}/${name}?style=for-the-badge?style=for-the-badge`;
+let imgUrl: string = `https://img.shields.io/nuget/${v}/${name}?style=for-the-badge&logo=nuget`;
 if (showLabel === true) {
     imgUrl += `&label=${name}`;
 }
diff --git a/src/components/NugetBadge.tsx b/src/components/NugetBadge.tsx
@@ -9,7 +9,7 @@ export interface Props {
   
 const NugetBadge = (props: Props) => {
     const v = props.showPreviewVersion === true ? 'vpre' : 'v';
-    let imgUrl: string = `https://img.shields.io/nuget/${v}/${props.name}?style=for-the-badge`;
+    let imgUrl: string = `https://img.shields.io/nuget/${v}/${props.name}?style=for-the-badge&logo=nuget`;
     if (props.showLabel === true) {
         imgUrl += `&label=${props.name}`;
     }
diff --git a/src/content/docs/aspire/gluetun/index.mdx b/src/content/docs/aspire/gluetun/index.mdx
@@ -3,11 +3,12 @@ title: Getting Started
 description: Aspire hosting integration for Gluetun VPN containers
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 Aspire hosting integration for [Gluetun](https://github.com/qdm12/gluetun), a lightweight VPN client container supporting 30+ providers. Models Gluetun as a first-class Aspire resource and lets other containers route their traffic through the VPN tunnel.
 
-- [GitHub Repository](https://github.com/shinyorg/aspire)
+- <GitHubStars org="shinyorg" repo="aspire" />
 - [Gluetun Wiki](https://github.com/qdm12/gluetun-wiki)
 
 ## Package
diff --git a/src/content/docs/aspire/orleans/index.mdx b/src/content/docs/aspire/orleans/index.mdx
@@ -3,11 +3,12 @@ title: Getting Started
 description: Zero-friction integration between .NET Aspire and Microsoft Orleans for ADO.NET storage backends
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 Zero-friction integration between [.NET Aspire](https://learn.microsoft.com/dotnet/aspire/) and [Microsoft Orleans](https://learn.microsoft.com/dotnet/orleans/) for ADO.NET storage backends. Automatically provisions Orleans database schemas and wires up clustering, grain persistence, and reminders from Aspire configuration — no manual SQL scripts or connection string plumbing required.
 
-- [GitHub Repository](https://github.com/shinyorg/aspire)
+- <GitHubStars org="shinyorg" repo="aspire" />
 
 ## Packages
 
diff --git a/src/content/docs/data/spatial/geofencing.mdx b/src/content/docs/data/spatial/geofencing.mdx
@@ -7,7 +7,7 @@ import { Steps } from '@astrojs/starlight/components';
 
 GPS-driven geofence monitoring for iOS and Android. Built on [Shiny.Locations](/client/locations/gps) for background GPS and [Shiny.Spatial](/data/spatial/) for spatial queries.
 
-- [GitHub Repository](https://github.com/shinyorg/spatialdb)
+- <GitHubStars org="shinyorg" repo="geospatialdb" />
 - <NugetBadge name="Shiny.Spatial.Geofencing" showLabel={true} />
 
 ## Why Spatial Geofencing?
diff --git a/src/content/docs/data/spatial/index.mdx b/src/content/docs/data/spatial/index.mdx
@@ -3,11 +3,12 @@ title: Getting Started
 description: A dependency-free, cross-platform .NET geospatial database powered by SQLite R*Tree indexing
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 A lightweight, dependency-free geospatial database for .NET that combines SQLite R*Tree spatial indexing with custom C# geometry algorithms for high-performance spatial queries. No SpatiaLite, no NetTopologySuite — just SQLite and math.
 
-- [GitHub Repository](https://github.com/shinyorg/spatialdb)
+- <GitHubStars org="shinyorg" repo="geospatialdb" />
 - <NugetBadge name="Shiny.Spatial" showLabel={true} />
 
 ## Features
diff --git a/src/content/docs/data/sqlite-docdb/index.mdx b/src/content/docs/data/sqlite-docdb/index.mdx
@@ -2,11 +2,12 @@
 title: SQLite Document DB
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 A lightweight SQLite-based document store for .NET that turns SQLite into a schema-free JSON document database with LINQ querying and full AOT/trimming support. Store entire object graphs — nested objects, child collections — as JSON documents. No `CREATE TABLE`, no `ALTER TABLE`, no JOINs, no migrations.
 
-- [GitHub Repository](https://github.com/shinyorg/SqliteDocumentDb)
+- <GitHubStars org="shinyorg" repo="SqliteDocumentDb" />
 - <NugetBadge name="Shiny.SqliteDocumentDb" showLabel={true} />
 
 ## Features
diff --git a/src/content/docs/extensions/di/index.mdx b/src/content/docs/extensions/di/index.mdx
@@ -2,11 +2,12 @@
 title: Dependency Injection
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 Stop manually wiring up every service in your DI container. Shiny Extensions DI uses source generators to scan your attributed classes at compile time and generate all your registrations into a single file. Add an attribute, and it's registered — no reflection, no startup cost, fully AOT-compatible.
 
-- [GitHub Repository](https://github.com/shinyorg/extensions)
+- <GitHubStars org="shinyorg" repo="extensions" />
 - <NugetBadge name="Shiny.Extensions.DependencyInjection" />
 
 ## Features
diff --git a/src/content/docs/extensions/localizegen/index.mdx b/src/content/docs/extensions/localizegen/index.mdx
@@ -2,11 +2,12 @@
 title: Localization Generator
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 `Microsoft.Extensions.Localization` provides great abstractions, but you lose the strong typing and IDE tooling that `.resx` files originally gave you. This library fixes that — it source-generates a strongly-typed class for each `.resx` file, giving you compile-time safety, IntelliSense, and format-string methods with the correct number of parameters.
 
-- [GitHub Repository](https://github.com/shinyorg/localizegen)
+- <GitHubStars org="shinyorg" repo="localizegen" />
 - <NugetBadge name="Shiny.Extensions.Localization.Generator" />
 
 ## Features
diff --git a/src/content/docs/extensions/reflector/index.mdx b/src/content/docs/extensions/reflector/index.mdx
@@ -2,11 +2,12 @@
 title: Reflector
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 Reflection is powerful but slow, and it breaks AOT compilation. Shiny Reflector uses C# source generators to give you the same dynamic property access — without any runtime reflection. Just add an attribute, mark your class `partial`, and you get compile-time generated property enumeration, reading, writing, and JSON serialization.
 
-- [GitHub Repository](https://github.com/shinyorg/reflector)
+- <GitHubStars org="shinyorg" repo="reflector" />
 - <NugetBadge name="Shiny.Reflector" />
 
 ## Features
diff --git a/src/content/docs/extensions/stores/index.mdx b/src/content/docs/extensions/stores/index.mdx
@@ -2,11 +2,12 @@
 title: Stores
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 Persist class properties across sessions with a single line of code. Shiny Stores provides a cross-platform key/value store abstraction that works on iOS, Android, Windows, and Blazor WebAssembly. Swap between Preferences, Secure Storage, Local Storage, and more — all behind the same API.
 
-- [GitHub Repository](https://github.com/shinyorg/extensions)
+- <GitHubStars org="shinyorg" repo="extensions" />
 - NuGet Packages
     - <NugetBadge name="Shiny.Extensions.Stores" showLabel={true} />
     - <NugetBadge name="Shiny.Extensions.Stores.Web" showLabel={true} />
diff --git a/src/content/docs/extensions/webhost/index.mdx b/src/content/docs/extensions/webhost/index.mdx
@@ -2,11 +2,12 @@
 title: Web Hosting
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 ASP.NET applications often end up with a bloated `Program.cs` where every cross-cutting concern — authentication, CORS, Swagger, logging, health checks — is mixed together. Shiny Web Hosting lets you break that apart into modular `IInfrastructureModule` classes, each responsible for its own service registration and middleware configuration. Modules are discovered automatically, keeping your startup clean.
 
-- [GitHub Repository](https://github.com/shinyorg/extensions)
+- <GitHubStars org="shinyorg" repo="extensions" />
 - <NugetBadge name="Shiny.Extensions.WebHosting" />
 
 ## Features
diff --git a/src/content/docs/maui/shell/index.mdx b/src/content/docs/maui/shell/index.mdx
@@ -3,13 +3,14 @@ title: Shell | Getting Started
 description: ViewModel lifecycle management, navigation, and source generation for .NET MAUI Shell
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 Make .NET MAUI Shell shinier with viewmodel lifecycle management, navigation, and source generation to remove boilerplate, reduce errors, and make your app testable.
 
 Inspired by [Prism Library](https://prismlibrary.com) by Dan Siegel and Brian Lagunas.
 
-- [GitHub Repository](https://github.com/shinyorg/maui)
+- <GitHubStars org="shinyorg" repo="maui" />
 - <NugetBadge name="Shiny.Maui.Shell" showLabel={true} />
 
 ## Features
diff --git a/src/content/docs/maui/tableview/index.mdx b/src/content/docs/maui/tableview/index.mdx
@@ -2,11 +2,12 @@
 title: TableView | Getting Started
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 A settings-style TableView for .NET MAUI, inspired by [AiForms.Maui.SettingsView](https://github.com/muak/AiForms.Maui.SettingsView) by Kaoru Nakamura (muak).
 
-- [GitHub Repository](https://github.com/shinyorg/shinytableview)
+- <GitHubStars org="shinyorg" repo="tableview" />
 - <NugetBadge name="Shiny.Maui.TableView" showLabel={true} />
 
 ## How It's Different
diff --git a/src/content/docs/maui/templates/index.mdx b/src/content/docs/maui/templates/index.mdx
@@ -2,11 +2,12 @@
 title: Templates
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 import { Steps } from '@astrojs/starlight/components';
 
 Shiny.Templates is the fastest way to get a .NET MAUI app up and running with all the Shiny libraries. Skip the boilerplate — permissions, plists, entitlements, platform-specific files, DI wiring, and logging are all set up for you. Just pick your options and start building.
 
-- [GitHub Repository](https://github.com/shinyorg/templates)
+- <GitHubStars org="shinyorg" repo="templates" />
 - <NugetBadge name="Shiny.Templates" />
 
 ## Features
diff --git a/src/content/docs/mediator/index.mdx b/src/content/docs/mediator/index.mdx
@@ -2,6 +2,7 @@
 title: Introduction
 ---
 import NugetBadge from '/src/components/NugetBadge.tsx';
+import GitHubStars from '/src/components/GitHubStars.astro';
 
 
 # What Is It?
@@ -12,6 +13,8 @@ Shiny Mediator <NugetBadge name="Shiny.Mediator" /> is a mediator pattern implem
 
 Inspired by [MediatR](https://github.com/jbogard/mediatr), Shiny Mediator drops server-centric features that don't translate well to apps and adds capabilities that mobile and desktop developers actually need.
 
+- <GitHubStars org="shinyorg" repo="mediator" />
+
 ### Samples
 
 - [End-to-End Architectural Sample](https://github.com/shinyorg/mediatorsample)

Original file line number	Diff line number	Diff line change
`@@ -10,7 +10,7 @@ export interface Props {`
`10`	`10`	`const { name, showPreviewVersion, showLabel } = Astro.props as Props;`
`11`	`11`
`12`	`12`	`const v = showPreviewVersion === true ? 'vpre' : 'v';`
`13`		-let imgUrl: string = `https://img.shields.io/nuget/${v}/${name}?style=for-the-badge?style=for-the-badge`;
	`13`	+let imgUrl: string = `https://img.shields.io/nuget/${v}/${name}?style=for-the-badge&logo=nuget`;
`14`	`14`	`if (showLabel === true) {`
`15`	`15`	imgUrl += `&label=${name}`;
`16`	`16`	`}`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@ export interface Props {`
`9`	`9`
`10`	`10`	`const NugetBadge = (props: Props) => {`
`11`	`11`	`const v = props.showPreviewVersion === true ? 'vpre' : 'v';`
`12`		- let imgUrl: string = `https://img.shields.io/nuget/${v}/${props.name}?style=for-the-badge`;
	`12`	+ let imgUrl: string = `https://img.shields.io/nuget/${v}/${props.name}?style=for-the-badge&logo=nuget`;
`13`	`13`	`if (props.showLabel === true) {`
`14`	`14`	imgUrl += `&label=${props.name}`;
`15`	`15`	`}`