diff --git a/Api/src/Api.csproj b/Api/src/Api.csproj
index cd894b2..19578d6 100644
--- a/Api/src/Api.csproj
+++ b/Api/src/Api.csproj
@@ -12,6 +12,7 @@
     <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" />
     <PackageReference Include="OpenTelemetry.Extensions.Hosting" />
     <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" />
+    <PackageReference Include="Scalar.AspNetCore" />
     <PackageReference Include="ServiceLevelIndicators.Asp.ApiVersioning" />
     <PackageReference Include="Swashbuckle.AspNetCore" />
   </ItemGroup>
diff --git a/Api/src/ConfigureSwaggerOptions.cs b/Api/src/ConfigureSwaggerOptions.cs
index 1667155..7ae6414 100644
--- a/Api/src/ConfigureSwaggerOptions.cs
+++ b/Api/src/ConfigureSwaggerOptions.cs
@@ -11,8 +11,9 @@
 /// <summary>
 /// Configure the Swashbuckle options, which defines the document endpoints and high-level documentation (e.g. description)
 /// </summary>
-/// <remarks>This allows API versioning to define a Swagger document per API version after the
-/// <see cref="IApiVersionDescriptionProvider"/> service has been resolved from the service container.</remarks>
+/// <remarks>This allows API versioning to define an OpenAPI document per API version after the
+/// <see cref="IApiVersionDescriptionProvider"/> service has been resolved from the service container.
+/// These documents are consumed by Scalar for API documentation.</remarks>
 public class ConfigureSwaggerOptions : IConfigureOptions<SwaggerGenOptions>
 {
     private readonly IApiVersionDescriptionProvider provider;
@@ -36,7 +37,7 @@ public void Configure(SwaggerGenOptions options)
 
     private static OpenApiInfo CreateInfoForApiVersion(ApiVersionDescription description)
     {
-        var text = new StringBuilder("An example application with OpenAPI, Swashbuckle, and API versioning.");
+        var text = new StringBuilder("An example application with OpenAPI, Scalar, and API versioning.");
         var info = new OpenApiInfo()
         {
             Title = "Best Weather forecast API",
diff --git a/Api/src/Program.cs b/Api/src/Program.cs
index 80ec165..08aea76 100644
--- a/Api/src/Program.cs
+++ b/Api/src/Program.cs
@@ -2,6 +2,7 @@
 using BestWeatherForecast.Api;
 using BestWeatherForecast.Api.Middleware;
 using BestWeatherForecast.Application;
+using Scalar.AspNetCore;
 using ServiceLevelIndicators;
 
 var builder = WebApplication.CreateBuilder(args);
@@ -17,21 +18,18 @@
 
 if (app.Environment.IsDevelopment())
 {
-    app.UseSwagger();
-    app.UseSwaggerUI(
-        options =>
+    app.MapSwagger("/openapi/{documentName}.json");
+    app.MapScalarApiReference(options =>
+    {
+        options.WithTitle("Best Weather Forecast API");
+        var descriptions = app.DescribeApiVersions();
+
+        // Add all API version documents to Scalar
+        foreach (var description in descriptions)
         {
-            options.RoutePrefix = string.Empty; // make home page the swagger UI
-            var descriptions = app.DescribeApiVersions();
-
-            // build a swagger endpoint for each discovered API version
-            foreach (var description in descriptions)
-            {
-                var url = $"/swagger/{description.GroupName}/swagger.json";
-                var name = description.GroupName.ToUpperInvariant();
-                options.SwaggerEndpoint(url, name);
-            }
-        });
+            options.AddDocument(description.GroupName, $"/openapi/{description.GroupName}.json");
+        }
+    });
 }
 
 app.UseHttpsRedirection();
diff --git a/Directory.Packages.props b/Directory.Packages.props
index caf7b23..50cadd2 100644
--- a/Directory.Packages.props
+++ b/Directory.Packages.props
@@ -29,6 +29,7 @@
     <PackageVersion Include="OpenTelemetry.Extensions.Hosting" Version="1.14.0" />
     <PackageVersion Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.14.0" />
     <PackageVersion Include="ServiceLevelIndicators.Asp.ApiVersioning" Version="8.0.1" />
+    <PackageVersion Include="Scalar.AspNetCore" Version="2.11.8" />
     <PackageVersion Include="Swashbuckle.AspNetCore" Version="10.1.0" />
     <PackageVersion Include="System.Text.Json" Version="10.0.1" />
   </ItemGroup>
diff --git a/README.md b/README.md
index 4363b40..a46b79e 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,12 @@ Here is a more elaborate sample code [BuberDinner](https://github.com/xavierjohn
 To get started with this template, All you need to do is download the repository to your local development environment, rename it to your project and use it. This template comes with all layers already implemented along with the Unit Tests in place.
 This is not a Visual Studio project template.
 
+### API Documentation
+
+The template uses [Scalar](https://github.com/scalar/scalar) for interactive API documentation. When running in development mode, you can access the API documentation at `/scalar` which provides a modern, developer-friendly interface for exploring and testing your API endpoints.
+
+The documentation is automatically generated from OpenAPI specifications and supports API versioning out of the box.
+
 ## Lets talk a little bit more about the layers implemented in the Template
 
 ### Domain Layer