chore: upgrade to .NET 10, migrate to .slnx, bump to 0.4.0-alpha.1

.github/workflows/ci.yml

@@ -25,16 +25,16 @@ jobs:
       uses: actions/setup-dotnet@v4
       with:
         dotnet-version: |
-          9.0.x
+          10.0.x
 
     - name: Restore dependencies
-      run: dotnet restore ShellUI.sln
+      run: dotnet restore ShellUI.slnx
 
     - name: Build
-      run: dotnet build ShellUI.sln --no-restore --configuration Release
+      run: dotnet build ShellUI.slnx --no-restore --configuration Release
 
     - name: Run tests
-      run: dotnet test ShellUI.sln --no-restore --no-build --configuration Release --verbosity normal
+      run: dotnet test ShellUI.slnx --no-restore --no-build --configuration Release --verbosity normal
 
     # End-to-end build of a scaffolded project — catches anything the in-process
     # TemplateCompileTests miss (missing usings, dependency resolution).

.github/workflows/preview-pages.yml

@@ -5,7 +5,7 @@ on:
   push:
     branches: [ main ]
     paths:
-      - 'NET9/ShellUI.Preview/**'
+      - 'NET10/ShellUI.Preview/**'
       - 'src/ShellUI.Components/**'
       - '.github/workflows/preview-pages.yml'
   workflow_dispatch:
@@ -28,11 +28,11 @@ jobs:
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
-          dotnet-version: '9.0.x'
+          dotnet-version: '10.0.x'
 
       - name: Publish Preview (Blazor WASM)
         run: |
-          dotnet publish NET9/ShellUI.Preview/ShellUI.Preview.csproj \
+          dotnet publish NET10/ShellUI.Preview/ShellUI.Preview.csproj \
             -c Release \
             -o ./preview-publish
         env:

.github/workflows/release.yml

@@ -23,7 +23,7 @@ jobs:
     - name: Setup .NET
       uses: actions/setup-dotnet@v4
       with:
-        dotnet-version: '9.0.x'
+        dotnet-version: '10.0.x'
 
     - name: Cache NuGet packages
       uses: actions/cache@v4
@@ -34,16 +34,16 @@ jobs:
           ${{ runner.os }}-nuget-
 
     - name: Restore dependencies
-      run: dotnet restore ShellUI.sln
+      run: dotnet restore ShellUI.slnx
 
     - name: Build
-      run: dotnet build ShellUI.sln --no-restore --configuration Release
+      run: dotnet build ShellUI.slnx --no-restore --configuration Release
 
     - name: Run tests
-      run: dotnet test ShellUI.sln --no-restore --no-build --configuration Release --verbosity normal
+      run: dotnet test ShellUI.slnx --no-restore --no-build --configuration Release --verbosity normal
 
     - name: Pack NuGet packages
-      run: dotnet pack ShellUI.sln --no-build --configuration Release -p:ContinuousIntegrationBuild=true
+      run: dotnet pack ShellUI.slnx --no-build --configuration Release -p:ContinuousIntegrationBuild=true
 
     # ShellUI.Core and ShellUI.Templates are internal-only — they have no public API
     # surface that consumers reference. Only the CLI tool and the Components runtime

.gitignore

@@ -9,7 +9,7 @@
 *.user
 *.userosscache
 *.sln.docstates
-
+*.sln
 # User-specific files (MonoDevelop/Xamarin Studio)
 *.userprefs
 

Directory.Build.props

@@ -2,8 +2,8 @@
 <Project>
   <!-- Centralized ShellUI Version - Update this single file to version all components -->
   <PropertyGroup>
-    <ShellUIVersion>0.3.0</ShellUIVersion>
-    <ShellUIVersionSuffix>rc.1</ShellUIVersionSuffix>
+    <ShellUIVersion>0.4.0</ShellUIVersion>
+    <ShellUIVersionSuffix>alpha.1</ShellUIVersionSuffix>
   </PropertyGroup>
 
   <!-- Common properties for all ShellUI projects -->

NET9/BlazorInteractiveServer/BlazorInteractiveServer.csproj → NET10/BlazorInteractiveServer/BlazorInteractiveServer.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
   </PropertyGroup>

NET9/ShellUI.Preview/ShellUI.Preview.csproj → NET10/ShellUI.Preview/ShellUI.Preview.csproj

@@ -1,16 +1,16 @@
 <Project Sdk="Microsoft.NET.Sdk.BlazorWebAssembly">
 
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <OverrideHtmlAssetPlaceholders>true</OverrideHtmlAssetPlaceholders>
     <RootNamespace>ShellUI.Preview</RootNamespace>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="9.0.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="9.0.0" PrivateAssets="all" />
+    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="10.0.0" />
+    <PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="10.0.0" PrivateAssets="all" />
   </ItemGroup>
 
   <ItemGroup>

ShellUI.Tests/IntegrationTest1.cs

@@ -66,7 +66,7 @@ private async Task<int> RunShellUICommand(string args)
     {
         // Get the path to the CLI from the test directory perspective
         var solutionDir = Path.GetFullPath(Path.Combine(Directory.GetCurrentDirectory(), ".."));
-        var cliPath = Path.Combine(solutionDir, "src", "ShellUI.CLI", "bin", "Release", "net9.0", "ShellUI.CLI.dll");
+        var cliPath = Path.Combine(solutionDir, "src", "ShellUI.CLI", "bin", "Release", "net10.0", "ShellUI.CLI.dll");
 
         var process = new Process
         {

ShellUI.Tests/ShellUI.Tests.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <IsPackable>false</IsPackable>

ShellUI.slnx

@@ -0,0 +1,14 @@
+<Solution>
+  <Configurations>
+    <Platform Name="Any CPU" />
+    <Platform Name="x64" />
+    <Platform Name="x86" />
+  </Configurations>
+  <Folder Name="/src/">
+    <Project Path="src/ShellUI.CLI/ShellUI.CLI.csproj" />
+    <Project Path="src/ShellUI.Components/ShellUI.Components.csproj" />
+    <Project Path="src/ShellUI.Core/ShellUI.Core.csproj" />
+    <Project Path="src/ShellUI.Templates/ShellUI.Templates.csproj" />
+  </Folder>
+  <Project Path="ShellUI.Tests/ShellUI.Tests.csproj" />
+</Solution>

docs/ARCHITECTURE.md

@@ -49,7 +49,7 @@ When you run `shellui add button`, that counts as **1 component**. Dependencies
 - **src/ShellUI.Core/** – ComponentMetadata, ShellUIConfig
 - **src/ShellUI.Templates/** – 139 component templates (embedded in CLI)
 - **src/ShellUI.Components/** – NuGet package
-- **NET9/** – Blazor demo app
+- **NET10/** – Blazor demo app
 - **docs/** – Documentation
 
 ## Core Principles

docs/PROJECT_STATUS.md

@@ -88,7 +88,7 @@ Counts are top-level components users invoke directly via `shellui add <name>`.
 ## How to Get Started with Development
 
 ### Prerequisites
-- .NET 9.0 SDK or higher (components target .NET 9.0)
+- .NET 10.0 SDK or higher (components target .NET 10.0)
 - Git
 - Visual Studio 2022 or VS Code
 - Basic understanding of Blazor
@@ -129,7 +129,7 @@ dotnet shellui add button input card
 
 3. **Run the demo**
    ```bash
-   cd NET9/BlazorInteractiveServer
+   cd NET10/BlazorInteractiveServer
    dotnet run
    ```
 
@@ -157,10 +157,10 @@ dotnet shellui add button input card
 **Rationale:** Full customization, no version lock-in, better debugging  
 **Trade-off:** Users manage updates manually
 
-### 4. .NET 9.0 Target
-**Decision:** Target .NET 9.0  
-**Rationale:** Latest features, best performance, modern Blazor capabilities  
-**Impact:** Requires .NET 9.0 SDK or higher
+### 4. .NET 10.0 Target
+**Decision:** Target .NET 10.0 (LTS)
+**Rationale:** Long-term support through Nov 2028, latest C# 14 features, modern Blazor capabilities including the asset-fingerprinting `@Assets[...]` helper that init now patches
+**Impact:** Requires .NET 10.0 SDK or higher. Users on .NET 8 LTS can stay on `ShellUI 0.3.x` until they upgrade — we can multi-target `net8.0;net10.0` later if enterprise demand justifies it.
 
 ### 5. Accessibility First
 **Decision:** WCAG 2.1 AA compliance required for all components  

docs/tailwind-setup.md

@@ -18,7 +18,7 @@ This guide shows you how to set up Tailwind CSS for a new Blazor project using t
 
 ## Prerequisites
 
-- .NET 9.0 SDK
+- .NET 10.0 SDK
 - A Blazor project (new or existing)
 
 ## Method 1: Using ShellUI CLI (Recommended)

global.json

@@ -1,6 +1,6 @@
 {
   "sdk": {
-    "version": "9.0.100",
+    "version": "10.0.100",
     "rollForward": "latestFeature",
     "allowPrerelease": false
   }

src/ShellUI.CLI/ShellUI.CLI.csproj

@@ -12,7 +12,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
 

src/ShellUI.Components/ShellUI.Components.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
 
@@ -21,9 +21,6 @@
     <IncludeSymbols>true</IncludeSymbols>
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
 
-    <!-- Disable static web assets compression for packaging (.NET 10 SDK bug workaround) -->
-    <EnableStaticWebAssetsCompression>false</EnableStaticWebAssetsCompression>
-    <StaticWebAssetsBuildMode Condition="'$(ContinuousIntegrationBuild)' == 'true'">Default</StaticWebAssetsBuildMode>
   </PropertyGroup>
 
 
@@ -32,7 +29,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.AspNetCore.Components.Web" Version="9.0.6" />
+    <PackageReference Include="Microsoft.AspNetCore.Components.Web" Version="10.0.0" />
     <PackageReference Include="System.Linq.Dynamic.Core" Version="1.7.1" />
     <PackageReference Include="Blazor-ApexCharts" Version="6.0.2" />
   </ItemGroup>

src/ShellUI.Core/ShellUI.Core.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
     <!-- Internal library — consumed only by ShellUI.CLI. Not published to NuGet. -->

src/ShellUI.Templates/ShellUI.Templates.csproj

@@ -5,7 +5,7 @@
   </ItemGroup>
 
   <PropertyGroup>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>