🚀 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