Scalar.AspNetCore
1.2.67
See the version list below for details.
dotnet add package Scalar.AspNetCore --version 1.2.67
NuGet\Install-Package Scalar.AspNetCore -Version 1.2.67
<PackageReference Include="Scalar.AspNetCore" Version="1.2.67" />
paket add Scalar.AspNetCore --version 1.2.67
#r "nuget: Scalar.AspNetCore, 1.2.67"
// Install Scalar.AspNetCore as a Cake Addin #addin nuget:?package=Scalar.AspNetCore&version=1.2.67 // Install Scalar.AspNetCore as a Cake Tool #tool nuget:?package=Scalar.AspNetCore&version=1.2.67
Scalar .NET API Reference Integration
This .NET package Scalar.AspNetCore
provides an easy way to render beautiful API references based on OpenAPI/Swagger documents.
Made possible by the wonderful work of @captainsafia on building the integration and docs written for the Scalar & .NET integration. Thanks to @xC0dex for making it awesome.
Usage
- Install the package
dotnet add package Scalar.AspNetCore --version 1.2.*
[!NOTE] We release new versions frequently to bring you the latest features and bug fixes. To reduce the noise in your project file, we recommend using a wildcard for the patch version, e.g.,
1.2.*
.
- Add the using directive
using Scalar.AspNetCore;
- Configure your application
Add the following to Program.cs
based on your OpenAPI generator:
For .NET 9 using Microsoft.AspNetCore.OpenApi
:
builder.Services.AddOpenApi();
if (app.Environment.IsDevelopment())
{
app.MapOpenApi();
app.MapScalarApiReference();
}
For .NET 8 using Swashbuckle
:
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
if (app.Environment.IsDevelopment())
{
app.UseSwagger(options =>
{
options.RouteTemplate = "/openapi/{documentName}.json";
});
app.MapScalarApiReference();
}
For .NET 8 using NSwag
:
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddOpenApiDocument();
if (app.Environment.IsDevelopment())
{
app.UseOpenApi(options =>
{
options.Path = "/openapi/{documentName}.json";
});
app.MapScalarApiReference();
}
That’s it! 🎉 With the default settings, you can now access the Scalar API reference at /scalar/v1
in your browser, where v1
is the default document name.
Configuration
For a full configuration guide, including OAuth integration and custom settings, refer to the dotnet integration documentation.
Development
- Download .NET 9.0
- Jump to the package folder:
cd packages/scalar.aspnetcore
- Do a fresh build:
dotnet build
- Run the tests:
dotnet test
And see it in action here:
- Switch to the playground:
cd playground/Scalar.AspNetCore.Playground
- Start the playground:
dotnet run
- Open this URL in the browser: http://localhost:5056/scalar/v1
Community
We are API nerds. You too? Let’s chat on Discord: https://discord.gg/scalar
License
The source code in this repository is licensed under MIT.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. |
-
net8.0
- No dependencies.
-
net9.0
- No dependencies.
NuGet packages (24)
Showing the top 5 NuGet packages that depend on Scalar.AspNetCore:
Package | Downloads |
---|---|
devprime.stack.web
DevPrime Web |
|
ShayganTadbir.Framework.Core
Package description |
|
Corner49.Infra
An opinionated set of infrastructure libraries for .Net applications |
|
ZStack.AspNetCore
ZStack.AspNetCore框架 |
|
chd.Api.Base
Package Description |
GitHub repositories (21)
Showing the top 5 popular GitHub repositories that depend on Scalar.AspNetCore:
Repository | Stars |
---|---|
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
|
|
dotnet/eShop
A reference .NET application implementing an eCommerce site
|
|
davidfowl/TodoApp
Todo application with ASP.NET Core Blazor WASM, Minimal APIs and Authentication
|
|
GZTimeWalker/GZCTF
The GZ::CTF project, an open source CTF platform.
|
|
meysamhadeli/booking-microservices
Practical microservices, built with .Net 9, DDD, CQRS, Event Sourcing, Vertical Slice Architecture, Event-Driven Architecture, and the latest technologies.
|
Version | Downloads | Last updated |
---|---|---|
1.2.76 | 0 | 1/13/2025 |
1.2.75 | 2,150 | 1/11/2025 |
1.2.74 | 4,776 | 1/8/2025 |
1.2.73 | 1,699 | 1/7/2025 |
1.2.72 | 21,051 | 12/24/2024 |
1.2.71 | 2,146 | 12/23/2024 |
1.2.70 | 3,776 | 12/22/2024 |
1.2.69 | 901 | 12/22/2024 |
1.2.68 | 1,347 | 12/21/2024 |
1.2.67 | 438 | 12/20/2024 |
1.2.66 | 2,591 | 12/20/2024 |
1.2.65 | 326 | 12/19/2024 |
1.2.64 | 4,922 | 12/18/2024 |
1.2.63 | 3,227 | 12/18/2024 |
1.2.61 | 2,036 | 12/17/2024 |
1.2.60 | 1,197 | 12/17/2024 |
1.2.59 | 238 | 12/17/2024 |
1.2.58 | 120 | 12/16/2024 |
1.2.57 | 875 | 12/16/2024 |
1.2.56 | 5,117 | 12/15/2024 |
1.2.55 | 3,147 | 12/13/2024 |
1.2.54 | 170 | 12/13/2024 |
1.2.53 | 6,399 | 12/11/2024 |
1.2.52 | 755 | 12/11/2024 |
1.2.51 | 6,978 | 12/10/2024 |
1.2.50 | 3,260 | 12/9/2024 |
1.2.49 | 8,647 | 12/6/2024 |
1.2.48 | 3,475 | 12/5/2024 |
1.2.47 | 4,500 | 12/4/2024 |
1.2.46 | 747 | 12/4/2024 |
1.2.45 | 63,306 | 11/27/2024 |
1.2.44 | 17,535 | 11/23/2024 |
1.2.43 | 1,038 | 11/22/2024 |
1.2.42 | 7,892 | 11/21/2024 |
1.2.41 | 8,284 | 11/20/2024 |
1.2.40 | 630 | 11/19/2024 |
1.2.39 | 10,536 | 11/17/2024 |
1.2.38 | 247 | 11/16/2024 |
1.2.37 | 7,878 | 11/14/2024 |
1.2.36 | 10,299 | 11/13/2024 |
1.2.35 | 2,024 | 11/12/2024 |
1.2.34 | 8,561 | 11/10/2024 |
1.2.33 | 2,294 | 11/8/2024 |
1.2.32 | 282 | 11/7/2024 |
1.2.31 | 3,452 | 11/6/2024 |
1.2.30 | 2,071 | 11/4/2024 |
1.2.29 | 4,201 | 11/1/2024 |
1.2.28 | 969 | 11/1/2024 |
1.2.27 | 5,486 | 10/30/2024 |
1.2.26 | 2,102 | 10/30/2024 |
1.2.25 | 2,181 | 10/29/2024 |
1.2.24 | 885 | 10/28/2024 |
1.2.23 | 3,716 | 10/27/2024 |
1.2.22 | 2,688 | 10/24/2024 |
1.2.21 | 3,083 | 10/23/2024 |
1.2.20 | 609 | 10/22/2024 |
1.2.19 | 105 | 10/22/2024 |
1.2.18 | 4,452 | 10/20/2024 |
1.2.17 | 356 | 10/20/2024 |
1.2.16 | 597 | 10/19/2024 |
1.2.15 | 513 | 10/19/2024 |
1.2.14 | 219 | 10/18/2024 |
1.2.13 | 199 | 10/18/2024 |
1.2.12 | 852 | 10/18/2024 |
1.2.11 | 215 | 10/17/2024 |
1.2.10 | 2,759 | 10/17/2024 |
1.2.9 | 12,744 | 10/7/2024 |
1.2.8 | 419 | 10/7/2024 |
1.2.7 | 657 | 10/3/2024 |
1.2.6 | 236 | 10/2/2024 |
1.2.5 | 1,280 | 9/28/2024 |
1.2.4 | 2,861 | 9/22/2024 |
1.2.3 | 5,360 | 9/6/2024 |
1.1.2 | 10,764 | 7/18/2024 |
1.1.1 | 4,805 | 5/21/2024 |
1.0.1 | 584 | 5/15/2024 |