Add build.cs script and enable Dockerfile-free container publishing

- Add build.cs using Bullseye + SimpleExec for unified build orchestration
- Configure dotnet publish /t:PublishContainer for container builds
- Update CI workflows to use build.cs commands
- Fix Aspire.Hosting.AppHost version (9.2.0 -> 13.1.0)
- Remove Dockerfile, .dockerignore, and astro/build.sh (no longer needed)
- Update README with new build commands and project structure

Author: damianh

.dockerignore

@@ -16,9 +16,17 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
+      
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
         with:
-          submodules: true
-      - name: build
-        run: |
-          docker build .
+          dotnet-version: '10.0.x'
+          
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          
+      - name: Build container
+        run: dotnet build.cs container

.github/workflows/ci.yml

@@ -4,9 +4,6 @@ on:
   workflow_dispatch:
   schedule:
     - cron: "0 10 * * 0"
-  #push:
-  #  branches:
-  #    - main
   pull_request:
     types: [opened, synchronize, reopened, closed]
     branches:
@@ -21,22 +18,25 @@ jobs:
       issues: write
     name: Link Checker Job
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
+      
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
         with:
-          submodules: true
-      - name: Setup Node
+          dotnet-version: '10.0.x'
+          
+      - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 22
-      - name: Run build
-        working-directory: astro
-        run: |
-          npm ci
-          ./build.sh
+          node-version: '22'
+          
+      - name: Build Astro
+        run: dotnet build.cs astro-build
+        
       - name: Link Checker
         uses: lycheeverse/lychee-action@v2
         env:
           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
         with:
-          args: '--header ''x-origin-verify: ${{ secrets.ORIGIN_VERIFICATION_HEADER_VALUE }}'' --no-progress --max-concurrency 8 --skip-missing --accept 200,429 --exclude-path astro/root/_llms-txt --exclude-path astro/root/llms.txt --exclude-path astro/root/llms-full.txt --exclude-path astro/root/llms-small.txt --exclude-loopback --require-https --exclude sample.duendesoftware.com --exclude "docs.duendesoftware.com/404" --exclude sitemap --exclude "https://github.com/DuendeArchive/IdentityModel.AspNetCore/" --root-dir "$PWD/astro/root" astro/root/**'
+          args: '--header ''x-origin-verify: ${{ secrets.ORIGIN_VERIFICATION_HEADER_VALUE }}'' --no-progress --max-concurrency 8 --skip-missing --accept 200,429 --exclude-path server/Docs.Web/wwwroot/_llms-txt --exclude-path server/Docs.Web/wwwroot/llms.txt --exclude-path server/Docs.Web/wwwroot/llms-full.txt --exclude-path server/Docs.Web/wwwroot/llms-small.txt --exclude-loopback --require-https --exclude sample.duendesoftware.com --exclude "docs.duendesoftware.com/404" --exclude sitemap --exclude "https://github.com/DuendeArchive/IdentityModel.AspNetCore/" --root-dir "$PWD/server/Docs.Web/wwwroot" server/Docs.Web/wwwroot/**'
           fail: true

.github/workflows/link-checker.yml

@@ -1,6 +1,7 @@
 # Astro build output
 astro/dist/
 astro/root/
+server/Docs.Web/wwwroot/
 # generated types
 astro/.astro/
 

.gitignore

@@ -4,66 +4,73 @@ Welcome to the documentation of all [Duende Software](https://duendesoftware.com
 
 ## Getting Started
 
-You will need Node 22+ installed on your operating system and available in the PATH.
+You will need the following installed:
+- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
+- Node.js 22+
+
+### Quick Start (Astro only)
 
 ```bash
 cd astro
 npm install
 npm run dev
 ```
 
-Alternatively in VS Code, GitHub Codespaces, or WebStorm, you can use the devcontainer to get a development environment set up.
-
-## Development with .NET Aspire
-
-For local development with the full stack (Astro dev server + ASP.NET Core), you can use .NET Aspire:
+### Development with .NET Aspire
 
-### Prerequisites
-
-- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
-- Node.js 22+
-
-### Running with Aspire
+For local development with the full stack (Astro dev server + ASP.NET Core):
 
 ```bash
-cd server
-dotnet run --project Docs.AppHost
+dotnet build.cs aspire
 ```
 
 This starts:
-
 - **Astro dev server** at http://localhost:4321 (with hot reload)
 - **ASP.NET Core server** (for production-like static file serving)
 - **Aspire Dashboard** at https://localhost:17001 (for traces, logs, metrics)
 
-## Docker
+Alternatively in VS Code, GitHub Codespaces, or WebStorm, you can use the devcontainer to get a development environment set up.
 
-### Building the Docker image
+## Build Commands
 
-```bash
-docker build -t docs-duende .
-```
+All commands use the `build.cs` file-based build script and can be run from any directory in the repository:
+
+| Command | Action |
+| :------ | :----- |
+| `dotnet build.cs` | Build everything (Astro + .NET) |
+| `dotnet build.cs astro-build` | Build Astro to wwwroot |
+| `dotnet build.cs dotnet-build` | Build .NET solution |
+| `dotnet build.cs container` | Build container image |
+| `dotnet build.cs aspire` | Start Aspire dev environment |
+| `dotnet build.cs clean` | Clean all build outputs |
+| `dotnet build.cs verify-formatting` | Check .NET code formatting |
+| `dotnet build.cs --list-targets` | List all available targets |
+
+## Container
+
+The container is built using `dotnet publish /t:PublishContainer` (no Dockerfile required).
 
-### Running the Docker container
+### Building the container
 
 ```bash
-docker run -p 8080:8080 docs-duende
+dotnet build.cs container
 ```
 
-The site will be available at http://localhost:8080.
-
-### Building with version tag
+### Running the container
 
 ```bash
-docker build --build-arg APPLICATION_VERSION=1.0.0 -t docs-duende .
+docker run -p 8080:8080 docs
 ```
 
+The site will be available at http://localhost:8080.
+
 ## Project Structure
 
 This project uses Astro + Starlight for the documentation site, served by ASP.NET Core in production.
 
 ```
 .
+├── build.cs                  # File-based build script
 ├── astro/                    # Astro documentation site
 │   ├── public/
 │   ├── src/
@@ -76,6 +83,7 @@ This project uses Astro + Starlight for the documentation site, served by ASP.NE
 │   └── tsconfig.json
 └── server/                   # ASP.NET Core server
     ├── Docs.Web/             # Static file server
+    │   └── wwwroot/          # Astro build output (gitignored)
     ├── Docs.AppHost/         # .NET Aspire orchestrator
     └── Docs.ServiceDefaults/ # Shared configuration
 ```
@@ -115,7 +123,7 @@ WebStorm has Grazie as a built-in spell checker and grammar checker, and support
 - When linking to external resources, use the full URL using HTTPS.
 - You can link to header anchors using the `#` symbol, for example `[multiple authentication methods](/identityserver/ui/federation.md#multiple-authentication-methods-for-users)`.
 - Link relevant text. Prefer `learn more about [improving the sign-in experience]` over `click [here] to learn more`.
-- Run `npm run linkchecker` to validate all links (note this will ignore links to GitHub because of rate limits in place).
+- Run `dotnet build.cs link-check` to build Astro for link validation (actual lychee check runs in CI).
 - When a markdown link is long (75+ characters) or a link is repeated multiple times on a page, prefer moving the link to the bottom of the file and using markdown anchor syntax `[test.cs][repo-test-file]`
 
 ### Markdown Style
@@ -156,17 +164,15 @@ WebStorm has Grazie as a built-in spell checker and grammar checker, and support
 
 ## 🧞 Commands
 
-All commands are run from the `astro/` directory, from a terminal:
-
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./root/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
-| `npm run linkchecker`     | Run lychee link checker                          |
+Astro commands are run from the `astro/` directory:
+
+| Command | Action |
+| :------ | :----- |
+| `npm install` | Installs dependencies |
+| `npm run dev` | Starts local dev server at `localhost:4321` |
+| `npm run build` | Build production site (use `dotnet build.cs astro-build` instead) |
+| `npm run preview` | Preview your build locally |
+| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |
 
 ## 🔀 Redirects
 

Dockerfile

@@ -30,6 +30,8 @@
     "@fontsource/roboto": "^5.2.9",
     "@pasqal-io/starlight-client-mermaid": "^0.1.0",
     "@resvg/resvg-js": "^2.6.2",
+    "@resvg/resvg-js-win32-x64-msvc": "^2.6.2",
+    "@rollup/rollup-win32-x64-msvc": "^4.55.1",
     "astro": "^5.17.1",
     "astro-opengraph-images": "^1.14.2",
     "astro-redirect-from": "^1.3.4",

README.md

@@ -0,0 +1,83 @@
+#:package Bullseye@5.0.0
+#:package SimpleExec@12.0.0
+
+using Bullseye;
+using static Bullseye.Targets;
+using static SimpleExec.Command;
+
+// Find repository root
+var repoRoot = Directory.GetCurrentDirectory();
+while (!Directory.Exists(Path.Combine(repoRoot, ".git")))
+{
+    repoRoot = Directory.GetParent(repoRoot)?.FullName
+        ?? throw new InvalidOperationException("Could not find repository root");
+}
+
+var astroDir = Path.Combine(repoRoot, "astro");
+var serverDir = Path.Combine(repoRoot, "server");
+var wwwrootDir = Path.Combine(serverDir, "Docs.Web", "wwwroot");
+
+// Target names
+const string Restore = "restore";
+const string AstroInstall = "astro-install";
+const string AstroBuild = "astro-build";
+const string DotnetBuild = "dotnet-build";
+const string DotnetPublish = "dotnet-publish";
+const string Build = "build";
+const string Container = "container";
+const string Aspire = "aspire";
+const string LinkCheck = "link-check";
+const string VerifyFormatting = "verify-formatting";
+const string Clean = "clean";
+const string Default = "default";
+
+// Restore/Install
+Target(Restore, () =>
+    RunAsync("dotnet", "restore Docs.slnx", workingDirectory: serverDir));
+
+// Use 'npm install' instead of 'npm ci' due to npm bug with optional dependencies on Windows
+// See: https://github.com/npm/cli/issues/4828
+Target(AstroInstall, () =>
+    RunAsync("npm", "install", workingDirectory: astroDir));
+
+// Build
+Target(AstroBuild, dependsOn: [AstroInstall], () =>
+    RunAsync("npm", "run build -- --outDir ../server/Docs.Web/wwwroot", workingDirectory: astroDir));
+
+Target(DotnetBuild, dependsOn: [Restore], () =>
+    RunAsync("dotnet", "build Docs.slnx --no-restore", workingDirectory: serverDir));
+
+Target(DotnetPublish, dependsOn: [Restore], () =>
+    RunAsync("dotnet", "publish Docs.Web/Docs.Web.csproj -c Release --no-restore",
+        workingDirectory: serverDir));
+
+Target(Build, dependsOn: [AstroBuild, DotnetBuild]);
+
+// Container (no Dockerfile needed!)
+Target(Container, dependsOn: [AstroBuild], () =>
+    RunAsync("dotnet", "publish Docs.Web/Docs.Web.csproj -c Release /t:PublishContainer",
+        workingDirectory: serverDir));
+
+// Dev
+Target(Aspire, () =>
+    RunAsync("dotnet", "run --project Docs.AppHost", workingDirectory: serverDir));
+
+// Quality - Link check builds Astro; actual lychee runs in CI workflow due to secrets
+Target(LinkCheck, dependsOn: [AstroBuild], () =>
+    Console.WriteLine($"Astro built to {wwwrootDir}. Run lychee manually or via CI workflow."));
+
+Target(VerifyFormatting, dependsOn: [Restore], () =>
+    RunAsync("dotnet", "format Docs.slnx --verify-no-changes --no-restore",
+        workingDirectory: serverDir));
+
+// Clean
+Target(Clean, async () =>
+{
+    await RunAsync("dotnet", "clean Docs.slnx", workingDirectory: serverDir);
+    if (Directory.Exists(wwwrootDir))
+        Directory.Delete(wwwrootDir, recursive: true);
+});
+
+Target(Default, dependsOn: [Build]);
+
+await RunTargetsAndExitAsync(args);