From 28179a995eba87acc735736251ce081cd0b85242 Mon Sep 17 00:00:00 2001
From: tiger tiger tiger <tiger@tiger.blue>
Date: Fri, 17 Jul 2026 07:33:58 +0200
Subject: [PATCH] feat: samples default to local project reference, and can
 optionally use the nuget package

---
 Examples/Examples.csproj |  8 ++++++--
 README.md                | 16 ++++++++++++++++
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/Examples/Examples.csproj b/Examples/Examples.csproj
index 77212a1..f574465 100644
--- a/Examples/Examples.csproj
+++ b/Examples/Examples.csproj
@@ -52,10 +52,14 @@
         <Using Include="System.Numerics"/>
     </ItemGroup>
 
-    <ItemGroup>
+    <ItemGroup Condition="'$(UseRaylibCsPackage)' != 'true'">
         <ProjectReference Include="..\Raylib-cs\Raylib-cs.csproj"/>
     </ItemGroup>
-    <Import Project="..\Raylib-cs\Raylib-cs.targets"/>
+    <Import Project="..\Raylib-cs\Raylib-cs.targets" Condition="'$(UseRaylibCsPackage)' != 'true'"/>
+
+    <ItemGroup Condition="'$(UseRaylibCsPackage)' == 'true'">
+        <PackageReference Include="Raylib-cs" Version="$(RaylibCsVersion)"/>
+    </ItemGroup>
 
     <ItemGroup Condition="'$(RuntimeIdentifier)' == 'browser-wasm'">
         <WasmExtraFilesToDeploy Include="Web/index.html" TargetPath="index.html"/>
diff --git a/README.md b/README.md
index 18a8839..34b73d0 100644
--- a/README.md
+++ b/README.md
@@ -96,6 +96,22 @@ internal static class Program
 }
 ```
 
+## Building the examples locally
+
+The `Examples` project references the sibling `Raylib-cs` project by default, so local changes to the
+bindings are picked up directly:
+
+```
+dotnet run --project Examples
+```
+
+To build the examples against the Raylib-cs NuGet package instead (the version set by
+`RaylibCsVersion` in [Directory.Build.props](Directory.Build.props)), set `UseRaylibCsPackage`:
+
+```
+dotnet run --project Examples -p:UseRaylibCsPackage=true
+```
+
 ## Contributing
 
 Feel free to open an issue. If you'd like to contribute, please fork the repository and make