Developer Getting Started Guide

Congratulations! You've created a new web application using the BWWebApplicationAuth template. This guide will help you get up and running quickly.

1. Initial Setup

First Launch

When you first run the application:

The database will be created automatically (using the connection string in appsettings.json)
An administrator account is created using your developer credentials from DeveloperInfo
The default password is ChangeMe123!
Log in immediately and change this password

Connection String

The default connection string in appsettings.json points to a local SQL Server database. Update this for your environment:

"ConnectionStrings": {
    "DefaultConnection": "Server=.;Database=YourAppName;Trusted_Connection=True;MultipleActiveResultSets=true;TrustServerCertificate=True"
}

2. Template Features

This template provides a complete authentication system with the following features:

Feature	Description	Configuration
User Registration	Self-registration with email/password	`Registration:AllowSelfRegistration`
Admin Approval	Require admin approval for new users	`Registration:RequireApproval`
Google OAuth	Sign in with Google	`Authentication:EnableGoogleAuth`
Facebook OAuth	Sign in with Facebook	`Authentication:EnableFacebookAuth`
Microsoft OAuth	Sign in with Microsoft	`Authentication:EnableMicrosoftAuth`
Multi-Factor Auth	TOTP-based MFA with authenticator apps	`Authentication:EnableMfa`
Password Reset	Email-based password recovery	Always enabled
Admin Dashboard	User management, roles, pending approvals	Always enabled

3. Configuration

appsettings.json Structure

All configuration is in appsettings.json. Key sections:

ConnectionStrings - Database connection
Branding - Logo path and dimension limits
Registration - Self-registration and approval settings
Authentication - OAuth providers, MFA, cookie settings

Branding

Replace the default logo at wwwroot/images/logo.png with your own. The startup validator will check that your logo meets the configured dimension requirements.

4. Enabling OAuth Providers

To enable OAuth sign-in, you'll need to register your application with each provider:

5. Email Configuration

The template uses BW.Framework's EmailGroup for sending emails (password reset, user approval notifications, etc.). Configure your SMTP settings in the BW.Framework configuration.

SMTP Configuration Guide

6. Building Your Application

What to Keep

All files in Pages/Account/ - Authentication pages
All files in Pages/Admin/ - Admin dashboard
Pages/Shared/_Layout.cshtml - Update with your branding
Pages/Shared/_LoginPartial.cshtml - User menu in navbar

What to Modify

Pages/Index.cshtml - Modify with your home page content
Pages/Privacy.cshtml - Modify with your privacy policy
wwwroot/images/logo.png - Your logo

What to Add

Your application pages in Pages/
Your services in Services/
Your data models and DbContext extensions in Data/

7. Next Steps

Change your admin password
Update the connection string for your database
Replace the logo with your branding
Update _Layout.cshtml with your app name
Configure OAuth providers (if needed)
Configure email settings
Replace the home page content
Start building your application!