AspNetCore.SwaggerUI.Themes 0.4.0

AspNetCore.SwaggerUI.Themes

Introduction

Swashbuckle.AspNetCore is a popular library for adding Swagger support to ASP.NET Core projects, making it easier to document and interact with your APIs.

AspNetCore.SwaggerUI.Themes builds upon Swashbuckle.AspNetCore.SwaggerUI, enhancing the Swagger UI with modern and visually appealing themes.

Features

• New Themes: enhances the Swagger documentation interface with different themes, including a default style that retains the classic Swagger UI appearance and new modern styles.
• Seamless Integration: simply install the package and add the style parameter to the existing method used for SwaggerUI.

Getting Started

To use AspNetCore.SwaggerUI.Themes in your ASP.NET Core project, follow these steps:

1. Install the package using .NET CLI or NuGet Package Manager:

    dotnet add package AspNetCore.SwaggerUI.Themes
   

   or

    Install-Package AspNetCore.SwaggerUI.Themes
   

2. In your Program.cs file, add the style through the Style or ModernStyle class as new parameter of app.UseSwaggerUI() method:

    using AspNetCore.SwaggerUI.Themes;
   
    ...
   
    app.UseSwaggerUI(Style.Dark);
   

   This code enables the chosen theme for Swagger UI in your application.

Please be aware that for projects utilizing the older style template with separate Startup.cs and Program.cs files, the previously code should be configured within the Configure method of the Startup class.

Available Themes

There are a few styles available for your Swagger UI.

Defaults:

• Dark

Offers a simple dark-themed interface, maintaining the classic Swagger UI layout.

Style.Dark

• Forest

Inspired by the colors of a forest, this theme brings a natural and vibrant feel to your documentation.

Style.Forest

• DeepSea

Inspired by the depths of the sea, this theme features cool blues and deep greens for a tranquil and immersive experience.

Style.DeepSea

The light style is not in this list because it's just the default one used by Swagger UI; to use that you don't need this library.

Moderns:

• Light

Offers a modern, light-themed interface that overrides some aspects of the default Swagger UI.

ModernStyle.Light

• Dark

Provides a sleek, dark-themed interface for a more modern look and feel.

ModernStyle.Dark

• Forest

Brings a natural feel to your documentation with colors inspired by the serene ambiance of a forest.

ModernStyle.Forest

• DeepSea

Dive into a tranquil interface with cool blues and deep greens, inspired by the depths of the sea.

ModernStyle.DeepSea