dotnet-new-sdk-templates - Man Page

.NET default templates for dotnet new

Description

When you install the .NET SDK (https://dotnet.microsoft.com/download), you receive over a dozen built-in templates for creating projects and files, including console apps, class libraries, unit test projects, ASP.NET Core apps (including Angular (https://angular.io/) and React (https://reactjs.org/) projects), and configuration files. To list the built-in templates, run the dotnet new list command:

dotnet new list

The following table shows the templates that come pre-installed with the .NET SDK. The default language for the template is shown inside the brackets. Click on the short name link to see the specific template options.

TemplatesShort nameLanguageTagsIntroduced
Console Applicationconsole[C#], F#, VBCommon/Console1.0
Class libraryclasslib[C#], F#, VBCommon/Library1.0
WPF Applicationwpf[C#], VBCommon/WPF3.0 (5.0 for VB)
WPF Class librarywpflib[C#], VBCommon/WPF3.0 (5.0 for VB)
WPF Custom Control Librarywpfcustomcontrollib[C#], VBCommon/WPF3.0 (5.0 for VB)
WPF User Control Librarywpfusercontrollib[C#], VBCommon/WPF3.0 (5.0 for VB)
Windows Forms (WinForms) Applicationwinforms[C#], VBCommon/WinForms3.0 (5.0 for VB)
Windows Forms (WinForms) Class librarywinformslib[C#], VBCommon/WinForms3.0 (5.0 for VB)
Worker Serviceworker[C#]Common/Worker/Web3.0
Unit Test Projectmstest[C#], F#, VBTest/MSTest1.0
NUnit 3 Test Projectnunit[C#], F#, VBTest/NUnit2.1.400
NUnit 3 Test Itemnunit-test[C#], F#, VBTest/NUnit2.2
xUnit Test Projectxunit[C#], F#, VBTest/xUnit1.0
Razor Componentrazorcomponent[C#]Web/ASP.NET3.0
Razor Pagepage[C#]Web/ASP.NET2.0
MVC ViewImportsviewimports[C#]Web/ASP.NET2.0
MVC ViewStartviewstart[C#]Web/ASP.NET2.0
Blazor Web Appblazor[C#]Web/Blazor8.0.100
Blazor WebAssembly Standalone Appblazorwasm[C#]Web/Blazor/WebAssembly/PWA3.1.300
ASP.NET Core Emptyweb[C#], F#Web/Empty1.0
ASP.NET Core Web App (Model-View-Controller)mvc[C#], F#Web/MVC1.0
ASP.NET Core Web Appwebapp, razor[C#]Web/MVC/Razor Pages2.2, 2.0
Razor Class Libraryrazorclasslib[C#]Web/Razor/Library/Razor Class Library2.1
ASP.NET Core Web APIwebapi[C#], F#Web/Web API/API/Service/WebAPI1.0
ASP.NET Core APIwebapiaot[C#]Web/Web API/API/Service8.0
ASP.NET Core API controllerapicontroller[C#]Web/ASP.NET8.0
ASP.NET Core gRPC Servicegrpc[C#]Web/gRPC3.0
dotnet gitignore filegitignoreConfig3.0
global.json fileglobaljsonConfig2.0
NuGet ConfignugetconfigConfig1.0
Dotnet local tool manifest filetool-manifestConfig3.0
Web ConfigwebconfigConfig1.0
Solution FileslnSolution1.0
Protocol Buffer FileprotoWeb/gRPC3.0
EditorConfig fileeditorconfigConfig6.0

The following table shows templates that have been discontinued and no longer come pre-installed with the .NET SDK. Click on the short name link to see the specific template options.

TemplatesShort nameLanguageTagsDiscontinued since
ASP.NET Core with Angularangular[C#]Web/MVC/SPA8.0
ASP.NET Core with React.jsreact[C#]Web/MVC/SPA8.0
Blazor Server Appblazorserver[C#]Web/Blazor8.0
Blazor Server App Emptyblazorserver-empty[C#]Web/Blazor8.0
Blazor WebAssembly App Emptyblazorwasm-empty[C#]Web/Blazor/WebAssembly8.0

Template options

Each template may have additional options available. To show the additional options available for the template use the --help option with the template name argument, for example: dotnet new console --help. In case the template supports multiple languages, this command will show help for the template in the default language. By combining it with the --language option, you can see the help for other languages: dotnet new console --help --language F#. The templates that ship with the .NET SDK have the following additional options:

console

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. Available since .NET Core 3.0 SDK.

    The following table lists the default values according to the SDK version you’re using:

    SDK versionDefault value
    8.0net8.0
    7.0net7.0
    6.0net6.0
    3.1netcoreapp3.1

    The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 7 SDK installed, then the only value available for --framework is net7.0. If you install the .NET 6 SDK the value net6.0 becomes available for --framework. If you install the .NET Core 3.1 SDK, netcoreapp3.1 becomes available, and so on. So by specifying --framework netcoreapp3.1 you can target .NET Core 3.1 even while running dotnet new in the .NET 6 SDK.

    Alternatively, to create a project that targets a framework earlier than the SDK that you’re using, you might be able to do it by installing the NuGet package for the template. Common (https://www.nuget.org/packages?q=Microsoft.DotNet.Common.ProjectTemplates), web (https://www.nuget.org/packages?q=Microsoft.DotNet.Web.ProjectTemplates), and SPA (https://www.nuget.org/packages?q=Microsoft.DotNet.Web.Spa.ProjectTemplates) project types use different packages per target framework moniker (TFM). For example, to create a console project that targets netcoreapp1.0, run dotnet new install on Microsoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    Sets the LangVersion property in the created project file. For example, use --langVersion 7.3 to use C# 7.3. Not supported for F#. Available since .NET Core 2.2 SDK.

    For a list of default C# versions, see Defaults.

  • --no-restore

    If specified, doesn’t execute an implicit restore during project creation. Available since .NET Core 2.2 SDK.

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false. Available only for C#.

  *   *   *   *   *

classlib

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. Values: net8.0, net7.0, or net6.0 to create a .NET Class Library, or netstandard2.1 or netstandard2.0 to create a .NET Standard Class Library. The default value for .NET SDK 8.0.x is net8.0.

    To create a project that targets a framework earlier than the SDK that you’re using, see --framework for console projects earlier in this article.

  • --langVersion <VERSION_NUMBER>

    Sets the LangVersion property in the created project file. For example, use --langVersion 7.3 to use C# 7.3. Not supported for F#. Available since .NET Core 2.2 SDK.

    For a list of default C# versions, see Defaults.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  *   *   *   *   *

wpf, wpflib, wpfcustomcontrollib, wpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. For the .NET 8 SDK, the default value is net8.0. Available since .NET Core 3.1 SDK.

  • --langVersion <VERSION_NUMBER>

    Sets the LangVersion property in the created project file. For example, use --langVersion 7.3 to use C# 7.3.

    For a list of default C# versions, see Defaults.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  *   *   *   *   *

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Sets the LangVersion property in the created project file. For example, use --langVersion 7.3 to use C# 7.3.

    For a list of default C# versions, see Defaults.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  *   *   *   *   *

worker, grpc

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. The default value for .NET 8 SDK is net8.0. Available since .NET Core 3.1 SDK.

    To create a project that targets a framework earlier than the SDK that you’re using, see --framework for console projects earlier in this article.

  • --exclude-launch-settings

    Excludes launchSettings.json from the generated template.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false.

  *   *   *   *   *

mstest, xunit

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. Option available since .NET Core 3.0 SDK.

    The following table lists the default values according to the SDK version number you’re using:

    SDK versionDefault value
    8.0net8.0
    7.0net7.0
    6.0net6.0
    5.0net5.0
    3.1netcoreapp3.1

The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 6 SDK installed, then the only value available for --framework is net6.0. If you install the .NET 5 SDK, the value net5.0 becomes available for --framework. If you install the .NET Core 3.1 SDK, netcoreapp3.1 becomes available, and so on. So by specifying --framework netcoreapp3.1 you can target .NET Core 3.1 even while running dotnet new in the .NET 6 SDK.

  • -p|--enable-pack

    Enables packaging for the project using dotnet pack.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  *   *   *   *   *

nunit

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target.

    The following table lists the default values according to the SDK version number you’re using:

    SDK versionDefault value
    8.0net8.0
    7.0net7.0
    6.0net6.0
    5.0net5.0
    3.1netcoreapp3.1

The ability to create a project for an earlier TFM depends on having that version of the SDK installed. For example, if you have only the .NET 6 SDK installed, then the only value available for --framework is net6.0. If you install the .NET 5 SDK, the value net5.0 becomes available for --framework. If you install the .NET Core 3.1 SDK, netcoreapp3.1 becomes available, and so on. So by specifying --framework netcoreapp3.1 you can target .NET Core 3.1 even while running dotnet new in the .NET 6 SDK.

  • -p|--enable-pack

    Enables packaging for the project using dotnet pack.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  *   *   *   *   *

page

  • -na|--namespace <NAMESPACE_NAME>

    Namespace for the generated code. The default value is MyApp.Namespace.

  • -np|--no-pagemodel

    Creates the page without a PageModel.

  *   *   *   *   *

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Namespace for the generated code. The default value is MyApp.Namespace.

  *   *   *   *   *

blazorserver

Discontinued since .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    The type of authentication to use. The possible values are:

    • None - No authentication (Default).
    • Individual - Individual authentication.
    • IndividualB2C - Individual authentication with Azure AD B2C.
    • SingleOrg - Organizational authentication for a single tenant. Entra External ID tenants also use SingleOrg.
    • MultiOrg - Organizational authentication for multiple tenants.
    • Windows - Windows authentication.
  • --aad-b2c-instance <INSTANCE>

    The Azure Active Directory B2C instance to connect to. Use with IndividualB2C authentication. The default value is https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    The sign-in and sign-up policy ID for this project. Use with IndividualB2C authentication.

  • -rp|--reset-password-policy-id <ID>

    The reset password policy ID for this project. Use with IndividualB2C authentication.

  • -ep|--edit-profile-policy-id <ID>

    The edit profile policy ID for this project. Use with IndividualB2C authentication.

  • --aad-instance <INSTANCE>

    The Azure Active Directory instance to connect to. Use with SingleOrg or MultiOrg authentication. The default value is https://login.microsoftonline.com/.

  • --client-id <ID>

    The Client ID for this project. Use with IndividualB2C, SingleOrg, or MultiOrg authentication. The default value is 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    The domain for the directory tenant. Use with SingleOrg or IndividualB2C authentication. The default value is qualified.domain.name.

  • --tenant-id <ID>

    The TenantId ID of the directory to connect to. Use with SingleOrg authentication. The default value is 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    The request path within the application’s base path of the redirect URI. Use with SingleOrg or IndividualB2C authentication. The default value is /signin-oidc.

  • -r|--org-read-access

    Allows this application read-access to the directory. Only applies to SingleOrg or MultiOrg authentication.

  • --exclude-launch-settings

    Excludes launchSettings.json from the generated template.

  • --no-https

    Turns off HTTPS. This option only applies if Individual, IndividualB2C, SingleOrg, or MultiOrg aren’t being used for --auth.

  • -uld|--use-local-db

    Specifies LocalDB should be used instead of SQLite. Only applies to Individual or IndividualB2C authentication.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • --kestrelHttpPort

    Port number to use for the HTTP endpoint in launchSettings.json.

  • --kestrelHttpsPort

    Port number to use for the HTTPS endpoint in launchSettings.json. This option is not applicable when the parameter no-https is used (but no-https is ignored when an individual or organizational authentication setting is chosen for --auth).

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false.

  *   *   *   *   *

blazor

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target.

    This template is available for .NET 8 or later.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • --exclude-launch-settings

    Excludes launchSettings.json from the generated app.

  • -int|--interactivity <None|Server|Webassembly|Auto >

    Specifies which interactive render mode to use for interactive components. The possible values are:

    • None - No interactivity (static server-side rendering only).
    • Server - (Default) Runs the app on the server with interactive server-side rendering.
    • WebAssembly - Runs the app using client-side rendering in the browser with WebAssembly.
    • Auto - Uses interactive server-side rendering while downloading the Blazor bundle and activating the Blazor runtime on the client, then uses client-side rendering with WebAssembly.
  • --empty

    Omits sample pages and styling that demonstrate basic usage patterns.

  • -au|--auth <AUTHENTICATION_TYPE>

    The type of authentication to use. The possible values are:

    • None - No authentication (Default).
    • Individual - Individual authentication.
  • -uld|--use-local-db

    Specifies LocalDB should be used instead of SQLite. Only applies to Individual authentication.

  • -ai|--all-interactive

    Makes every page interactive by applying an interactive render mode at the top level. If false, pages use static server-side rendering by default and can be marked interactive on a per-page or per-component basis. This option is only effective if the -i|--interactivity option isn’t set to None.

  • --no-https

    Turns off HTTPS. This option only applies if Individual isn’t chosen for the -au|--auth option.

  • --use-program-main

    If specified, an explicit Program class and Main method is generated instead of top-level statements.

  *   *   *   *   *

blazorwasm

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target.

    The following table lists the default values according to the SDK version number you’re using:

    SDK versionDefault value
    8.0net8.0
    7.0net7.0
    6.0net6.0
    5.0net5.0
    3.1netcoreapp3.1

    To create a project that targets a framework earlier than the SDK that you’re using, see --framework for console projects earlier in this article.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • -ho|--hosted

    Includes an ASP.NET Core host for the Blazor WebAssembly app.

  • -au|--auth <AUTHENTICATION_TYPE>

    The type of authentication to use. The possible values are:

    • None - No authentication (Default).
    • Individual - Individual authentication.
    • IndividualB2C - Individual authentication with Azure AD B2C.
    • SingleOrg - Organizational authentication for a single tenant. Entra External ID tenants also use SingleOrg.
  • --authority <AUTHORITY>

    The authority of the OIDC provider. Use with Individual authentication. The default value is https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    The Azure Active Directory B2C instance to connect to. Use with IndividualB2C authentication. The default value is https://aadB2CInstance.b2clogin.com/.

  • -ssp|--susi-policy-id <ID>

    The sign-in and sign-up policy ID for this project. Use with IndividualB2C authentication.

  • --aad-instance <INSTANCE>

    The Azure Active Directory instance to connect to. Use with SingleOrg authentication. The default value is https://login.microsoftonline.com/.

  • --client-id <ID>

    The Client ID for this project. Use with IndividualB2C, SingleOrg, or Individual authentication in standalone scenarios. The default value is 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    The domain for the directory tenant. Use with SingleOrg or IndividualB2C authentication. The default value is qualified.domain.name.

  • --app-id-uri <URI>

    The App ID Uri for the server API you want to call. Use with SingleOrg or IndividualB2C authentication. The default value is api.id.uri.

  • --api-client-id <ID>

    The Client ID for the API that the server hosts. Use with SingleOrg or IndividualB2C authentication. The default value is 11111111-1111-1111-11111111111111111.

  • -s|--default-scope <SCOPE>

    The API scope the client needs to request to provision an access token. Use with SingleOrg or IndividualB2C authentication. The default value is user_impersonation.

  • --tenant-id <ID>

    The TenantId ID of the directory to connect to. Use with SingleOrg authentication. The default value is 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Allows this application read-access to the directory. Only applies to SingleOrg authentication.

  • --exclude-launch-settings

    Excludes launchSettings.json from the generated template.

  • -p|--pwa

    produces a Progressive Web Application (PWA) supporting installation and offline use.

  • --no-https

    Turns off HTTPS. This option only applies if Individual, IndividualB2C, or SingleOrg aren’t being used for --auth.

  • -uld|--use-local-db

    Specifies LocalDB should be used instead of SQLite. Only applies to Individual or IndividualB2C authentication.

  • --called-api-url <URL>

    URL of the API to call from the web app. Only applies to SingleOrg or IndividualB2C authentication without an ASP.NET Core host specified. The default value is https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Specifies if the web app calls Microsoft Graph. Only applies to SingleOrg authentication.

  • --called-api-scopes <SCOPES>

    Scopes to request to call the API from the web app. Only applies to SingleOrg or IndividualB2C authentication without an ASP.NET Core host specified. The default is user.read.

  • --kestrelHttpPort

    Port number to use for the HTTP endpoint in launchSettings.json.

  • --kestrelHttpsPort

    Port number to use for the HTTPS endpoint in launchSettings.json. This option is not applicable when the parameter no-https is used (but no-https is ignored when an individual or organizational authentication setting is chosen for --auth).

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false.

  *   *   *   *   *

web

  • --exclude-launch-settings

    Excludes launchSettings.json from the generated template.

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. Option not available in .NET Core 2.2 SDK.

    The following table lists the default values according to the SDK version number you’re using:

    SDK versionDefault value
    8.0net8.0
    7.0net7.0
    6.0net6.0
    5.0net5.0
    3.1netcoreapp3.1
    3.0netcoreapp3.0
    2.1netcoreapp2.1

    To create a project that targets a framework earlier than the SDK that you’re using, see --framework for console projects earlier in this article.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • --no-https

    Turns off HTTPS.

  • --kestrelHttpPort

    Port number to use for the HTTP endpoint in launchSettings.json.

  • --kestrelHttpsPort

    Port number to use for the HTTPS endpoint in launchSettings.json. This option is not applicable when the parameter no-https is used (but no-https is ignored when an individual or organizational authentication setting is chosen for --auth).

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false.

  *   *   *   *   *

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    The type of authentication to use. The possible values are:

    • None - No authentication (Default).
    • Individual - Individual authentication.
    • IndividualB2C - Individual authentication with Azure AD B2C.
    • SingleOrg - Organizational authentication for a single tenant. Entra External ID tenants also use SingleOrg.
    • MultiOrg - Organizational authentication for multiple tenants.
    • Windows - Windows authentication.
  • --aad-b2c-instance <INSTANCE>

    The Azure Active Directory B2C instance to connect to. Use with IndividualB2C authentication. The default value is https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    The sign-in and sign-up policy ID for this project. Use with IndividualB2C authentication.

  • -rp|--reset-password-policy-id <ID>

    The reset password policy ID for this project. Use with IndividualB2C authentication.

  • -ep|--edit-profile-policy-id <ID>

    The edit profile policy ID for this project. Use with IndividualB2C authentication.

  • --aad-instance <INSTANCE>

    The Azure Active Directory instance to connect to. Use with SingleOrg or MultiOrg authentication. The default value is https://login.microsoftonline.com/.

  • --client-id <ID>

    The Client ID for this project. Use with IndividualB2C, SingleOrg, or MultiOrg authentication. The default value is 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    The domain for the directory tenant. Use with SingleOrg or IndividualB2C authentication. The default value is qualified.domain.name.

  • --tenant-id <ID>

    The TenantId ID of the directory to connect to. Use with SingleOrg authentication. The default value is 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    The request path within the application’s base path of the redirect URI. Use with SingleOrg or IndividualB2C authentication. The default value is /signin-oidc.

  • -r|--org-read-access

    Allows this application read-access to the directory. Only applies to SingleOrg or MultiOrg authentication.

  • --exclude-launch-settings

    Excludes launchSettings.json from the generated template.

  • --no-https

    Turns off HTTPS. This option only applies if Individual, IndividualB2C, SingleOrg, or MultiOrg aren’t being used.

  • -uld|--use-local-db

    Specifies LocalDB should be used instead of SQLite. Only applies to Individual or IndividualB2C authentication.

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. Option available since .NET Core 3.0 SDK.

    The following table lists the default values according to the SDK version number you’re using:

    SDK versionDefault value
    8.0net8.0
    7.0net7.0
    6.0net6.0
    5.0net5.0
    3.1netcoreapp3.1
    3.0netcoreapp3.0

    To create a project that targets a framework earlier than the SDK that you’re using, see --framework for console projects earlier in this article.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • --use-browserlink

    Includes BrowserLink in the project. Option not available in .NET Core 2.2 and 3.1 SDK.

  • -rrc|--razor-runtime-compilation

    Determines if the project is configured to use Razor runtime compilation in Debug builds. Option available since .NET Core 3.1.201 SDK.

  • --kestrelHttpPort

    Port number to use for the HTTP endpoint in launchSettings.json.

  • --kestrelHttpsPort

    Port number to use for the HTTPS endpoint in launchSettings.json. This option is not applicable when the parameter no-https is used (but no-https is ignored when an individual or organizational authentication setting is chosen for --auth).

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false.

  *   *   *   *   *

angular, react

Discontinued since .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    The type of authentication to use. Available since .NET Core 3.0 SDK.

    The possible values are:

    • None - No authentication (Default).
    • Individual - Individual authentication.
  • --exclude-launch-settings

    Excludes launchSettings.json from the generated template.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • --no-https

    Turns off HTTPS. This option only applies if authentication is None.

  • -uld|--use-local-db

    Specifies LocalDB should be used instead of SQLite. Only applies to Individual or IndividualB2C authentication. Available since .NET Core 3.0 SDK.

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. Option not available in .NET Core 2.2 SDK.

    The following table lists the default values according to the SDK version number you’re using:

    There isn’t a React template for net8.0, however, if you’re interested in developing React apps with ASP.NET Core, see Overview of Single Page Apps (SPAs) in ASP.NET Core.

    SDK versionDefault value
    7.0net7.0
    6.0net6.0
    5.0net5.0
    3.1netcoreapp3.1
    3.0netcoreapp3.0
    2.1netcoreapp2.0

    To create a project that targets a framework earlier than the SDK that you’re using, see --framework for console projects earlier in this article.

  • --kestrelHttpPort

    Port number to use for the HTTP endpoint in launchSettings.json.

  • --kestrelHttpsPort

    Port number to use for the HTTPS endpoint in launchSettings.json. This option is not applicable when the parameter no-https is used (but no-https is ignored when an individual or organizational authentication setting is chosen for --auth).

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false.

  *   *   *   *   *

razorclasslib

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • -s|--support-pages-and-views

    Supports adding traditional Razor pages and Views in addition to components to this library. Available since .NET Core 3.0 SDK.

  *   *   *   *   *

webapiaot

Creates a web API project with AOT publish enabled. For more information, see Native AOT deployment and The Web API (Native AOT) template.

  • --exclude-launch-settings

    Excludes launchSettings.json from the generated template.

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target.

    The following table lists the default values according to the SDK version number you’re using:

    SDK versionDefault value
    8.0net8.0
  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false.

  *   *   *   *   *

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    The type of authentication to use. The possible values are:

    • None - No authentication (Default).
    • IndividualB2C - Individual authentication with Azure AD B2C.
    • SingleOrg - Organizational authentication for a single tenant. Entra External ID tenants also use SingleOrg.
    • Windows - Windows authentication.
  • --aad-b2c-instance <INSTANCE>

    The Azure Active Directory B2C instance to connect to. Use with IndividualB2C authentication. The default value is https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Create a project that uses the ASP.NET Core minimal API. Default is false, but this option is overridden by -controllers. Since the default for -controllers is false, entering dotnet new webapi without specifying either option creates a minimal API project.

  • -ssp|--susi-policy-id <ID>

    The sign-in and sign-up policy ID for this project. Use with IndividualB2C authentication.

  • --aad-instance <INSTANCE>

    The Azure Active Directory instance to connect to. Use with SingleOrg authentication. The default value is https://login.microsoftonline.com/.

  • --client-id <ID>

    The Client ID for this project. Use with IndividualB2C or SingleOrg authentication. The default value is 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Whether to use controllers instead of minimal APIs. If both this option and -minimal are specified, this option overrides the value specified by -minimal. Default is false. Available since .NET 8 SDK.

  • --domain <DOMAIN>

    The domain for the directory tenant. Use with IndividualB2C or SingleOrg authentication. The default value is qualified.domain.name.

  • --tenant-id <ID>

    The TenantId ID of the directory to connect to. Use with SingleOrg authentication. The default value is 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Allows this application read-access to the directory. Only applies to SingleOrg authentication.

  • --exclude-launch-settings

    Excludes launchSettings.json from the generated template.

  • --no-openapi

    Turns off OpenAPI (Swagger) support. AddSwaggerGen, UseSwagger, and UseSwaggerUI aren’t called.

  • --no-https

    Turns off HTTPS. No https launch profile is created in launchSettings.json. app.UseHsts and app.UseHttpsRedirection aren’t called in Program.cs/Startup.cs. This option only applies if IndividualB2C or SingleOrg aren’t being used for authentication.

  • -uld|--use-local-db

    Specifies LocalDB should be used instead of SQLite. Only applies to IndividualB2C authentication.

  • -f|--framework <FRAMEWORK>

    Specifies the framework to target. Option not available in .NET Core 2.2 SDK.

    The following table lists the default values according to the SDK version number you’re using:

    SDK versionDefault value
    8.0net8.0
    7.0net7.0
    6.0net6.0
    5.0net5.0
    3.1netcoreapp3.1
    3.0netcoreapp3.0
    2.1netcoreapp2.1

    To create a project that targets a framework earlier than the SDK that you’re using, see --framework for console projects earlier in this article.

  • --no-restore

    Doesn’t execute an implicit restore during project creation.

  • --use-program-main

    If specified, an explicit Program class and Main method will be used instead of top-level statements. Available since .NET SDK 6.0.300. Default value: false.

  *   *   *   *   *

apicontroller

API Controller with or without read/write actions.

  • -p:n|--name <NAME>

    The namespace for the generated code. Default is MyApp.Namespace.

  • -ac|--actions

    Create a controller with read/write actions. Default is false.

  *   *   *   *   *

globaljson

  • --sdk-version <VERSION_NUMBER>

    Specifies the version of the .NET SDK to use in the global.json file.

  • --roll-forward <ROLL_FORWARD_POLICY>

    The roll-forward policy to use when selecting an SDK version, either as a fallback when a specific SDK version is missing or as a directive to use a later version. For more information, see global-json.

editorconfig

Creates an .editorconfig file for configuring code style preferences.

  • --empty

    Creates an empty .editorconfig instead of the defaults for .NET.

See Also

Info

2024-10-02 .NET Documentation