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 dotnet-sdk
   brew install --cask docker
   brew install git azure-cli gh
   

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)
   brew install fnm
   
   # Option B: Node.js directly
   brew install node
   

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

   curl -sSL https://aspire.dev/install.sh | bash
   

   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 basic tools

   sudo apt update && sudo apt install -y git wget curl libnss3-tools
   

2. Add Microsoft package repository

   source /etc/os-release
   wget https://packages.microsoft.com/config/$ID/$VERSION_ID/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
   sudo dpkg -i packages-microsoft-prod.deb
   rm packages-microsoft-prod.deb
   

3. Install .NET SDK and Docker

   sudo apt-get update && sudo apt-get install -y dotnet-sdk-10.0 docker.io docker-compose-v2
   

   sudo systemctl enable --now docker
   sudo usermod -aG docker $USER
   

4. 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)
   curl -fsSL https://fnm.vercel.app/install | bash
   
   # Option B: Node.js directly
   curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
   sudo apt-get install -y nodejs
   

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

   curl -sSL https://aspire.dev/install.sh | bash
   

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

6. Trust the HTTPS development certificate

   echo 'export SSL_CERT_DIR="$HOME/.aspnet/dev-certs/trust:${SSL_CERT_DIR:-/usr/lib/ssl/certs}"' >> ~/.bashrc
   

   source ~/.bashrc
   

   dotnet dev-certs https --trust
   

7. Log out and log back in to apply Docker group and shell configuration changes.

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

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

9. (Optional) If using Snap Chromium, trust the certificate in its sandbox

   certutil -d sql:$HOME/snap/chromium/current/.pki/nssdb -L >/dev/null 2>&1 || (mkdir -p $HOME/snap/chromium/current/.pki/nssdb && certutil -d sql:$HOME/snap/chromium/current/.pki/nssdb -N --empty-password)
   dotnet dev-certs https --trust
   

10. (Optional) Install GitHub CLI and Azure CLI (needed for CI/CD setup)

(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y)) \
&& sudo mkdir -p -m 755 /etc/apt/keyrings \
&& wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt-get update && sudo apt-get install -y gh
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

1. Go to Google Cloud Console
2. Create a new project (e.g., "YourProduct OAuth")
3. Navigate to APIs & Services > Credentials
4. Configure OAuth consent screen (first time only):
   • App name, support email, audience (External), contact info
   • Agree to Google API Services: User Data Policy
5. Create OAuth client ID:
   • Application type: "Web application"
   • Name: "YourProduct Localhost"
6. Add Authorized redirect URIs (Google does not allow https://app.dev.localhost:9000/):
   • https://localhost:9000/api/account/authentication/Google/login/callback
   • https://localhost:9000/api/account/authentication/Google/signup/callback
7. Note the Client ID and Client Secret

Each developer needs their own Stripe sandbox. The local database stays in sync with Stripe via webhook events -- when payments, subscriptions, or billing details change in Stripe, webhook events update the local database with matching customer and subscription IDs. If developers share a sandbox, webhook events from one developer's actions would corrupt another developer's local database.

1. Create a sandbox: Go to Stripe Dashboard and create an account. Click the account picker (top-left) > Sandboxes > Create. Name it dev-yourname and open it. All subsequent steps are performed inside your sandbox.
2. Create products: Navigate to Product catalog > + Create product. Create a Standard product with Recurring / Monthly pricing (e.g., 19 EUR), then a Premium product (e.g., 39 EUR). Important: Click More pricing options and add standard_monthly and premium_monthly respectively in the Lookup key field.
3. Disable non-card payment methods: Go to Settings (gear icon) > Payments > Payment methods. Turn off every payment method except Cards (and Cartes Bancaires which cannot be disabled)
4. Limit to 1 subscription: Go to Settings > Payments > Checkout and Payment Links, scroll to Subscriptions, and enable Limit customers to 1 subscription. Add link to https://app.dev.localhost:9000/account/billing
5. Configure failed payment recovery: Go to Settings > Billing > Subscriptions and emails > Manage failed payments, and configure desired retry behavior
6. Configure email notifications: Go to Settings > Billing > Subscriptions and emails > Email notifications and customer management, and enable all settings as you see fit. Set "Use your own custom link" to https://app.dev.localhost:9000/account/billing
7. Enable 3D Secure: Go to Settings > Billing > Subscriptions and emails > Manage payments that require confirmation, and check off Enable 3D Secure. The embedded Stripe components support showing e.g. Visa and Danish MitID multi-factor confirmation dialogs
8. Set invoice prefix: Go to Settings > Billing > Invoices. In the Invoice numbering section, change the Invoice prefix to something meaningful for your organization, and optionally reset the Invoice sequence if needed
9. Disable payment link in invoice emails: Go to Settings > Billing > Invoices and uncheck Include a link to a payment page in the invoice email
10. Set up Tax: Go to More > Tax > Locations > + Add test registration and follow the guide. Below is an example for a Danish company (adapt based on your business):
    • Fill out the "Add head office address" side pane with your company address. Click Continue
    • In "Add Tax registration" select your country (e.g., Denmark) and I'm already registered. Click Continue
    • Select Domestic (e.g., "registered in Denmark"). Click Continue
    • Select No to "Do you want to collect VAT on cross-border sales...". Click Continue
    • Select Yes to "Have your sales of goods or digital services... been less than EUR 10,000". Click Continue
    • Select Start collecting immediately in "Schedule tax collection". Click Continue
    • Select Software as a service (SaaS) - business use in "Confirm your tax rates" (should show 25% for Denmark). Click Start collecting
11. Get API keys: Navigate to Developers > API keys. Note the Publishable key (pk_test_...) and Secret key (sk_test_...). These will be needed for the Aspire configuration below.