Installation

System Requirements

Requirement	Version
.NET SDK	10.0+
Docker	24.0+
Node.js	20+
PostgreSQL	16+
Redis	7+

Step-by-Step Setup

1. Clone the Repository

git clone https://github.com/your-org/dotnetsaas.git
cd dotnetsaas

2. Start Dependencies

The project uses PostgreSQL and Redis. Start them with Docker Compose:

docker compose up -d

3. Configure the Application

Copy the example settings file:

cp src/DotnetSaas.Api/appsettings.Development.json.example src/DotnetSaas.Api/appsettings.Development.json

Update the connection strings and configuration values as needed.

4. Run Database Migrations

The application automatically runs migrations on startup. Alternatively, you can run them manually:

cd src/DotnetSaas.Infrastructure
dotnet ef database update --startup-project ../DotnetSaas.Api

5. Start the Application

Using .NET Aspire (recommended):

cd src/DotnetSaas.AppHost
dotnet run

Or start the API directly:

cd src/DotnetSaas.Api
dotnet run

Frontend Setup

The boilerplate supports multiple frontend frameworks. Choose your preferred option:

Blazor WASM

cd frontend/blazor
dotnet run

React / Angular / Vue

cd frontend/react  # or angular, vue
npm install
npm run dev

Environment Variables

Variable	Description	Default
ConnectionStrings__DefaultConnection	PostgreSQL connection string	See appsettings
ConnectionStrings__Redis	Redis connection string	localhost:6379
BlazorPathBase	Base path for Blazor WASM	/blazor
DemoMode	Enable demo data seeding	false