NetCoreApplicationTemplate 2.10.0

.NET Core Application Template

A reusable dotnet new template for creating a production-oriented ASP.NET Core application baseline with structured logging, security headers, forwarded headers, rate limiting, centralized error handling, cookie authentication, authenticated-by-default routed endpoints, policy-based authorization, and EF Core-ready structure.

This README is intended for NuGet package consumers. The full repository README and documentation site provide deeper implementation and maintainer guidance.

Template identity

Install

Install the template package from NuGet:

dotnet new install NetCoreApplicationTemplate::2.10.0

For local package validation, install a packed package directly:

dotnet new install ./artifacts/template-package/NetCoreApplicationTemplate.2.10.0.nupkg

Generate a project

Create a default scaffold:

dotnet new netcoreapp-template -n ContosoSecurityPortal

The default scaffold enables cookie authentication as its session handler and a fallback authorization policy that requires an authenticated user for routed endpoints without authorization metadata. It does not include local user accounts, a credential form, a seeded user, or an enabled external provider. Cookie authentication does not verify credentials by itself, so protected routes remain unavailable until the consuming application enables an external provider or supplies its own identity flow. Intentionally public routes must use explicit anonymous metadata such as [AllowAnonymous] or .AllowAnonymous().

Generate with application authentication disabled:

dotnet new netcoreapp-template --name ContosoNoAuth --authProvider none

--authProvider none is an explicit opt-out. It disables application authentication, cookie authentication, and the authenticated fallback policy in generated configuration. Unannotated routed endpoints are therefore public until the consuming application adds another authentication mechanism and authorization posture.

Generate with SQL Server selected:

dotnet new netcoreapp-template --name ContosoSqlServer --dbProvider sqlserver

Generate with authentication disabled and SQL Server selected:

dotnet new netcoreapp-template --name ContosoNoAuthSqlServer --authProvider none --dbProvider sqlserver

Authentication and authorization terminology

• Authentication establishes the caller's identity.
• Authorization determines whether that identity may access an endpoint or operation.
• The fallback authorization policy applies to routed endpoints that contain no authorization metadata.
• Policy-based authorization adds role, permission, claim, or custom requirements beyond the authenticated-user baseline.

Template options

SQL Server scaffolds omit the SQLite-specific migration history and migration tests. Generate provider-compatible SQL Server migrations before applying database updates.

Scaffolds do not include a pre-generated SQL migration script. Generate and review SQL from the consuming application's current provider-specific migrations before deployment.

Build and test generated output

cd ContosoSecurityPortal
dotnet restore
dotnet build --configuration Release
dotnet test --configuration Release

Update

Install the newer package version with the same package identity:

dotnet new install NetCoreApplicationTemplate::2.10.0

Uninstall

dotnet new uninstall NetCoreApplicationTemplate

Additional resources

• GitHub repository: https://github.com/AsiBackbone/NetCoreApplicationTemplate
• Published documentation: https://asibackbone.github.io/NetCoreApplicationTemplate/
• Template packaging documentation: https://asibackbone.github.io/NetCoreApplicationTemplate/articles/template-packaging.html
• Community questions and feedback: https://github.com/AsiBackbone/NetCoreApplicationTemplate/discussions
• Changelog: CHANGELOG.md
• License: LICENSE.txt
• Releases: https://github.com/AsiBackbone/NetCoreApplicationTemplate/releases
• Coverage Report: https://asibackbone.github.io/NetCoreApplicationTemplate/coverage/index.html

Generated projects receive their own consumer-oriented README from the scaffold. This package README is intentionally limited to NuGet installation, scaffold options, validation commands, and consumer-facing reference links.