Feature/admin sidebar layout

.aspire/settings.json

@@ -0,0 +1,3 @@
+{
+  "appHostPath": "../SimpleModule.AppHost/SimpleModule.AppHost.csproj"
+}

.claude/agents/generator-reviewer.md

@@ -8,7 +8,5 @@ Review source generator code in SimpleModule.Generator for correctness and best
 2. **Generator API**: Must use `IIncrementalGenerator`, not `ISourceGenerator` (enforced by `EnforceExtendedAnalyzerRules`)
 3. **Symbol comparison**: Always use `SymbolEqualityComparer.Default.Equals()`, never `==` on symbols
 4. **Fully qualified names**: Generated code must use `global::Namespace.Type` format from `SymbolDisplayFormat.FullyQualifiedFormat`
-5. **No reflection**: Generated code must use direct `new` instantiation, no DI resolution of `IModule`
-6. **Cross-assembly discovery**: Generator must scan `compilation.References` for module types, not just syntax in the current project
-7. **Nullable handling**: Use `#nullable enable` in generated code or handle nulls explicitly
-8. **AOT compliance**: Generated code must not use patterns that require runtime code generation
+5. **Cross-assembly discovery**: Generator must scan `compilation.References` for module types, not just syntax in the current project
+6. **Nullable handling**: Use `#nullable enable` in generated code or handle nulls explicitly

.claude/settings.local.json

@@ -29,7 +29,23 @@
       "mcp__plugin_playwright_playwright__browser_press_key",
       "mcp__plugin_playwright_playwright__browser_run_code",
       "mcp__plugin_playwright_playwright__browser_network_requests",
-      "mcp__plugin_playwright_playwright__browser_console_messages"
+      "mcp__plugin_playwright_playwright__browser_console_messages",
+      "mcp__aspire__list_apphosts",
+      "mcp__aspire__select_apphost",
+      "mcp__aspire__list_resources",
+      "mcp__aspire__list_console_logs",
+      "mcp__aspire__execute_resource_command",
+      "mcp__playwright__browser_navigate",
+      "mcp__playwright__browser_click",
+      "mcp__playwright__browser_take_screenshot",
+      "mcp__playwright__browser_evaluate",
+      "mcp__playwright__browser_snapshot",
+      "mcp__playwright__browser_resize"
     ]
-  }
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "aspire",
+    "playwright"
+  ]
 }

.claude/skills/new-module/SKILL.md

@@ -65,7 +65,6 @@ public class <Name>Module : IModule
 6. Run `dotnet build` to verify the source generator picks up the new module
 
 ## Important
-- Do NOT add `PublishAot` or `EnableAotAnalyzer` to module class libraries
 - Always include `<FrameworkReference Include="Microsoft.AspNetCore.App" />`
 - Use `[Module("<Name>")]` attribute on the module class
 - Use fully qualified ASP.NET Core usings (Builder, Http, Routing, DependencyInjection)

.editorconfig

@@ -155,6 +155,10 @@ dotnet_diagnostic.IDE0072.severity = none
 [*.Generated.cs]
 generated_code = true
 
+# EF Core migrations (auto-generated — suppress strict analysis)
+[**/Migrations/*.cs]
+generated_code = true
+
 [*.g.cs]
 generated_code = true
 

.github/workflows/ci.yml

@@ -71,6 +71,12 @@ jobs:
         env:
           Database__DefaultConnection: "Host=localhost;Database=simplemodule_test;Username=test;Password=test"
 
+      - name: Verify migrations are up-to-date
+        working-directory: template/SimpleModule.Host
+        env:
+          Database__DefaultConnection: "Host=localhost;Database=simplemodule_test;Username=test;Password=test"
+        run: dotnet ef migrations has-pending-model-changes
+
   publish:
     runs-on: ubuntu-latest
     needs: [test-sqlite, test-postgresql]
@@ -84,5 +90,5 @@ jobs:
         with:
           dotnet-version: '10.0.x'
 
-      - name: Publish AOT
+      - name: Publish
         run: dotnet publish template/SimpleModule.Host/SimpleModule.Host.csproj -c Release

.mcp.json

@@ -0,0 +1,18 @@
+{
+  "mcpServers": {
+    "aspire": {
+      "command": "aspire",
+      "args": [
+        "mcp",
+        "start"
+      ]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@playwright/mcp@latest"
+      ]
+    }
+  }
+}

AGENTS.md

@@ -0,0 +1,61 @@
+# Copilot instructions
+
+This repository is set up to use Aspire. Aspire is an orchestrator for the entire application and will take care of configuring dependencies, building, and running the application. The resources that make up the application are defined in `apphost.cs` including application code and external dependencies.
+
+## General recommendations for working with Aspire
+1. Before making any changes always run the apphost using `aspire run` and inspect the state of resources to make sure you are building from a known state.
+1. Changes to the _apphost.cs_ file will require a restart of the application to take effect.
+2. Make changes incrementally and run the aspire application using the `aspire run` command to validate changes.
+3. Use the Aspire MCP tools to check the status of resources and debug issues.
+
+## Running the application
+To run the application run the following command:
+
+```
+aspire run
+```
+
+If there is already an instance of the application running it will prompt to stop the existing instance. You only need to restart the application if code in `apphost.cs` is changed, but if you experience problems it can be useful to reset everything to the starting state.
+
+## Checking resources
+To check the status of resources defined in the app model use the _list resources_ tool. This will show you the current state of each resource and if there are any issues. If a resource is not running as expected you can use the _execute resource command_ tool to restart it or perform other actions.
+
+## Listing integrations
+IMPORTANT! When a user asks you to add a resource to the app model you should first use the _list integrations_ tool to get a list of the current versions of all the available integrations. You should try to use the version of the integration which aligns with the version of the Aspire.AppHost.Sdk. Some integration versions may have a preview suffix. Once you have identified the correct integration you should always use the _get integration docs_ tool to fetch the latest documentation for the integration and follow the links to get additional guidance.
+
+## Debugging issues
+IMPORTANT! Aspire is designed to capture rich logs and telemetry for all resources defined in the app model. Use the following diagnostic tools when debugging issues with the application before making changes to make sure you are focusing on the right things.
+
+1. _list structured logs_; use this tool to get details about structured logs.
+2. _list console logs_; use this tool to get details about console logs.
+3. _list traces_; use this tool to get details about traces.
+4. _list trace structured logs_; use this tool to get logs related to a trace
+
+## Other Aspire MCP tools
+
+1. _select apphost_; use this tool if working with multiple app hosts within a workspace.
+2. _list apphosts_; use this tool to get details about active app hosts.
+
+## Playwright MCP server
+
+The playwright MCP server has also been configured in this repository and you should use it to perform functional investigations of the resources defined in the app model as you work on the codebase. To get endpoints that can be used for navigation using the playwright MCP server use the list resources tool.
+
+## Updating the app host
+The user may request that you update the Aspire apphost. You can do this using the `aspire update` command. This will update the apphost to the latest version and some of the Aspire specific packages in referenced projects, however you may need to manually update other packages in the solution to ensure compatibility. You can consider using the `dotnet-outdated` with the users consent. To install the `dotnet-outdated` tool use the following command:
+
+```
+dotnet tool install --global dotnet-outdated-tool
+```
+
+## Persistent containers
+IMPORTANT! Consider avoiding persistent containers early during development to avoid creating state management issues when restarting the app.
+
+## Aspire workload
+IMPORTANT! The aspire workload is obsolete. You should never attempt to install or use the Aspire workload.
+
+## Official documentation
+IMPORTANT! Always prefer official documentation when available. The following sites contain the official documentation for Aspire and related components
+
+1. https://aspire.dev
+2. https://learn.microsoft.com/dotnet/aspire
+3. https://nuget.org (for specific integration package details)

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## What This Is
 
-Modular monolith framework for .NET with compile-time module discovery via Roslyn source generators. Fully AOT-compatible — no reflection. Frontend uses React 19 + Inertia.js served via Blazor SSR.
+Modular monolith framework for .NET with compile-time module discovery via Roslyn source generators. Frontend uses React 19 + Inertia.js served via Blazor SSR.
 
 ## Build & Run
 
@@ -40,8 +40,8 @@ Test stack: xUnit.v3, FluentAssertions, Bogus, Microsoft.AspNetCore.Mvc.Testing.
 ### .NET Backend
 
 - **SimpleModule.Core** — `IModule` interface, `[Module]` attribute, `IEndpoint` interface, `[Dto]` attribute, menu system (`IMenuRegistry`), event bus (`IEventBus`), Inertia integration.
-- **SimpleModule.Generator** — Roslyn `IIncrementalGenerator` (netstandard2.0). Scans referenced assemblies for `[Module]` classes, `IEndpoint` implementors, and `[Dto]` types. Generates: `AddModules()`, `MapModuleEndpoints()`, `CollectModuleMenuItems()`, AOT JSON serializers, TypeScript interface definitions, Razor component assembly discovery.
-- **SimpleModule.Host** — Host app (net10.0, PublishAot). Calls generated extension methods in `Program.cs`. Custom Inertia middleware bridges Blazor SSR → React.
+- **SimpleModule.Generator** — Roslyn `IIncrementalGenerator` (netstandard2.0). Scans referenced assemblies for `[Module]` classes, `IEndpoint` implementors, and `[Dto]` types. Generates: `AddModules()`, `MapModuleEndpoints()`, `CollectModuleMenuItems()`, JSON serializers, TypeScript interface definitions, Razor component assembly discovery.
+- **SimpleModule.Host** — Host app (net10.0). Calls generated extension methods in `Program.cs`. Custom Inertia middleware bridges Blazor SSR → React.
 
 ### Frontend (React + Inertia.js)
 
@@ -58,9 +58,8 @@ Test stack: xUnit.v3, FluentAssertions, Bogus, Microsoft.AspNetCore.Mvc.Testing.
 
 ## Key Constraints
 
-- **No reflection** — source generator emits static `new ModuleName()` calls for AOT.
 - **Source generator must target netstandard2.0** with `IIncrementalGenerator` (not `ISourceGenerator`).
-- **Module class libraries must NOT have `PublishAot`** — only the Host project. Modules need `<FrameworkReference Include="Microsoft.AspNetCore.App" />`.
+- Modules need `<FrameworkReference Include="Microsoft.AspNetCore.App" />`.
 - **Module Vite builds use library mode** — externalize React, React-DOM, @inertiajs/react. Inline dynamic imports.
 - **TreatWarningsAsErrors is enabled** globally via `Directory.Build.props` with `AnalysisLevel=latest-all` and `AnalysisMode=All`. Suppressed rules are listed in `.editorconfig`.
 

Directory.Packages.props

@@ -3,12 +3,23 @@
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
   </PropertyGroup>
   <ItemGroup>
+    <!-- Aspire -->
+    <PackageVersion Include="Aspire.Hosting.PostgreSQL" Version="13.1.2" />
+    <PackageVersion Include="Microsoft.Extensions.Http.Resilience" Version="10.1.0" />
+    <PackageVersion Include="Microsoft.Extensions.ServiceDiscovery" Version="10.1.0" />
+    <PackageVersion Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.14.0" />
+    <PackageVersion Include="OpenTelemetry.Extensions.Hosting" Version="1.14.0" />
+    <PackageVersion Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.14.0" />
+    <PackageVersion Include="OpenTelemetry.Instrumentation.Http" Version="1.14.0" />
+    <PackageVersion Include="OpenTelemetry.Instrumentation.Runtime" Version="1.14.0" />
     <!-- Analyzers -->
+    <PackageVersion Include="NetEscapades.EnumGenerators" Version="1.0.0-beta11" />
     <PackageVersion Include="Roslynator.Analyzers" Version="4.12.11" />
     <!-- Source Generator -->
     <PackageVersion Include="Microsoft.CodeAnalysis.Analyzers" Version="4.14.0" />
     <PackageVersion Include="Microsoft.CodeAnalysis.CSharp" Version="5.0.0" />
     <!-- EF Core -->
+    <PackageVersion Include="Microsoft.EntityFrameworkCore" Version="10.0.3" />
     <PackageVersion Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.3" />
     <PackageVersion Include="Microsoft.EntityFrameworkCore.Design" Version="10.0.3" />
     <PackageVersion Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="10.0.0" />
@@ -29,6 +40,8 @@
     <PackageVersion Include="NSubstitute" Version="5.3.0" />
     <PackageVersion Include="Bogus" Version="35.6.1" />
     <PackageVersion Include="Microsoft.AspNetCore.Mvc.Testing" Version="10.0.3" />
+    <!-- Value Objects -->
+    <PackageVersion Include="Vogen" Version="8.0.5" />
     <!-- CLI -->
     <PackageVersion Include="Spectre.Console.Cli" Version="0.49.1" />
   </ItemGroup>

README.md

@@ -1,6 +1,6 @@
 # SimpleModule
 
-A modular monolith framework for .NET with compile-time module discovery via Roslyn source generators. Fully AOT-compatible with no reflection. Frontend uses React 19 + Inertia.js served via Blazor SSR.
+A modular monolith framework for .NET with compile-time module discovery via Roslyn source generators. Frontend uses React 19 + Inertia.js served via Blazor SSR.
 
 ## Prerequisites
 

SimpleModule.AppHost/AppHost.cs

@@ -0,0 +1,17 @@
+var builder = DistributedApplication.CreateBuilder(args);
+
+var postgres = builder
+    .AddPostgres("postgres")
+    .WithDataVolume()
+    .WithPgAdmin()
+    .WithLifetime(ContainerLifetime.Persistent);
+
+var db = postgres.AddDatabase("simplemoduledb");
+
+builder
+    .AddProject<Projects.SimpleModule_Host>("simplemodule-host")
+    .WithExternalHttpEndpoints()
+    .WithReference(db)
+    .WaitFor(db);
+
+builder.Build().Run();

SimpleModule.AppHost/Properties/launchSettings.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json.schemastore.org/launchsettings.json",
+  "profiles": {
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "https://localhost:17119;http://localhost:15076",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development",
+        "DOTNET_ENVIRONMENT": "Development",
+        "ASPIRE_DASHBOARD_OTLP_ENDPOINT_URL": "https://localhost:21159",
+        "ASPIRE_DASHBOARD_MCP_ENDPOINT_URL": "https://localhost:23210",
+        "ASPIRE_RESOURCE_SERVICE_ENDPOINT_URL": "https://localhost:22061"
+      }
+    },
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "http://localhost:15076",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development",
+        "DOTNET_ENVIRONMENT": "Development",
+        "ASPIRE_DASHBOARD_OTLP_ENDPOINT_URL": "http://localhost:19205",
+        "ASPIRE_DASHBOARD_MCP_ENDPOINT_URL": "http://localhost:18194",
+        "ASPIRE_RESOURCE_SERVICE_ENDPOINT_URL": "http://localhost:20023"
+      }
+    }
+  }
+}

SimpleModule.AppHost/SimpleModule.AppHost.csproj

@@ -0,0 +1,15 @@
+<Project Sdk="Aspire.AppHost.Sdk/13.1.2">
+  <ItemGroup>
+    <ProjectReference Include="..\template\SimpleModule.Host\SimpleModule.Host.csproj" />
+  </ItemGroup>
+  <ItemGroup>
+    <PackageReference Include="Aspire.Hosting.PostgreSQL" />
+  </ItemGroup>
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <UserSecretsId>c74f53ec-e4b7-4a9e-b41c-d39a4ebc0274</UserSecretsId>
+  </PropertyGroup>
+</Project>

SimpleModule.AppHost/appsettings.Development.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}

SimpleModule.AppHost/appsettings.json

@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning",
+      "Aspire.Hosting.Dcp": "Warning"
+    }
+  }
+}