.Net Aspire - Add Swagger, OpenApi, Scalar to the AppHost

Before you begin, If you are not familar with OpenApi, Swagger or Scalar please read this article :
net-9-revolutionizing-documentation-of-apis-from-swashbuckle-to-scalar

You can have ApiDocs and also your custom links in your .Net Aspire Dashboard like this :

Simply install this nuget package Arshid.Aspire.ApiDocs.Extensions to your AppHost.csproj

dotnet add package Arshid.Aspire.ApiDocs.Extensions

Then add these lines for the project that has Swagger, Scalar or etc.

📦 Example

using Arshid.Aspire.ApiDocs.Extensions;

var apiService = builder.AddProject<Projects.AspireApp1_ApiService>("apiservice")
    .WithScalar()
    .WithSwagger()
    .WithOpenApi()
    .WithCustomUrl("https://127.0.0.1:5000/CustomRoute/CustomPage1")
    .WithRoute("/CustomRoute/CustomPage2"); //The URL become something like this {protocol}://{url}:{port}/CustomRoute/CustomPage2

Source Codes are available here in GitHub:
https://github.com/zandiarash/Arshid-Aspire-ApiDocs-Extensions

Nuget Package:
Arshid.Aspire.ApiDocs.Extensions