Getting Started - Blazor Blueprint Installation & Setup Guide
Login Register

๐Ÿ“‹ Prerequisites

  • .NET 10.0 SDK - Download from Microsoft
  • Docker Desktop - For MongoDB, Redis, and containerized deployment
  • IDE: Visual Studio 2022, VS Code, or JetBrains Rider
  • Git - For version control

๐Ÿ’ก Tip: .NET Aspire handles Redis automatically in development. You'll need to configure MongoDB separately (local instance or cloud service).

โš™๏ธ Installation

  1. Clone the repository:
    git clone https://github.com/BlazorBlueprint/Blazor-Blueprint-Lite.git your-saas-app
    cd your-saas-app
  2. Restore dependencies:
    dotnet restore BlazorBlueprint.sln
  3. Build the solution:
    dotnet build BlazorBlueprint.sln

๐Ÿ’ป Development Setup

Option 1: .NET Aspire (Recommended)

  1. Start MongoDB: Run local MongoDB or configure cloud connection in appsettings.json
  2. Set Dev/BlazorBlueprint.AppHost as startup project in Visual Studio
  3. Press F5 or click Run
  4. Aspire dashboard opens automatically showing all services
  5. Click the Web endpoint to access your application

โœจ What Aspire Does: Automatically starts Redis, Web app, and API service with proper networking and random ports. You need to provide MongoDB separately.

โš ๏ธ Development vs Production: Aspire development setup does NOT include MongoDB (you provide it separately), while CI/CD production deployment includes MongoDB with persistent storage.

Option 2: Manual Setup

If you prefer not to use Aspire:

  1. Start MongoDB and Redis:
    docker run -d --name mongodb -p 27017:27017 mongo:latest
    docker run -d --name redis -p 6379:6379 redis:latest
  2. Update connection strings in appsettings.json:
    "Database": { "ConnectionString": "mongodb://localhost:27017" }
    "ConnectionStrings": { "redisCache": "localhost:6379" }
  3. Run the web application:
    dotnet run --project Web/BlazorBlueprint.Web

๐ŸŽฏ First Run

  1. Access the application: Navigate to the Web endpoint shown in the Aspire dashboard (port changes each run)
  2. Create admin account: Click "Register" and create your first user account
  3. Explore features: Check out the demo pages and admin panel
  4. View infrastructure: Visit Infrastructure Monitor to see system status

๐ŸŽฏ Next Steps: Once running, explore the demo pages for caching, real-time features, and admin functionality.

๐Ÿ“ฆ Ready to Download?

Get started building your SaaS application today. Download the free Developer version or upgrade to Enterprise for commercial use and premium features.

๐Ÿ”“ Open Source on GitHub โ€ข Free for personal/non-commercial use โ€ข Enterprise license (ยฃ399) required for commercial use โ€ข Full source code included

Welcome! How can we help you today?
An unhandled error has occurred. Reload ??