Repository navigation
Airframe theme-v8
The docs look, shared: every product's docs site reads as one family and links to the others. No token values
change; no af- component class changes.
- New published file
airframe-suite.html: the suite strip, one quiet row above the docs header that names the
suite and links each product's public docs site (agent factory, hangar, flightdeck, Tower once public, ai-dlc,
Airframe), with the 2px product marker under the current one. It is a Material / Zensical partial, rendered
server side, so it works without JavaScript on Material for MkDocs and on Zensical. A site adds it with config
only:theme.custom_dir: overrides, a two-lineoverrides/main.htmlthat extendsbase.htmland includes
partials/airframe-suite.htmlin theannounceblock, andextra.airframe.product: <name>for the current
item. Tool repos vendor it withsync-airframe.sh(airframe-suite.html overrides/partials/airframe-suite.html).
The list lives in the partial, not in each site's config, so the family stays identical everywhere. airframe-docs.css:.md-bannerand.af-suite*: the strip's layout and type (mono capital plane, product name in the display
face,fg-mutedat rest,fgand the--af-productmarker when current,fg-subtlefor an unlinked item).
Below 600px the plane words drop and the row scrolls sideways.- Page anatomy: the first paragraph after the page title is the lede on every page (
h1 + p,fg-muted,.9rem,
62ch), so a page written as "title, one sentence, sections" reads the same on every site without markup. af-hero--visual: a variant of the home hero with a slot for a real product capture,figure.af-hero__visual
(image or video,radius-card, a 1pxlineedge, a mono caption). Words left, the product on the right from
960px; the visual follows the actions below that.- The hero's dot field no longer sits behind the words on phones: below 960px it is a small field at the top
right, as on the README banners; the headline drops to 2em. On wide screens it starts at 64% so it stays off
the lede. - Tables take the full column width (
display: table; width: 100%) instead of shrinking to their content and
wrapping every cell; wide tables still scroll inside.md-typeset__scrollwrap. - Code blocks scroll sideways (long commands are not wrapped):
pre > codegetspadding-right: 3emso the end
of the longest line clears the copy button, and.md-clipboardsits on the terminal ground (terminal-bg,
terminal-dim,terminal-fgon hover) instead of over the glyphs. - The plain
af-herono longer draws an empty dot-field stage; the field appears only behind a visual
(af-hero--visual), as the brand book places it behind hero data. - A
@media (forced-colors: active)block, the first in the docs mapping: the tab, nav, strip and admonition
markers become borders in system colors, the dot field and header marker go, swatches and hero visuals keep an
outline.
airframe-docs.cssandairframe-suite.htmlare now built fromairframe/docs-site/byscripts/airframe.py build(the CSS gets the release stamp), socheckcatches drift and the forced-colors test covers them like
the other stylesheets.