Console, portal, and marketplace UX
Status: open design. Facts marked shipped were measured on compose01 (
shc 0.0.62~SNAPSHOT-ce2cb4ed9, 2026-08-24) or sit onorigin/mainat3a0b70ebb. Everything else is PROPOSED. Section 13 repeats the full PROPOSED list so a mockup cannot smuggle a new control in as if it already shipped.
This is a reference for the three operator-facing surfaces. It describes what is true, what the v3 mockups drew, and where those two disagree. It does not implement UI.
Companions for product model (not visual language):
2026-08-14-console-architecture.md2026-08-14-portal-architecture.md2026-08-14-marketplace-architecture.md2026-08-16-settings-surface.md
The 14 August console ruling still said / should be a stacks list and the springboard should leave the console. That reshape did not happen. 3a0b70ebb on this tree is the opposite ruling, in a commit subject: the springboard lists what you can manage, not what you can visit. Treat the older owed item as historical.
Sources for this file: the 24 August views brief, final-dark.html / final-light.html (v3), the five review PNGs, and the session visual constraints already applied to those mockups. App names come from the views brief’s estate capture. Names that appear only in a mockup are called out in §14 and must not be copied into product chrome.
1. Three surfaces, two products
Section titled “1. Three surfaces, two products”Per MPO LC-160, LC-110, LC-175.
| Surface | Host | Job | Renderer |
|---|---|---|---|
| Launcher | Traefik plugin, 52px floating trigger, injected into launcher-carrying pages | Destinations. A list of places you can go. | Hand-drawn ES5 in a shadow root. shc/traefik/plugin/menu*.go |
| Console | Estate public URL, /, served by shcd | Management. The grid of things you can operate, plus the only mutation rows in the product. | React + Tamagui. packages/springboard-ui/, features/console/ |
| Portal | my.selfhostedcloud.org (central, never self-hosted) | Register clusters, fleet, billing, install dispatch, support bundles, BYO-credential provision | Frappe bench. Ruled 2026-08-14. |
| Marketplace | marketplace.selfhostedcloud.org (central) | Browse the catalogue; dispatch installs onto a registered cluster | Frappe + storefront. Ruled 2026-08-14. Free to browse, Hobby to install. |
Naming trap: features/console/src/launcher/menu.ts is the console’s tab register. shc/modules/launcher/ is the licence gate. Neither is the floating trigger.
The 14 August console ruling asked for 100% look-parity with the launcher through shared tokens and assets, never shared code. Geometry already has a drift test (launcherGeometry.spec.ts reads menu_homescreen.go and menu.go). Menus, chrome, and tile population stay different on purpose. Do not “fix” the gap by making the launcher a console.
2. Visual language
Section titled “2. Visual language”2.1 Hard bans (session, already in the HTML)
Section titled “2.1 Hard bans (session, already in the HTML)”Per MPO Axiom 13, LC-127.
Per MPO LC-131, LC-133, LC-163.
Per MPO LC-85.
Per MPO LC-127, LC-40.
2.2 Press
Section titled “2.2 Press”Per MPO LC-163, Axiom 4.
Per MPO LC-163, LC-24.
Per MPO LC-163, LC-43.
Per MPO LC-43.
2.3 Shadow budget
Section titled “2.3 Shadow budget”Per MPO LC-85, Axiom 14, LC-151.
2.4 Colour and type
Section titled “2.4 Colour and type”Per MPO Axiom 10, LC-131, LC-172, LC-166.
Per MPO Axiom 12, LC-166, LC-104. SHC’s ruling: severity never sits as a pip on an icon.
Per MPO LC-212.
Per MPO LC-08, LC-147.
2.5 Scrim and motion
Section titled “2.5 Scrim and motion”Per MPO LC-164, Axiom 7. SHC’s values: scrim 58% dark, 34% light.
Per MPO LC-59, LC-24, Axiom 4, LC-28.
Gradients: wallpaper (one LinearGradient, four token stops, 158°) and one sparkline fill. Budget three, spent two. No fade into the dock.
3. Geometry
Section titled “3. Geometry”Shipped, identical on launcher and console, guarded by launcherGeometry.ts + launcherGeometry.spec.ts. Owner ruling 2026-08-19.
| value | |
|---|---|
| icon | 60 px, radius 14 |
| caption | 11 px in a 15 px line box, marginTop 6 |
| row height | 95 |
| gaps | 18 / 8 |
| padding | 6 / 16 |
| columns | 4 below 700 px, 6 above |
| dock | gap 18, radius 26 |
Launcher-only chrome, deliberately not copied: 52 px trigger at radius 16, “Applications” panel header with a 44 px close button, 104 px fallback grid track.
Console-only chrome, shipped: status bar (clock, conditions, account button), system-app dock, home indicator, Spotlight overlay.
Mockup boards that draw 8 columns (Operator HTML) or a four-cell estate ribbon are PROPOSED and they fight the geometry table. See §14.
4. Console springboard
Section titled “4. Console springboard”4.1 What the grid is
Section titled “4.1 What the grid is”Per MPO LC-209.
Folders are user-made: drag one icon onto another. The product ships no folders and no categories. Two folders in a mock are evidence that folders exist, not a suggested IA.
4.2 Real names, this estate
Section titled “4.2 Real names, this estate”Use these names. Do not invent apps to fill a grid.
master / default (4): keycloak, openobserve, postgres, traefik
shc / prod (3): keygen, keygen-db, license-broker
corp / prod (75):
affine, affine-rs-db, bit, bit-db, ciso, ciso-db, crowdsec, docs,
dtrack-db, ffx, ffx-db, fleet, fleet-db, gitlab, gitlab-db, gitlab-huly,
glitchtip, glitchtip-db, hookshot, huly-db, huly-nextcloud,
huly-nextcloud-db, hz-s3, identity-broker, identity-broker-db, immich-db,
ivatar, ivatar-db, librechat, librechat-db, mailbox-reconciler,
mailbox-reconciler-ffx, mailcow, marketplace, matrix, matrix-db, mautic,
mautic-db, midpoint, midpoint-db, minio, minio-dr, nc, nc-db, nc/mail,
netbird, netbird-db, ollama, oncall, oncall-db, openreplay, openreplay-ch,
openreplay-db, paperless-db, peertube, peertube-db, penpot, penpot-db,
photos, postgres, postiz, postiz-db, projects, pulp, pulp-db, pulp-s3,
ses, supabase, superset, superset-db, uptime, vpnproof, wazuh, windmill,
windmill-db
28 corp names end in -db. Those fold under the parent when belongs_to is set. A full grid is roughly 45 to 55 tiles, not 75. Draw that density.
Tenants registered: cloud (0), corp, default (0; CLI active context), desibox (0), master, shc, zz-subprobe-a (0), zz-subprobe-b (0). Two environment values estate-wide: prod and default. Zero blank-environment rows.
Caption the tile with the stack name (nc, not “Nextcloud”) unless a display name is already on the wire. Hostnames in overlays may use the live host (gitlab.hel1.hetzner is mock furniture; prefer the estate’s real host when drawing a worked example).
4.3 Manage versus visit
Section titled “4.3 Manage versus visit”The launcher grid is host-required at SQL (ListIngressIntents inner-joins host_mapping). A deployment with no routed host is not a menu entry. On top of the join the plugin drops unplaced non-sidecars, drops api-role hosts, filters to the tenant owning the requesting host, applies RBAC, collapses environments, folds sidecars.
The console reads GET /api/resource/Stack with no host join. Since 3a0b70ebb it renders hostless deployments as manage-only tiles. The console grid is a strict superset of the launcher grid, by seven tiles on this estate. Intended.
has_host and launcher_placed are different. Placement is a declaration (“this routed host is an embed”). has_host is an observation (“no host_mapping row”). Conflating them already took mysql, mariadb, external-s3 and external-smtp off the console once.
Click on a tile with a routed host: visit is a menu row (Open), not the body default on the console. Click on a manage-only tile body: navigate in place to /stacks/<name>. cursor: context-menu on those tiles. Full colour, not dimmed.
4.4 The seven hostless deployments
Section titled “4.4 The seven hostless deployments”Measured. No host_mapping row. Launcher cannot show them. Console shows them as manage-only:
crowdsec, minio, gitlab-s3, keygen, identity-broker, huly-nextcloud, hz-s3
Same menu shape for all seven: no Open, no Copy link address, then the seven management rows and lifecycle. See §6.3.
postgres is not in this list. The mockups used it as the hostless exemplar. That is wrong; see §12.1 and §14.
4.5 System dock (shipped contents)
Section titled “4.5 System dock (shipped contents)”V1 platform admin, measured: Events, Settings, Manage, Marketplace, Keycloak.
Per MPO Axiom 6 (DG-ST-03 hide arm).
Mockup docks that draw Search / Pulse / Terminal / Bell / theme-toggle are PROPOSED and they are not the shipped set.
5. Tile states
Section titled “5. Tile states”| state | launcher | console |
|---|---|---|
| normal | rgba(148,163,184,.10) fill, #F8FAFC caption | same tokens (until a pole’s theme tokens replace them) |
unreachable from this network (x) | glyph at 0.45 opacity; caption untouched; ", not reachable from this network" in title and aria-label | identical wording (StackTile.tsx:140-155,250,279). Shipped code still names grayscale(1) on the glyph; that property is banned for new work. Keep the words and the 0.45 opacity; drop the filter. |
unentitled (u) | whole anchor at opacity 0.5; aria-disabled deliberately not set; reason in the accessible name | does not exist. A caller with no estate verb never passes the console gate. |
current page (c) | blue tint, aria-current="page" | does not exist, and should not. The console is never inside an app. |
| manage-only | cannot happen; the tile is absent | full colour, cursor: context-menu, "no address, manage only" in the accessible name |
| status dot | none | exists but off (affordances.ts statusDot: false). With the dot off, status text joins the accessible name. |
| down / stopped | not a launcher concept | PROPOSED (v3 mockups). Mark 0.38 opacity + red wash + muted label. No corner pip. |
Per MPO LC-104, Axiom 12, Axiom 6.
Per MPO LC-103.
6. Menus
Section titled “6. Menus”6.1 Row-by-row matrix (shipped)
Section titled “6.1 Row-by-row matrix (shipped)”Left: launcher (menu_stack.go:552). Right: console (StackMenu.tsx:355-447, fed by StackTileContainer.tsx).
| row | Launcher | Console | why |
|---|---|---|---|
| structure | one flat list, no sections, no separators, no labels | six sections with separators and labels | destinations vs control surface |
| Open | present only when the tile has an href | present, omitted (not disabled) when hasRoutedHost is false | hostless tiles cannot exist in the launcher |
| Rename | folder tiles only | folder tiles only | parity, intended |
| Copy link address | absent | present, omitted without a URL or navigator.clipboard | hole; see §6.4 |
| Part of this app (sidecars) | flat rows, child stack name, plus " (env)" when the child’s env differs and is not default | labelled section; each row goes to /stacks/<child> | designed |
| Add-ons (vapps) | flat rows; attachConsoleKids repairs them into console deep links | labelled section; /stacks/<parent>?vapp=<name> with a detail second line | designed |
| Management tabs | absent | 7 rows, canonical order: Logs, Telemetry, Events & jobs, Volumes, Backups, Update, Shell | owner 2026-08-18 |
| Manage in Console | every non-console tile; the launcher’s only management row | n/a | the pointer from one surface to the other |
| Lifecycle | Per MPO LC-208. | ||
| error slot | Per MPO LC-208. | ||
| Environment rows | withdrawn 2026-08-17 | withdrawn the same day | parity |
| empty menu | Per MPO Axiom 6 (DG-ST-03). | ||
| row anatomy | <a target="_blank" rel="noopener"> when the kid has a host; kids with no destination dropped on the wire | Tamagui DropdownMenu.Item / SheetRow. Every row is an in-app intent | launcher must leave the host page; console must not |
| popup | Per MPO LC-163, LC-139, LC-28. |
Do not “fix”: no lifecycle in the launcher, Manage in Console on only one surface, two popup renderers, launcher opening rows in a new tab.
6.2 Worked example: nc (Nextcloud, corp/prod, routed host)
Section titled “6.2 Worked example: nc (Nextcloud, corp/prod, routed host)”Sidecar nc-db, add-on nc/mail.
Launcher (shipped)
OpenmailManage in Consolenc-db is hostless, so renderMenuKids drops it. mail survives because attachConsoleKids repairs vapp rows. Three anchors, all target="_blank".
Console (shipped)
OpenCopy link address──────────────────────PART OF THIS APP nc-db──────────────────────ADD-ONS mail …second line: detail──────────────────────LogsTelemetryEvents & jobsVolumesBackupsUpdateShell──────────────────────LIFECYCLE Start Stop ← destructive, confirm Restart──────────────────────[ actionError, only after a failed verb ]Fifteen rows against three. Most of that gap is designed.
6.3 Worked example: crowdsec (hostless)
Section titled “6.3 Worked example: crowdsec (hostless)”Launcher: the tile does not exist.
Console (shipped): manage-only, full colour, cursor: context-menu.
──────────────────────LogsTelemetryEvents & jobsVolumesBackupsUpdateShell──────────────────────LIFECYCLE Start Stop RestartNo Open, no Copy link address. Body click goes to /stacks/crowdsec.
Same shape for minio, hz-s3, identity-broker, huly-nextcloud, keygen, gitlab-s3.
Per MPO Axiom 6 (DG-ST-03 explain arm), LC-40.
6.4 Differences with no ruling (flag, do not ship as done)
Section titled “6.4 Differences with no ruling (flag, do not ship as done)”Copy link addressmissing from the launcher. The plugin stealsoncontextmenuand gives nothing back. PROPOSED launcher row.- Folder menu is asymmetric. Console folder menu has
Open; launcher folder menu does not. Pick one. - Per MPO Axiom 6 (DG-ST-03).
- Sidecar labels spelled differently. Launcher appends
" (env)". Console uses a labelled section and plain names. - Environment chip is console-only. Drawn when a stack spans more than one environment. Launcher appends nothing (
menu.go:2755-2785). Samepostgresis labelled two ways. Owner call, not a designer guess. menuEmbed: true. Floating menu is the console springboard in an iframe, fed byEntitledSource. Nohas_host, no vapps, noparent_stack, no status. Add-ons and Part-of-this-app always empty; every tile looks openable. Defaults off. Do not mock as shipped.- Hidden console affordances. See §5.
7. Management overlay and tabs
Section titled “7. Management overlay and tabs”7.1 Settled tab register (shipped, owner 2026-08-18)
Section titled “7.1 Settled tab register (shipped, owner 2026-08-18)”Superseded by MPO LC-170.
Per MPO LC-128.
update is one tab. Vars, version, exposure, placement, replicas and wiring are one daemon call (shc update). Splitting that call across “Config” / “Secrets” / “Management” made the blast radius invisible.
Per MPO LC-92.
Tenant and environment ride the navigation from the tile. A link without them 403s or 404s even for a platform admin who just saw the tile.
7.2 Overlay chrome (shipped idea, v3 drawing is PROPOSED)
Section titled “7.2 Overlay chrome (shipped idea, v3 drawing is PROPOSED)”Per MPO LC-28, LC-111, LC-164.
Per MPO LC-170, LC-128.
Inside the tabs, controls that disable at tenant:read (all estate-wide, none per-deployment):
| screen | gated on |
|---|---|
| Overview | operate |
| Containers | manage and operate |
| Jobs | operate |
| Backups | manage |
| Describe | manage |
| Update | manage |
| Shell (exec) | manage |
Per MPO LC-208.
Mockup tab strips that say Overview / Logs / Shell / Config / Backups / Integrations are wrong. Config is a retired alias. Integrations is not a tab. See §14.
8. Environment switching
Section titled “8. Environment switching”8.1 What exists (shipped)
Section titled “8.1 What exists (shipped)”EnvironmentSwitcher.tsx is orphaned. Exported, rendered nowhere. Do not design against it.
Behaviour:
- Client-side view filter only. Nothing reaches the daemon.
- State is
localStorage["shc.console.environment"]viauseSyncExternalStore; memory is authoritative once written. - Default
undefined= every environment. - Options are derived from loaded Stack docs. There is no environment endpoint and no Environment doctype. An environment exists exactly when something is deployed to it.
- Applied in two places: the springboard grid and folders, and Spotlight.
- Not in the URL. A scoped view does not survive a shared link.
- Ordering uses the launcher precedence comparator. The first row gets a “launcher” badge.
launcher.environment_precedenceis unset on this estate, soprod= 0,default= 5.
Environment is a filter, not a boundary. Nothing checks whether you may see an environment.
8.2 What does not exist
Section titled “8.2 What does not exist”- No tenant switcher.
CanAccessTenantistenantName == "" || IsPlatformAdmin() || tenantName == u.TenantName.u.TenantNameis one string from the token’s realm. Multi-tenant access is binary: master-realm platform admin sees every tenant; everyone else sees exactly one. - The only tenant-crossing control is a free-text “Tenant” box on Manage / Resource list screens (
?tenant=→X-SHC-Tenant). Per-noun, not chrome. - No server-side environment narrowing from the console.
?environment=exists on the list route andStackFilter.Environmentis wired and unused. - No
X-SHC-Environmentheader from any frontend. ce reads it. Nothing in shc writes it. - Not persisted server-side.
localStorage, per-browser. SSR snapshot isundefined, so the first paint is always unfiltered and the client corrects on hydrate. Design for that flash. AccountButton.tsx:137fires a seconduseDocList("Stack")just to populate options. Known. Fix is a shared query cache, not built.
8.3 Degeneracy
Section titled “8.3 Degeneracy”Per MPO Axiom 9 (DG-CTRL-01).
8.4 PROPOSED
Section titled “8.4 PROPOSED”Superseded by MPO LC-162.
PROPOSED, needs engineering:
- Per MPO LC-112, LC-161, LC-104.
?scope_env=prodin the URL, layout-owned, so a scoped view is shareable. Must not become a second writer of the screen-owned?env=.- Push the scope as
?environment=prodon the Stack list read.StackFilteralready accepts it. - Server-persisted preference so the scope follows the user across devices.
9. Seven role views
Section titled “9. Seven role views”There are no named personas in either tree. No owner, admin, member, developer, support. A persona word in a mockup is a UI synonym for a verb tier and must be labelled as one. support and support_bundle are licence feature keys.
Grammar: scope:verb. Verb ladder use(1) < read(2) < operate(3) < manage(4). deny is not a verb.
Three console bands (modules/console/access.go:161):
| band | requirement |
|---|---|
| Console (Ops) | estate verb ≥ read |
| Settings | estate verb ≥ manage |
| Platform tier inside Settings | platform_admin from effective-apps |
Refusal codes, role checked before licence so a no-role identity never sees an upgrade pitch:
X403522CONROLE: “it needs tenant:read or higher in this realm”X403523CONMANAGE: Settings surface, verb belowmanage
Hiding a control is a courtesy; the daemon is the authority. Absent verb reads false.
Per MPO LC-165.
Per-app management grants do not work as a console door. stack:<name>:manage is provisioned and gates SSO, log reads, and app listing, but every management API gate resolves its resource to the literal string "tenant" because no client sends X-SHC-Stack. A per-stack grant satisfies none of those gates and opens no console. The nearest true thing is an estate-wide verb tier on one tenant. Mark any per-tile permission chrome PROPOSED and, today, untrue.
V1. Platform admin (shipped)
Section titled “V1. Platform admin (shipped)”Master-realm identity, or node-local shc over the UDS socket. Master membership alone is platform root: applyMasterRealmPrivilege appends platform:manage with no grant required. 1 identity on this estate.
GET /api/resource/Stack with no tenant param returns every tenant: 82 rows across corp, master, shc. effective-apps.platform_admin is true.
Springboard: one grid mixing all three tenants. Roughly 45 to 55 tiles after -db fold. Nothing marks which tenant a tile belongs to. Seven manage-only tiles. The postgres tile is the collision in §12.1 and the only tile carrying an environment chip. Account menu shows prod and default. Dock: Events, Settings, Manage, Marketplace, Keycloak. Spotlight on ⌘K.
Tile menu: every row enabled. Stop confirms.
Absent: tenant switcher, tenant column, tenant filter, any way to tell from a tile that postgres is two deployments in two tenants. Cross-tenant is the most powerful view and it has the least chrome.
V2. Tenant manager, one tenant (shipped)
Section titled “V2. Tenant manager, one tenant (shipped)”tenant:manage in their realm. 2 in corp, 1 in shc. Estate verb manage.
List read collapses empty tenant to their realm: a corp manager gets the 75 corp rows and nothing from master or shc. Gate passes both bands. User and role admin is pinned to their own realm by ResolveTargetTenant.
Springboard: corp grid only. Five manage-only tiles (crowdsec, minio, hz-s3, identity-broker, huly-nextcloud). No environment chip (every corp deployment is prod). Account environment section is degenerate. Settings present in dock and launcher.
Tile menu: identical to V1, all enabled.
Per MPO Axiom 6 (DG-ST-03), LC-165.
tenant:manage composites to realm-management/realm-admin on ce main as of 8c7a20a9, but the estate runs a pin from the day before. Of corp’s 2 managers, exactly 1 also holds realm-admin (hand-assigned). Do not draw Keycloak administration as a settled tenant-manager capability yet.
V3. Read-only support (shipped; EE-only grant)
Section titled “V3. Read-only support (shipped; EE-only grant)”tenant:read. 1 in corp. BaselineRole on community passes only tenant:manage, tenant:use, tenant:deny and stack:*. shc user grant <u> tenant:read refuses with X403988RBCEEO on CE. The read-only persona the console is designed around is a paid grant.
Same 75 corp rows. Ops passes. Settings refused with X403523CONMANAGE.
Springboard: same corp grid as V2, pixel for pixel. Settings tile gone from dock and launcher (menu_profile.go:303). Keycloak tile removed, not dimmed.
Per MPO Axiom 6 (DG-ST-03), LC-40.
Absent: Settings entirely. Rollback and uninstall in the overlay header. Any per-app escalation. There is no “request access”.
V4. Operator (real in the ladder, zero holders; screenshots synthetic)
Section titled “V4. Operator (real in the ladder, zero holders; screenshots synthetic)”tenant:operate. Same corp rows. Ops passes, Settings refused. Springboard same as V3.
Per MPO LC-208.
Absent: Settings. Update, Backups create/restore, Describe, and Shell exec stay disabled (manage).
V5. App-entitled, no console (shipped)
Section titled “V5. App-entitled, no console (shipped)”Holder of one or more stack:<name>[:verb] grants and nothing at tenant tier. 4 in corp. Real grants:
| role | holders |
|---|---|
stack:midpoint:use | 3 |
stack:openreplay:use | 2 |
stack:gitlab-huly:use | 1 |
stack:glitchtip:use | 1 |
stack:mautic:use | 1 |
stack:nc:use | 1 |
stack:nc:read | 1 |
Every per-stack tier in use is use, except that single read. Zero holders of stack:*:manage, stack:*:operate, or stack:*:deny.
Forward-auth SSO into their apps: allowed. effective-apps: 200, their apps, per-app verb + source. shc.console.menu: 200, tenant tiles with verb and entitled. GET /api/resource/Stack: 403 X403900NOPERM. shc.console.gate: 403 X403522CONROLE.
Springboard: none. Their surface is the floating launcher.
Per MPO LC-104, Axiom 6.
A holder of stack:midpoint:use + stack:nc:use sees midpoint and nc at full strength and affine, docs, gitlab, mautic, glitchtip, openreplay, penpot, photos, wazuh and the rest at 50%.
Per MPO Axiom 6 (DG-ST-03).
stack:blog:manage is a manager of one deployment and deliberately does not clear the estate floor. Their door is that deployment’s own tile, not the estate console.
V6. Signed in, nothing granted (shipped; the plurality)
Section titled “V6. Signed in, nothing granted (shipped; the plurality)”default-roles-<realm> only, empty shc-app-access group. 43 of 49 corp users. Groups grant nothing: corp/shc-app-access has 48 members and zero role mappings, created empty on purpose.
effective-apps: 200, empty list. shc.console.menu: 200, every tile entitled: false. Stack list 403. Gate 403 X403522CONROLE. handleConsole still serves the SPA; role is not checked at the byte level, only gateDecide (licence) runs there. This user loads the console and watches it fail.
Per MPO LC-165, LC-84, Axiom 6 (DG-ST-04).
Launcher: every tenant tile at 50%, console tiles removed, Settings removed. Account chip and sign-out still in the panel header.
Per MPO LC-165.
V7. Denied (shipped identity; do not design a deny state)
Section titled “V7. Denied (shipped identity; do not design a deny state)”Per MPO LC-165.
9.8 Matrix
Section titled “9.8 Matrix”| V1 platform admin | V2 tenant manager | V3 read-only | V4 operator | V5 app-entitled | V6 nothing | V7 denied | |
|---|---|---|---|---|---|---|---|
| holders on estate | 1 | 3 | 1 | 0 | 4 | 43 | 0 |
GET /api/resource/Stack | 200, all tenants | 200, own realm | 200, own realm | 200, own realm | 403 | 403 | 403 |
effective-apps | 200 + platform_admin | 200 | 200 | 200 | 200, their apps | 200, empty | 200, empty |
| console springboard | full grid | full grid | full grid | full grid | none | error card | error card |
| Settings tile | yes | yes | removed | removed | removed | removed | removed |
| Keycloak tile | yes | yes | removed | removed | removed | removed | removed |
| lifecycle rows | live | live | disabled + reason | live | n/a | n/a | n/a |
| Update / Shell / Backups | live | live | disabled | disabled | n/a | n/a | n/a |
| licence + tenant mutations | live | read-only | n/a | n/a | n/a | n/a | n/a |
| launcher tiles | all, entitled | tenant, entitled | tenant, entitled | tenant, entitled | mixed, 50% on unentitled | all at 50% | all at 50% |
10. Portal, same visual language
Section titled “10. Portal, same visual language”Product model is RULED (14 August, refined 16 August). Visual application of §2 is PROPOSED; no portal frame exists in the v3 mockups or the views brief.
10.1 What it is
Section titled “10.1 What it is”Central product at my.selfhostedcloud.org. “The point of the portal is registering your clusters.” Run by us, never self-hosted. ce does not grow a portal registration surface.
Functions: central accounts · cluster registration · fleet view · marketplace install dispatch · support bundles · licence/billing self-serve · cloud provisioning with the customer’s own credentials (the BYO path already ruled: Portal runs shipped Terraform with customer cloud creds; state and those creds live in a dedicated OpenBao/KMS, not the estate vault).
Identity is shared with the marketplace (Keycloak accounts we manage). Federation is one-way: vendor IdP into the customer’s master realm only. The portal never creates users in a customer’s Keycloak. Consoles are linked out in new tabs, never embedded. A console never switches to another console.
Registration unlocks marketplace and support bundles. Airgapped estates get neither unless they open our IPs and register. Registration stays optional in every tier.
Free: one registered cluster, fleet view, marketplace installs (licence still has to allow the install; see §11), one-off support codes. Paid: multi-cluster fleet, provisioning, standing support-bundle access.
10.2 What to draw (PROPOSED)
Section titled “10.2 What to draw (PROPOSED)”Per MPO LC-160, LC-110, LC-133.
This is not a springboard. A portal home lists clusters, not deployments. Do not reuse the 6-column app grid for machines. A cluster row is a name, a health sentence, a licence line, and a “Open console” action that leaves the page.
Per MPO LC-162.
Per MPO LC-186. BYO provision names the cloud (the live six: hetzner, aws, azure, digitalocean, scaleway, exoscale) and says those secrets are not stored in the cluster vault. Do not invent a second marketplace inside the portal; install dispatch is a handoff to the store with a daemon-minted, cluster-bound, single-use assertion (16 August decision). No cluster picker in the store.
Support-bundle modes already ruled: rotating one-off code, or standing access. Draw those as two explicit states, in words.
Per MPO LC-165.
11. Marketplace, same visual language
Section titled “11. Marketplace, same visual language”Product model RULED. Visual application PROPOSED. The storefront already ships as a central site; this section is the skin and the console/portal seams, not a rewrite of commerce.
11.1 What it is
Section titled “11.1 What it is”marketplace.selfhostedcloud.org. The cluster is usable without the store. The store requires a central login for anything beyond browsing. Opens in a new tab, never an iframe. The GitLab Pages catalogue at selfhostedcloud.org/apps is retired.
Browse needs neither registration nor a paid licence. A store-dispatched install needs both a registered channel and Hobby-or-above permission. Open-source apps are never sold.
Console /apps (when present) is the daemon catalogue with direct installs, self-sufficient on unregistered and airgapped estates. The marketplace link sits beside that and leaves the page. Do not rebuild the iframe dock.
Users may add repos via the CLI, never via the marketplace.
11.2 What to draw (PROPOSED)
Section titled “11.2 What to draw (PROPOSED)”Per MPO LC-212.
Listings that our own packages ship still have no gallery: bytes (measured 2026-08-16: 0 of 90 first-party app.yaml files). Foreign adapters already emit gallery. The asymmetry is a defect; the field name is already gallery, not screenshots. Until first-party captures exist, do not draw a carousel of invented shots. A flagship landing page with real HTML is a separate proposal (2026-08-16-app-landing-pages.md); today the live storefront’s SSR document does not even contain the app’s name as visible text. Mark any rich landing PROPOSED.
Per MPO LC-16, LC-08.
Per MPO Axiom 6 (DG-ST-03), LC-165.
A console Marketplace dock tile is the store in a new tab, with whatever assertion the daemon minted. No cluster picker.
12. Open defects (document, do not decide)
Section titled “12. Open defects (document, do not decide)”12.1 Postgres tenant collision
Section titled “12.1 Postgres tenant collision”Per MPO LC-213.
postgres is not hostless. The hostless set on this estate is crowdsec, minio, gitlab-s3, keygen, identity-broker, huly-nextcloud, hz-s3.
12.2 Affine gate inconsistency across estates
Section titled “12.2 Affine gate inconsistency across estates”Last spoken board in the expired session called this an owner decision, still open. Facts only:
- Catalogue posture for AFFiNE / affine-rs is ungated (
access: open). Apps with native OIDC stay ungated because the forward-auth gate 401s API and WebSocket traffic. For affine-rs that cost is measured: every WebSocket upgrade credential through a gated route returned 401; the app loads, signs in, renders, and never syncs (docs/architecture/flows/authentication.md,docs/proposals/sso-auto-redirect.mdEMP-A). sso_redirect:is declared and was recorded as armed on both estates (2026-08-10). That is edge auto-redirect, not the forward-auth gate. Different axis.- bitspur deployfile work writes
gated: falsefor affine. promanager deployfile work omitsgated:. Omission may arm a gate. - Live evidence on promanager:
knowledge.corp.promanager.vip(affine-rs) was recorded as gated in the v0.0.50 roll note, and still auto-redirected to Keycloakclient_id=affine-rs. - bitspur corp/prod runs
affine(views brief name list), not theaffine-rspackage name. - First-deploy of affine on a new estate is blocked on a ruling. Do not import or apply affine until that ruling exists.
Do not pick gated vs open here. A console or marketplace tile that implies one posture for all estates would be lying. If a drawing must show affine, show the stack name and stay silent on the gate, or show both estates’ facts as a defect banner.
13. What must not be invented
Section titled “13. What must not be invented”Mark every item below PROPOSED if it appears in a mockup. None of it is shipped. Copied from the views brief so the list cannot drift.
Permissions and identity
- Per-deployment management from the console. Needs a writer for
reqctx.Stackor handler-level narrowing, plus reopening the console’s estate floor. Ruled out by design.auth.RequireStackexists with zero production callers. - Per-tile permission states driven by a per-app verb. Every
canManage/verbAtLeastreads the estate tier. - A role picker. Settings › People is a free-text field:
tenant[:verb], stack:<name>[:verb], platform[:verb]. No app list, no verb dropdown, no validation before the round trip. - Named personas. A persona label is a UI synonym for a verb tier and should say so.
- Group-driven access. The daemon parses no
groupsclaim.shc-app-accessis an empty socket on purpose. - A distinguishable “denied” state. See V7.
- A designed no-access landing. Today’s card is a generic 403. Designing one is welcome; mark it new.
Environment and tenant scope
- Environment in the URL.
?scope_env=does not exist and must not collide with?env=. - Server-side environment narrowing. The console never sends
?environment=orX-SHC-Environment. - A scope that survives a shared link or another device.
localStorageonly. EnvironmentSwitcher.tsxas a component. Orphaned. Live control is inlined inAccountButton.
Menus and tiles
- Lifecycle verbs in the launcher menu. Never existed, audited.
Copy link addressin the launcher. Missing. Worth proposing; do not draw as shipped.- An environment badge on launcher tiles. Ruled out on that surface.
- Console status dot, visible
⋯button, status-bar magnifier. Knobs defaultfalse. If you draw one, name the knob. - A current-page highlight on console tiles. Launcher-only, meaningless on the console.
- An
unentitled(50% opacity) console tile. Structurally unreachable. - The launcher rendered as a framed console.
menuEmbeddefaults off. In that mode Add-ons and Part-of-this-app are always empty. - Health or uptime on a tile beyond the existing status vocabulary. Uptime Kuma monitors are a closed manual decision and are not a tile data source.
Two invariants
- Per MPO LC-104, Axiom 12.
- Per MPO LC-208.
14. Contradictions: mockups versus the views brief
Section titled “14. Contradictions: mockups versus the views brief”The v3 HTML is the current mockup intent. The PNGs (_fA, _fB, _fC, _full1) are older (timestamp ~03:40 the same morning; HTML ~06:01) and still show work the HTML deleted. _p1 matches Quiet Ground’s phone overlay (frame G) and is current for that pole.
| Topic | Views brief / shipped code | Mockups | What wins for implementation |
|---|---|---|---|
| App names | Estate lists in §4.2. nc, not nextcloud. No redis, vaultwarden, grafana, wordpress, docuseal, meilisearch, goalert, ghost, clickhouse, pgbouncer, plausible, valkey, registry as estate tiles. | Both HTML files and the PNGs fill the board with catalogue/demo names, including two meilisearch cells and folders named “Annie” / “Comms” / “Ops” / “Try later”. | Brief. Folders may be user-named; the tiles inside must be estate names. |
| Hostless set | Seven: crowdsec, minio, gitlab-s3, keygen, identity-broker, huly-nextcloud, hz-s3. | postgres / redis / meilisearch / gitlab-db as the manage-only exemplars. postgres long-press shows “Open no endpoint”. | Brief. postgres is the collision tile (§12.1), not hostless. gitlab-db is a sidecar and folds. |
| Columns | 4 < 700 px, 6 ≥ 700 px. | Operator HTML: repeat(8, 1fr). Quiet Ground: 6 columns, 24 slots. | Brief / launcherGeometry.ts. |
| Taxonomy | One grid. No headers. | PNG frames still show WORKSPACE / PLATFORM / DATA & INTERNALS, counts, and a recessed internals band. v3 HTML deletes all of that. | v3 HTML + brief. PNGs are stale. |
| Status pip | Off. Knob statusDot: false. | PNGs pin a green/amber/red pip to the icon corner. v3 HTML removes it. | Brief + v3 HTML. |
| Selection / press ring | Forbidden. | _fB still reads as a highlighted postgres with a glowing edge (pre-v3). v3 HTML deletes .fa-tile-sel / accent fill. | Session constraint + v3 HTML. |
| Tab strip | Overview + Logs, Telemetry, Events & jobs, Volumes, Backups, Update, Shell. | Overview, Logs, Shell, Config, Backups, Integrations (and keyboard ⌘1–⌘6 on that invented set). | Shipped register. config aliases to Update. Integrations is not a tab. |
| Open on hostless | Omitted on the console. | Present, disabled, reason on the row. | Shipped = omit. Present+disabled is PROPOSED (§6.3). |
| Search | Spotlight via ⌘K. Magnifier knob false. | Persistent search field (/ or ⌘K) on the board. | Field is PROPOSED; name the knob. |
| Estate ribbon / All–Running–Attention | Not console chrome. | Operator HTML and PNGs draw Nodes / Capacity / Backups / Down cards and a segmented filter. Quiet Ground drops the ribbon, keeps a “2 stopped” pill. | Ribbon and filter chips are PROPOSED. Quiet Ground is closer to the brief. |
| Dock | Events, Settings, Manage, Marketplace, Keycloak. | Search, home, pulse, terminal, toolbox, bell, sun. | Brief. |
| Environment chip | Console only, and only on the collapsed postgres tile today. | Not drawn on that tile. Mock postgres is a monogram hostless stand-in. | Brief. Draw the chip on the collision tile and flag the bug. |
| Type + accent | Not specified beyond geometry tokens. | Two poles (Plex/violet vs Inter/blue). | Unresolved. See §2. Do not mix. |
| Down state | Not in the brief’s tile-state table. Unreachable uses 0.45 + (banned) grayscale on the glyph. | Stopped = 0.38 mark + red wash + muted label. | Down as drawn is PROPOSED. New work must not add filter: grayscale. |
| Overlay “Integrations” / “Edit springboard” / “Redeploy” | Not in the tab register. Redeploy is not a shipped header verb. | Present in v3 frames C–G. | PROPOSED or drop. Do not ship as tabs. |
| 14 Aug “console is not a homescreen” | Superseded by the shipped springboard and 3a0b70ebb. | Mockups are a homescreen. | Springboard stays. |
Quiet Ground’s own rationale already says v2’s taxonomy, tray, pip, and selection fill were a dashboard pretending to be a home screen. The PNGs are that v2. If a review still has _fA–_full1 pinned, they are not the spec.
15. Build notes that are load-bearing
Section titled “15. Build notes that are load-bearing”- Per MPO LC-212.
- Per MPO LC-212.
- Per MPO LC-209.
menuEmbedstays off.- Per MPO LC-160. )