From 4299cf17fa222cf0c5f59f16fe98de31f8a2a441 Mon Sep 17 00:00:00 2001 From: Joe DeCock Date: Thu, 1 May 2025 22:00:16 -0500 Subject: [PATCH] Updated template package readme to reflect new template names --- templates/README.md | 93 +++++++++++++++++++-------------------------- 1 file changed, 39 insertions(+), 54 deletions(-) diff --git a/templates/README.md b/templates/README.md index 39b4338e7..6c0c4f333 100644 --- a/templates/README.md +++ b/templates/README.md @@ -1,47 +1,45 @@ -# Duende.Templates.IdentityServer -.NET CLI Templates for Duende IdentityServer - -### dotnet new is-empty -Creates a minimal Duende IdentityServer project without a UI. - -### dotnet new is-inmem -Adds a basic Duende IdentityServer with UI, test users and sample clients and resources. - -### dotnet new is-asp-id -Adds a basic Duende IdentityServer that uses ASP.NET Identity for user management. If you automatically seed the database, you will get two users: `alice` and `bob` - both with password `Pass123$`. Check the `SeedData.cs` file. - -### dotnet new is-ef -Adds a basic Duende IdentityServer that uses Entity Framework for configuration and state management. If you seed the database, you get a couple of basic client and resource registrations, check the `SeedData.cs` file. +# Duende.Templates +This package contains templates for Duende products for use with the .NET CLI (`dotnet new`). ## Installation -Install with: - -`dotnet new install Duende.Templates.IdentityServer` - - -If you need to set back your dotnet new list to "factory defaults", use this command: - -`dotnet new --debug:reinit` - -If you find that this doesn't work, remove the entries from the file %userprofile%/.templateengine/packages.json - -To uninstall the templates, use - -`dotnet new uninstall Duende.Templates.IdentityServer` - -# Duende.Templates.BFF -.NET CLI Templates for Duende BFF - -## Building - -``` pwsh -cd templates -dotnet run -p build - -dotnet pack ..\artifacts\ -o d:\packages +Install the templates with: ``` +dotnet new install Duende.Templates +``` + +Note that you may have a previous version of Duende's templates (Duende.IdentityServer.Templates) installed on your machine. If the old template package is installed, we recommend uninstalling it with: + +``` +dotnet new uninstall Duende.Templates.IdentityServer +``` + +Or, for a more drastic complete reset of all templates back to the "factory defaults": + +``` +dotnet new --debug:reinit +``` + +## Identity Server Templates + +### dotnet new duende-is-empty +Creates a minimal Duende IdentityServer host without a UI. + +### dotnet new duende-is-ui +Adds the quickstart user interface to an IdentityServer host. + +### dotnet new duende-is-inmem +Creates a basic Duende IdentityServer host with UI, test users and sample clients and resources, using in-memory operational and configuration stores. + +### dotnet new duende-is-asp-id +Creates a basic Duende IdentityServer host that uses ASP.NET Identity for user management. If you automatically seed the database, you will get two users: `alice` and `bob` - both with password `Pass123$`. The `SeedData.cs` file controls the initial users. + +### dotnet new duende-is-ef +Creates a basic Duende IdentityServer host that uses Entity Framework for configuration and state management. If you seed the database, you will get a couple of basic client and resource registrations. The `SeedData.cs` file controls the initial configuration data. + + +# BFF Templates ### dotnet new duende-bff-remoteapi Creates a basic JavaScript-based BFF host that configures and invokes a remote API via the BFF proxy. @@ -49,19 +47,6 @@ Creates a basic JavaScript-based BFF host that configures and invokes a remote A ### dotnet new duende-bff-localapi Creates a basic JavaScript-based BFF host that invokes a local API co-hosted with the BFF. -## Installation +### dotnet new duende-bff-blazor +Creetes a Blazor application that uses the interactive auto render mode, and secures the application across all render modes consistently using Duende.BFF.Blazor. -Install with: - -`dotnet new install Duende.Templates` - - -If you need to set back your dotnet new list to "factory defaults", use this command: - -`dotnet new --debug:reinit` - -If you find that this doesn't work, remove the entries from the file %userprofile%/.templateengine/packages.json - -To uninstall the templates, use - -`dotnet new uninstall Duende.Templates`