Setup
After downloading your new template, go ahead and unzip it into your Visual Studio repos location. Before you do anything else, set up source control and commit this initial version.
Now open up the solution in Visual Studio 2019. Be sure you have .NET 5 and Asp.Net Core installed as part of Visual Studio. Build the project and insure that there are no compilation errors.
Create a new SQL server database for your application using SQL Server Managements Studio available here. When creating the database, note the name. Don't worry about anything else, your tables will be created automatically in another step. While Entity Framework Core should work with other databases, such as Sqlite and Postgres, we do not recommend it, especially if you are deploying on Azure.
Next, open up <root>\appsettings.Development.json
and fill out the following necessary parts, as follows:
ConnectionStrings.DefaultConnection
: AddServer=<MachineName>;Database=<databasename>;Trusted_Connection=True;MultipleActiveResultSets=true
.Application.BaseUrl
: Change the port number if you need to, depending on what port the application is setup to run on.Identity.TwoFactor
: For local development, we recommend disabling all three of these.Identity.Admin*
: Set an initial admin username, password and email. You can change these later.Email.Smtp
: If you setIdentity.RequireConfirmedEmail
to true, you must configure this, otherwise the application will not start.
In Visual Studio, open the Package Manager Console and run the command update-database
.
You are now ready to run your application. Hit F5 and wait for the page to load. You can now log in as the admin user you configured in the appsettings.Development.json file. Also take a look in your database and familiarize yourself with the tables that were created. You most likely will never have to touch them, but it doesn't hurt to know.
Table of Contents
- Initial Setup
- Project Structure
- Configuration
- Identity
- Entity Framework
- Authorization
- Api
- User Interface
- Logging
- Email Service
- Background Workers
- Localization
- Services
- Creating a new Page
- Publishing to Azure
- Upgrading