ParagonPlayground — Getting Started

A application harness to explore using Paragon for integrations.

Prerequisites

Docker Desktop
.NET 10 SDK
Node.js 24+

Setup

1. Generate TLS certificates

# Run once to create + trust a local CA and sign a wildcard cert
.\scripts\setup-certs.ps1

Run this from an elevated (Admin) PowerShell prompt. mkcert needs admin rights to install the CA into the JDK system trust store. Without elevation the OS and browsers still trust the cert, but Java tools will reject it.

This uses mkcert (installed automatically if missing). No hosts file entries needed — *.paragonplayground.localhost resolves to 127.0.0.1 natively.

2. Start infrastructure

cd src\ParagonPlayground
docker compose -f docker-compose.dev.yml up -d

3. Seed data (via CLI)

cd src\ParagonPlayground\backend
dotnet run --project src\ParagonPlayground.Cli -- provision seed

Or create your own org + user:

dotnet run --project src\ParagonPlayground.Cli -- provision org --name "Test Corp" --slug testcorp
dotnet run --project src\ParagonPlayground.Cli -- provision user --email admin@testcorp.com --password s3cret --name "Admin" --org-slug testcorp

4. Open the app

Navigate to https://acme.paragonplayground.localhost and sign in with:

Email: alice@acme.com
Password: password123

CLI Reference

# Run from the backend directory
dotnet run --project src\ParagonPlayground.Cli -- provision org --name "Name" --slug name
dotnet run --project src\ParagonPlayground.Cli -- provision user --email e@x.com --password p --name "User" --org-slug name
dotnet run --project src\ParagonPlayground.Cli -- provision seed