Skip to content

Describe the console as one surface at app.retina.fm in the brand guide - #31

Merged
Babissimo merged 1 commit into
mainfrom
docs/brand-one-console
Sep 24, 2026
Merged

Babissimo merged 1 commit into
mainfrom
docs/brand-one-console

Conversation

@Babissimo

Copy link
Copy Markdown
Contributor

The brand guide still described six surfaces, with dash.retina.fm, data.retina.fm and map.retina.fm as three separate console-family columns. retina-server retired those hostnames (#426, #433) and has since made the map and the data explorer pages of one console bundle, served from the root of app.retina.fm and reading one palette and component file (packages/shared/css/tokens.css and ui.css). Most of what the guide said about the console had stopped being true.

What changes in the guide:

  • Four surfaces. owl, retina, the console (app.retina.fm, with admin.retina.fm as the same bundle) and owl-os. The retired names are noted once, as the Cloudflare redirects they now are.
  • The map keeps a column only where it still departs from the rest of the console: layout, toolbar, toasts, focus ring, floating controls with a shadow, and the measured data palette. It no longer has a theme, font or header of its own: it follows the console's three-state switch and system font, inside the console's sidebar and header.
  • Colour tables give the console two columns, its light and dark halves.
  • §6 and §10 re-checked against the shared ui.css. Entries it has resolved are removed: one disabled rule for every .btn, a shared .input, six badge variants, .notice in place of alert(), <Pager>, <DataTable> and the chart theme. Entries that still hold are restated against current code: the sidebar vanishing under 768px, one remaining confirm(), and the map's lighter sunk tier, now with its stated reason.
  • Truth on the map. The map draws truth only on a synthetic fleet's view, so the public map carries none. The guide now says so in §3, §8 and §10.

tokens.css replaces .dash, .data and .map with a .console pair (data-theme="dark" for the dark half) and a .console.map modifier. preview.html renders the pair from those classes, and its accent text now reads --accent-ink. No repository consumes these classes; tower-finder-service's README only links to the guide.

Every console claim was checked against retina-server main (cc43be9d) and tower-finder-service main (28ed7e1). Three review passes ran, one of them independent. The preview was rendered and its computed values were checked for both halves and the map modifier.

The same staleness in architecture.md and the uptime runbook is fixed in a separate PR.

🤖 Generated with Claude Code

retina-server retired dash., map. and data.retina.fm in mid-September
(#426, #433) and has since folded the map and the data explorer into the
dashboard bundle as pages, served from the app host's root with one
shared palette and component file (packages/shared/css). The guide still
described six surfaces with three separate console-family columns, so
most of what it said about the console had stopped being true: the map
is no longer dark by default or Inter-only, it follows the console's
three-state theme, its app-shell header is gone, and the data explorer
sits in the console's sidebar layout rather than under its own top bar.

The guide now has four surfaces. The console's palette columns are its
light and dark halves, and the map keeps a column of its own only where
it still departs from the rest of the console (layout, toolbar, toasts,
focus ring, data palette). The shared ui.css also closed several §10
gaps (a shared input rule, one disabled rule for every button, six badge
variants, notice banners in place of alert(), a shared Pager and chart
theme), so those entries are gone; the ones that still hold (the phone
layout, the one remaining confirm(), the map's lighter sunk tier) are
restated against the current code.

tokens.css follows: .dash, .data and .map become a .console pair plus a
.console.map modifier, and preview.html renders the pair from them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Babissimo
Babissimo merged commit be5c245 into main Sep 24, 2026
2 checks passed
@Babissimo
Babissimo deleted the docs/brand-one-console branch September 24, 2026 16:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant