Skip to content
SHC Docs

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 on origin/main at 3a0b70ebb. 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):

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.


Per MPO LC-160, LC-110, LC-175.

SurfaceHostJobRenderer
LauncherTraefik plugin, 52px floating trigger, injected into launcher-carrying pagesDestinations. A list of places you can go.Hand-drawn ES5 in a shadow root. shc/traefik/plugin/menu*.go
ConsoleEstate public URL, /, served by shcdManagement. The grid of things you can operate, plus the only mutation rows in the product.React + Tamagui. packages/springboard-ui/, features/console/
Portalmy.selfhostedcloud.org (central, never self-hosted)Register clusters, fleet, billing, install dispatch, support bundles, BYO-credential provisionFrappe bench. Ruled 2026-08-14.
Marketplacemarketplace.selfhostedcloud.org (central)Browse the catalogue; dispatch installs onto a registered clusterFrappe + 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.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.

Per MPO LC-163, Axiom 4.

Per MPO LC-163, LC-24.

Per MPO LC-163, LC-43.

Per MPO LC-43.

Per MPO LC-85, Axiom 14, LC-151.

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.

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.


Shipped, identical on launcher and console, guarded by launcherGeometry.ts + launcherGeometry.spec.ts. Owner ruling 2026-08-19.

value
icon60 px, radius 14
caption11 px in a 15 px line box, marginTop 6
row height95
gaps18 / 8
padding6 / 16
columns4 below 700 px, 6 above
dockgap 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.


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.

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).

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.

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.

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.


statelauncherconsole
normalrgba(148,163,184,.10) fill, #F8FAFC captionsame 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-labelidentical 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 namedoes 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-onlycannot happen; the tile is absentfull colour, cursor: context-menu, "no address, manage only" in the accessible name
status dotnoneexists but off (affordances.ts statusDot: false). With the dot off, status text joins the accessible name.
down / stoppednot a launcher conceptPROPOSED (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.


Left: launcher (menu_stack.go:552). Right: console (StackMenu.tsx:355-447, fed by StackTileContainer.tsx).

rowLauncherConsolewhy
structureone flat list, no sections, no separators, no labelssix sections with separators and labelsdestinations vs control surface
Openpresent only when the tile has an hrefpresent, omitted (not disabled) when hasRoutedHost is falsehostless tiles cannot exist in the launcher
Renamefolder tiles onlyfolder tiles onlyparity, intended
Copy link addressabsentpresent, omitted without a URL or navigator.clipboardhole; see §6.4
Part of this app (sidecars)flat rows, child stack name, plus " (env)" when the child’s env differs and is not defaultlabelled section; each row goes to /stacks/<child>designed
Add-ons (vapps)flat rows; attachConsoleKids repairs them into console deep linkslabelled section; /stacks/<parent>?vapp=<name> with a detail second linedesigned
Management tabsabsent7 rows, canonical order: Logs, Telemetry, Events & jobs, Volumes, Backups, Update, Shellowner 2026-08-18
Manage in Consoleevery non-console tile; the launcher’s only management rown/athe pointer from one surface to the other
LifecyclePer MPO LC-208.
error slotPer MPO LC-208.
Environment rowswithdrawn 2026-08-17withdrawn the same dayparity
empty menuPer 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 wireTamagui DropdownMenu.Item / SheetRow. Every row is an in-app intentlauncher must leave the host page; console must not
popupPer 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)

Open
mail
Manage in Console

nc-db is hostless, so renderMenuKids drops it. mail survives because attachConsoleKids repairs vapp rows. Three anchors, all target="_blank".

Console (shipped)

Open
Copy link address
──────────────────────
PART OF THIS APP
nc-db
──────────────────────
ADD-ONS
mail
…second line: detail
──────────────────────
Logs
Telemetry
Events & jobs
Volumes
Backups
Update
Shell
──────────────────────
LIFECYCLE
Start
Stop ← destructive, confirm
Restart
──────────────────────
[ actionError, only after a failed verb ]

Fifteen rows against three. Most of that gap is designed.

Launcher: the tile does not exist.

Console (shipped): manage-only, full colour, cursor: context-menu.

──────────────────────
Logs
Telemetry
Events & jobs
Volumes
Backups
Update
Shell
──────────────────────
LIFECYCLE
Start
Stop
Restart

No 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)”
  1. Copy link address missing from the launcher. The plugin steals oncontextmenu and gives nothing back. PROPOSED launcher row.
  2. Folder menu is asymmetric. Console folder menu has Open; launcher folder menu does not. Pick one.
  3. Per MPO Axiom 6 (DG-ST-03).
  4. Sidecar labels spelled differently. Launcher appends " (env)". Console uses a labelled section and plain names.
  5. Environment chip is console-only. Drawn when a stack spans more than one environment. Launcher appends nothing (menu.go:2755-2785). Same postgres is labelled two ways. Owner call, not a designer guess.
  6. menuEmbed: true. Floating menu is the console springboard in an iframe, fed by EntitledSource. No has_host, no vapps, no parent_stack, no status. Add-ons and Part-of-this-app always empty; every tile looks openable. Defaults off. Do not mock as shipped.
  7. Hidden console affordances. See §5.

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):

screengated on
Overviewoperate
Containersmanage and operate
Jobsoperate
Backupsmanage
Describemanage
Updatemanage
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.


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"] via useSyncExternalStore; 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_precedence is unset on this estate, so prod = 0, default = 5.

Environment is a filter, not a boundary. Nothing checks whether you may see an environment.

  • No tenant switcher. CanAccessTenant is tenantName == "" || IsPlatformAdmin() || tenantName == u.TenantName. u.TenantName is 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 and StackFilter.Environment is wired and unused.
  • No X-SHC-Environment header from any frontend. ce reads it. Nothing in shc writes it.
  • Not persisted server-side. localStorage, per-browser. SSR snapshot is undefined, so the first paint is always unfiltered and the client corrects on hydrate. Design for that flash.
  • AccountButton.tsx:137 fires a second useDocList("Stack") just to populate options. Known. Fix is a shared query cache, not built.

Per MPO Axiom 9 (DG-CTRL-01).

Superseded by MPO LC-162.

PROPOSED, needs engineering:

  • Per MPO LC-112, LC-161, LC-104.
  • ?scope_env=prod in 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=prod on the Stack list read. StackFilter already accepts it.
  • Server-persisted preference so the scope follows the user across devices.

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):

bandrequirement
Console (Ops)estate verb ≥ read
Settingsestate verb ≥ manage
Platform tier inside Settingsplatform_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 below manage

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.

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.

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).

Holder of one or more stack:<name>[:verb] grants and nothing at tenant tier. 4 in corp. Real grants:

roleholders
stack:midpoint:use3
stack:openreplay:use2
stack:gitlab-huly:use1
stack:glitchtip:use1
stack:mautic:use1
stack:nc:use1
stack:nc:read1

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.

V1 platform adminV2 tenant managerV3 read-onlyV4 operatorV5 app-entitledV6 nothingV7 denied
holders on estate13104430
GET /api/resource/Stack200, all tenants200, own realm200, own realm200, own realm403403403
effective-apps200 + platform_admin200200200200, their apps200, empty200, empty
console springboardfull gridfull gridfull gridfull gridnoneerror carderror card
Settings tileyesyesremovedremovedremovedremovedremoved
Keycloak tileyesyesremovedremovedremovedremovedremoved
lifecycle rowslivelivedisabled + reasonliven/an/an/a
Update / Shell / Backupslivelivedisableddisabledn/an/an/a
licence + tenant mutationsliveread-onlyn/an/an/an/an/a
launcher tilesall, entitledtenant, entitledtenant, entitledtenant, entitledmixed, 50% on unentitledall at 50%all at 50%

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.

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.

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.


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.

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.

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)”

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.md EMP-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: false for affine. promanager deployfile work omits gated:. 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 Keycloak client_id=affine-rs.
  • bitspur corp/prod runs affine (views brief name list), not the affine-rs package 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.


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

  1. Per-deployment management from the console. Needs a writer for reqctx.Stack or handler-level narrowing, plus reopening the console’s estate floor. Ruled out by design. auth.RequireStack exists with zero production callers.
  2. Per-tile permission states driven by a per-app verb. Every canManage / verbAtLeast reads the estate tier.
  3. 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.
  4. Named personas. A persona label is a UI synonym for a verb tier and should say so.
  5. Group-driven access. The daemon parses no groups claim. shc-app-access is an empty socket on purpose.
  6. A distinguishable “denied” state. See V7.
  7. A designed no-access landing. Today’s card is a generic 403. Designing one is welcome; mark it new.

Environment and tenant scope

  1. Environment in the URL. ?scope_env= does not exist and must not collide with ?env=.
  2. Server-side environment narrowing. The console never sends ?environment= or X-SHC-Environment.
  3. A scope that survives a shared link or another device. localStorage only.
  4. EnvironmentSwitcher.tsx as a component. Orphaned. Live control is inlined in AccountButton.

Menus and tiles

  1. Lifecycle verbs in the launcher menu. Never existed, audited.
  2. Copy link address in the launcher. Missing. Worth proposing; do not draw as shipped.
  3. An environment badge on launcher tiles. Ruled out on that surface.
  4. Console status dot, visible ⋯ button, status-bar magnifier. Knobs default false. If you draw one, name the knob.
  5. A current-page highlight on console tiles. Launcher-only, meaningless on the console.
  6. An unentitled (50% opacity) console tile. Structurally unreachable.
  7. The launcher rendered as a framed console. menuEmbed defaults off. In that mode Add-ons and Part-of-this-app are always empty.
  8. 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.

TopicViews brief / shipped codeMockupsWhat wins for implementation
App namesEstate 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 setSeven: 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.
Columns4 < 700 px, 6 ≥ 700 px.Operator HTML: repeat(8, 1fr). Quiet Ground: 6 columns, 24 slots.Brief / launcherGeometry.ts.
TaxonomyOne 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 pipOff. Knob statusDot: false.PNGs pin a green/amber/red pip to the icon corner. v3 HTML removes it.Brief + v3 HTML.
Selection / press ringForbidden._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 stripOverview + 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 hostlessOmitted on the console.Present, disabled, reason on the row.Shipped = omit. Present+disabled is PROPOSED (§6.3).
SearchSpotlight via ⌘K. Magnifier knob false.Persistent search field (/ or ⌘K) on the board.Field is PROPOSED; name the knob.
Estate ribbon / All–Running–AttentionNot 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.
DockEvents, Settings, Manage, Marketplace, Keycloak.Search, home, pulse, terminal, toolbox, bell, sun.Brief.
Environment chipConsole 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 + accentNot specified beyond geometry tokens.Two poles (Plex/violet vs Inter/blue).Unresolved. See §2. Do not mix.
Down stateNot 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.


  • Per MPO LC-212.
  • Per MPO LC-212.
  • Per MPO LC-209.
  • menuEmbed stays off.
  • Per MPO LC-160. )