App Admin
apps/admin — React + Vite, port 5174. For the organisation’s administrators (admin-app:access);
admins and superadmins sign in with an authenticator app.
| Area | Lets administrators | Permission |
|---|---|---|
| Users | List, search, invite (emailed activation link), deactivate and reactivate, sign out everywhere | users:* |
| Roles | Create roles, grant permissions, assign people | roles:read, roles:write |
| Sign-in | SSO providers (OpenID Connect), turn local sign-in off | identity:configure |
| Notifications | Providers (SMTP, Expo push), template overrides, instance defaults | notifications:configure |
| Plugins | Installed plugins, their settings and secrets | plugins:configure |
| Storage | Usage per plugin | storage:read |
| Workflows | View-only status of background work | workflows:read |
| Audit | The append-only audit log | audit:read |
| Appearance | The user app’s navigation layout (rail, sidebar, top bar), or back to the instance file’s default; App Admin keeps its rail. The plugin order on Home and in the menus (default: the instance file’s plugins: order) |
appearance:configure |
| Plugin pages | Each plugin’s own admin screens (plugins/<name>/admin), e.g. Sales settings and team |
The plugin’s permissions |
pnpm admin:dev # on its own; pnpm dev runs it with the APIGuardrails core enforces: system roles stay, the last superadmin stays, and someone always holds
roles:write.