Scalar.AspNetCore 1.2.59

There is a newer version of this package available.
See the version list below for details.
dotnet add package Scalar.AspNetCore --version 1.2.59                
NuGet\Install-Package Scalar.AspNetCore -Version 1.2.59                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Scalar.AspNetCore" Version="1.2.59" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Scalar.AspNetCore --version 1.2.59                
#r "nuget: Scalar.AspNetCore, 1.2.59"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Scalar.AspNetCore as a Cake Addin
#addin nuget:?package=Scalar.AspNetCore&version=1.2.59

// Install Scalar.AspNetCore as a Cake Tool
#tool nuget:?package=Scalar.AspNetCore&version=1.2.59                

Scalar .NET API Reference Integration

Version Downloads Discord

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.

dotnet

Usage

  1. 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.*.

  1. Add the using directive
using Scalar.AspNetCore;
  1. 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

  1. Download .NET 9.0
  2. Jump to the package folder: cd packages/scalar.aspnetcore
  3. Do a fresh build: dotnet build
  4. Run the tests: dotnet test

And see it in action here:

  1. Switch to the playground: cd playground/Scalar.AspNetCore.Playground
  2. Start the playground: dotnet run
  3. 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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.
  • net9.0

    • No dependencies.

NuGet packages (15)

Showing the top 5 NuGet packages that depend on Scalar.AspNetCore:

Package Downloads
devprime.stack.web

DevPrime Web

Corner49.Infra

An opinionated set of infrastructure libraries for .Net applications

ZStack.AspNetCore

ZStack.AspNetCore框架

chd.Api.Base

Package Description

Paralax.Docs.Scalar

Paralax.Docs.Scalar - Integration with Scalar for API documentation in microservices architecture

GitHub repositories (15)

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.
SteveDunn/Vogen
A semi-opinionated library which is a source generator and a code analyser. It Source generates Value Objects
Version Downloads Last updated
1.2.71 0 12/23/2024
1.2.70 557 12/22/2024
1.2.69 433 12/22/2024
1.2.68 752 12/21/2024
1.2.67 309 12/20/2024
1.2.66 1,215 12/20/2024
1.2.65 168 12/19/2024
1.2.64 2,539 12/18/2024
1.2.63 1,700 12/18/2024
1.2.61 1,560 12/17/2024
1.2.60 910 12/17/2024
1.2.59 200 12/17/2024
1.2.58 106 12/16/2024
1.2.57 685 12/16/2024
1.2.56 3,382 12/15/2024
1.2.55 2,350 12/13/2024
1.2.54 154 12/13/2024
1.2.53 4,259 12/11/2024
1.2.52 582 12/11/2024
1.2.51 5,304 12/10/2024
1.2.50 2,558 12/9/2024
1.2.49 6,977 12/6/2024
1.2.48 2,838 12/5/2024
1.2.47 3,655 12/4/2024
1.2.46 699 12/4/2024
1.2.45 43,038 11/27/2024
1.2.44 14,594 11/23/2024
1.2.43 944 11/22/2024
1.2.42 6,563 11/21/2024
1.2.41 7,154 11/20/2024
1.2.40 574 11/19/2024
1.2.39 9,416 11/17/2024
1.2.38 229 11/16/2024
1.2.37 6,747 11/14/2024
1.2.36 8,958 11/13/2024
1.2.35 1,784 11/12/2024
1.2.34 7,564 11/10/2024
1.2.33 2,183 11/8/2024
1.2.32 247 11/7/2024
1.2.31 3,181 11/6/2024
1.2.30 1,981 11/4/2024
1.2.29 3,708 11/1/2024
1.2.28 945 11/1/2024
1.2.27 5,127 10/30/2024
1.2.26 1,857 10/30/2024
1.2.25 2,092 10/29/2024
1.2.24 706 10/28/2024
1.2.23 3,429 10/27/2024
1.2.22 2,527 10/24/2024
1.2.21 2,935 10/23/2024
1.2.20 600 10/22/2024
1.2.19 98 10/22/2024
1.2.18 4,129 10/20/2024
1.2.17 336 10/20/2024
1.2.16 562 10/19/2024
1.2.15 506 10/19/2024
1.2.14 209 10/18/2024
1.2.13 195 10/18/2024
1.2.12 836 10/18/2024
1.2.11 208 10/17/2024
1.2.10 2,448 10/17/2024
1.2.9 11,782 10/7/2024
1.2.8 373 10/7/2024
1.2.7 588 10/3/2024
1.2.6 228 10/2/2024
1.2.5 1,157 9/28/2024
1.2.4 2,650 9/22/2024
1.2.3 4,938 9/6/2024
1.1.2 10,296 7/18/2024
1.1.1 4,679 5/21/2024
1.0.1 573 5/15/2024