๐ Getting Started
Everything you need to get Blazor Blueprint running locally
๐ 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
- Clone the repository:
git clone https://github.com/BlazorBlueprint/Blazor-Blueprint-Lite.git your-saas-app
cd your-saas-app - Restore dependencies:
dotnet restore BlazorBlueprint.sln - Build the solution:
dotnet build BlazorBlueprint.sln
๐ป Development Setup
Option 1: .NET Aspire (Recommended)
- Start MongoDB: Run local MongoDB or configure cloud connection in appsettings.json
- Set
Dev/BlazorBlueprint.AppHostas startup project in Visual Studio - Press F5 or click Run
- Aspire dashboard opens automatically showing all services
- 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:
- Start MongoDB and Redis:
docker run -d --name mongodb -p 27017:27017 mongo:latest
docker run -d --name redis -p 6379:6379 redis:latest - Update connection strings in appsettings.json:
"Database": { "ConnectionString": "mongodb://localhost:27017" }
"ConnectionStrings": { "redisCache": "localhost:6379" } - Run the web application:
dotnet run --project Web/BlazorBlueprint.Web
๐ฏ First Run
- Access the application: Navigate to the Web endpoint shown in the Aspire dashboard (port changes each run)
- Create admin account: Click "Register" and create your first user account
- Explore features: Check out the demo pages and admin panel
- 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