👋 Welcome to PlatformPlatform

Kick-start building top-tier B2B & B2C cloud SaaS products with sleek design, fully localized and accessible, vertical slice architecture, automated and fast DevOps, and top-notch security.

Ships with signup and login via Google or email one-time password, Stripe-powered subscription and payment management with plan upgrades, downgrades, and invoicing, feature flags with A/B-rollout, plan-gating, and per-user/tenant overrides, and a back-office dashboard with MRR and revenue trends, plan distribution, and tenant growth.

Built to demonstrate seamless flow: backend contracts feed a fully-typed React UI, pipelines make fully automated deployments to Azure, and a multi-agent workflow built on Claude Code's native Agent Teams where PlatformPlatform-expert agents collaborate to deliver complete features following the opinionated architecture. Think of it as a ready-made blueprint, not a pile of parts to assemble.

What's inside

• Backend - .NET 10 and C# 14 following the principles of vertical slice architecture, DDD, CQRS, and clean code
• Frontend - React 19, TypeScript, TanStack Router & Query, ShadCN 2.0 with Base UI for accessible UI
• CI/CD - GitHub actions for fast passwordless deployments of docker containers and infrastructure (Bicep)
• Infrastructure - Cost efficient and scalable Azure PaaS like Azure Container Apps and PostgreSQL
• Developer CLI - Extendable .NET CLI for DevEx - set up CI/CD is one command and a couple of questions
• AI rules - 30+ rules & skills, refined and battle-tested over a year of daily use, capturing our opinionated patterns
• Multi-agent development - Agent Teams workflow where specialized Claude Code agents with deep PlatformPlatform expertise collaborate end-to-end

Follow our up-to-date roadmap.

Show your support for our project - give us a star on GitHub! It truly means a lot! ⭐

Back office

Operate the platform from a dedicated SPA on its own hostname, secured by Entra ID Easy Auth:

• Dashboard - KPI tiles for total accounts, blended MRR, all-time revenue, active users, and live sessions; trend cards for MRR, revenue, tenant growth, plan distribution, user logins; activity feeds for recent signups, payments, logins, and Stripe webhook events
• Accounts - Search and filter every tenant; drill into detail with owner, plan, and signup activity
• Users - Cross-tenant user list with role and last-seen filters; drill into per-user profile and tenant
• Invoices - Paginated invoice ledger across every account with Stripe drift detection so finance can reconcile what's in Stripe vs. what landed in the database
• Billing events - Authoritative event log of subscription, payment, and billing transitions, filterable by event type and account, with deep-link from dashboard cards
• Feature flags - Four levers (System / Subscription plan / Account / User) plus A/B-rollout with rich telemetry; declared in C# and surfaced as a strongly-typed React hook; back-office UI for rollouts and overrides

User-facing SaaS product

Production-ready end-user surfaces — fully localized, accessible, and ready to brand as your own product:

• Signup - Tenant signup with email one-time password or Google OAuth (OpenID Connect with PKCE)
• Login - Same OTP and Google sign-in flows, with UNLOCK shortcut on localhost so dev mail is optional
• Welcome - First-run guided flow for naming the account, uploading a logo, and inviting colleagues
• Account settings - Owner-editable account name, logo, and danger-zone account deletion
• User management - Invite users, change roles (Owner/Admin/Member), bulk delete, and recycle-bin restore
• Subscription & billing - Embedded Stripe Checkout & Payment Element, prorated upgrades/downgrades, billing-info editing, scheduled-downgrade banner, dunning, and payment history with invoices and credit notes
• User profile - Personal profile with avatar upload (Gravatar fallback), first/last name, email, and job title
• User preferences - Theme (light/dark/system) and zoom per device, language per profile
• Sessions - Active session list with device type, browser, and OS, plus one-click revocation of any session

Getting Started

TL;DR: Requires .NET 10, Node, and Docker. Clone the repo and dotnet run from developer-cli/ to start Aspire.

Prerequisites

For development, you need .NET, Docker, and Node. And GitHub and Azure CLI for setting up CI/CD.

1. Open a PowerShell terminal as Administrator and run the following command to install Windows Subsystem for Linux (required for Docker). Restart your computer if prompted.

   wsl --install
   

2. From an Administrator PowerShell terminal, use winget (preinstalled on Windows 11) to install any missing packages:

   winget install Microsoft.DotNet.SDK.10
   winget install Git.Git
   winget install Docker.DockerDesktop
   winget install Microsoft.AzureCLI
   winget install GitHub.cli
   

3. Install Node.js — the version must match .node-version. We recommend fnm which auto-installs the exact version via the Developer CLI. When using an IDE like Rider, ensure the active fnm version matches .node-version.

   # Option A: fnm (recommended)
   winget install Schniz.fnm
   
   # Option B: Node.js directly
   winget install OpenJS.NodeJS
   

4. (Recommended) Install the Aspire CLI — provides the Aspire MCP server so Claude Code can inspect AppHost resources, logs, and traces:

   irm https://aspire.dev/install.ps1 | iex
   

   Verify with aspire --version. Restart your terminal if the command is not yet on PATH.

5. (Recommended) Install language servers for enhanced Claude Code support:

   npm install -g typescript-language-server typescript
   dotnet tool install -g csharp-ls
   

Open a terminal and run the following commands (if not installed):

1. Install Homebrew, a package manager for Mac

2. Install packages

   brew install --cask