WL

Separate Control App

White-Label Superadmin

Setup Guide

Connect operators, clients, modules, and remote control workflows after installation.

Use this guide after the application is live to onboard your first client installation and standardize the operating flow for all future deployments.

Client Environment Keys

PLATFORM_SUPERADMIN_URL
PLATFORM_CLIENT_KEY
PLATFORM_CLIENT_SECRET
PLATFORM_SIGNING_SECRET

1. Sign in and verify environment

Log in with the initial superadmin operator account.
Confirm the app URL, queues, mail delivery, and storage paths are working.
Review dashboard metrics and audit logging before onboarding clients.

2. Create the first client record

Add the client name, identifier, install path, database details, and subscription status.
Register mapped domains and mark the primary production domain.
Rotate credentials before handing any values to the client installation.

3. Publish or assign modules

Create marketplace modules with version metadata, pricing mode, and preview assets.
Publish module versions for the client app to discover.
Assign entitlements for free or paid modules before activation on the client side.

4. Connect the client installation

Set the client app `.env` values to the superadmin base URL, client key, and shared signing secret.
Run the client sync/update checks and verify signed requests resolve successfully.
Test remote command pull, UI sync, and module availability from the client admin panel.

5. Prepare for go-live

Enable production queue workers, scheduler, backups, and alerts on both apps.
Document how updates, credential rotation, and rollback should be handled.
Store the setup notes in your team runbook before onboarding the next client.