Authgear Site Admin Portal

Admin portal UI for managing all tenants/projects in a given Authgear deployment.

Getting Started

Prerequisites

• Node.js 18+ and npm

Configuration

Copy .env.example to .env and set your deployment's base domain:

VITE_BASE_DOMAIN=your-deployment.example.com

The following URLs are derived automatically from VITE_BASE_DOMAIN:

Service	Derived URL
Authgear endpoint	https://accounts.portal.<base>
Portal URL	portal.<base>
Site Admin API	https://siteadmin.<base>

Any of these can be overridden individually — see .env.example for the full list of optional vars.

Development

npm install
npm start        # http://localhost:3000
npm run build    # Production build
npm run lint     # ESLint

Docker Deployment

docker build -t authgear-site-admin-portal .

Run the same image in any environment by passing config at container startup:

docker run --rm -p 8080:80 \
  -e VITE_BASE_DOMAIN=your-deployment.example.com \
  authgear-site-admin-portal

Override individual VITE_* values if needed.

Tech Stack

• React 18, TypeScript 5, Vite 5
• Fluent UI v8 (Microsoft design system)
• Tailwind CSS + CSS Modules
• React Router v6

Design Reference

• Figma: Portal - 2025
• Reference implementation: reference/portal/

License

Apache License 2.0