primus-saas-react 1.0.0

package/DEMO.md

@@ -0,0 +1,68 @@
+# Primus Authentication Demo - One-Click Launch
+
+## Prerequisites
+- Node.js 18+
+- .NET 8 SDK
+
+## Quick Start
+
+### 1. Start Backend (Terminal 1)
+```powershell
+cd examples/LiveDemoApi
+dotnet run
+```
+Backend runs at: http://localhost:5221
+
+### 2. Start UI Gallery (Terminal 2)
+```powershell
+cd test-apps/ui-gallery
+npm run dev
+```
+Frontend runs at: http://localhost:5173
+
+## Demo Flow
+
+1. Open http://localhost:5173
+2. Click **"Platform"** tab
+3. Use the **PrimusLogin** component:
+   - Email: `demo@primus.local`
+   - Password: `PrimusDemo123!`
+4. Click **Sign in**
+
+The component will call the real backend API at `/auth/local` and authenticate.
+
+## What's Happening
+
+```
+┌─────────────────┐      POST /auth/local      ┌─────────────────┐
+│   PrimusLogin   │ ───────────────────────>   │   LiveDemoApi   │
+│   (React UI)    │                            │   (.NET 8)      │
+│                 │ <─────────────────────     │                 │
+│                 │    { access_token }        │  PrimusSaaS     │
+└─────────────────┘                            │  Identity SDK   │
+                                               └─────────────────┘
+```
+
+## API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/auth/local` | POST | Email/password login |
+| `/auth/auth0` | POST | Auth0 token |
+| `/auth/azure` | POST | Azure AD token |
+| `/whoami` | GET | Get current user (requires Bearer token) |
+
+## Configuration
+
+In your app, wrap with `PrimusProvider`:
+
+```tsx
+<PrimusProvider 
+  authority="http://localhost:5221"  // Your API URL
+  clientId="demo"
+  onLoginSuccess={(user, token) => console.log('Logged in!', user)}
+  onLoginError={(error) => console.error('Failed:', error)}
+>
+  <PrimusLogin allowSocial onSuccess={() => navigate('/dashboard')} />
+</PrimusProvider>
+```