Prerequisites and Environment

Most admin failures come from environment wiring, not UI usage.

Required control-plane connectivity

• Common must be reachable from the web app.
• Configure VITE_COMMON_BASE_URL (or set Common server from the login flow in development).
• If Common is not configured, /admin/common will not load workflows.

Required infrastructure wiring

Each SynckHub infrastructure must be wired to Common:

• SYNCK_CONTROL_PLANE_BASE_URL
• SYNCK_CONTROL_PLANE_INFRA_TOKEN

Without these, tenant repo provisioning may stay in PROVISIONING.

Browser/API origin constraints

If web and API origins differ, SynckHub API CORS must allow the web origin.

Symptom when misconfigured:

• Browser preflight fails (often OPTIONS 405)

Invite delivery model

Current admin workflows generate invite tokens and links but do not auto-send email.

• Copy tokens/links immediately
• Deliver through approved out-of-band channels
• Treat invite links as credentials until accepted or revoked

Quick readiness check

1. Open /admin/common/infrastructures and confirm infra rows load.
2. Open /admin/common/tenants and confirm infra selector is populated.
3. Create a test invite and verify /invite/accept link resolves.