)
to each become a separate flex item, which the browser then laid
out as columns when the content was rich — see the
"From address has to match the SMTP user" callout in the
whitelabel-email doc, which rendered as 5+ vertical columns
before this fix. Block layout lets the content flow as normal
prose; the icon sits at the top in its own row. */
.doc-callout {
display: block;
margin: 22px 0;
padding: 14px 18px 16px;
border-radius: 12px;
border: 1px solid var(--line);
background: var(--surface);
font-size: 14.5px;
line-height: 1.6;
color: var(--ink);
position: relative;
border-left: 4px solid var(--mute);
}
.doc-callout::before {
content: "i";
display: inline-flex;
width: 22px; height: 22px;
border-radius: 50%;
background: rgba(10,10,11,0.08);
color: var(--ink);
align-items: center; justify-content: center;
font-style: italic;
font-weight: 700;
font-size: 13px;
font-family: serif;
margin-bottom: 10px;
}
.doc-callout p { margin: 0; }
.doc-callout p + p { margin-top: 8px; }
.doc-callout a { color: var(--ink); border-bottom: 1px solid var(--ink); text-decoration: none; }
.doc-callout-tip {
border-left-color: var(--mint, #75FB90);
background: linear-gradient(to right, rgba(117,251,144,0.08), var(--surface) 60%);
}
.doc-callout-tip::before {
content: "✓";
background: var(--mint, #75FB90);
color: var(--ink);
font-family: inherit;
font-style: normal;
}
.doc-callout-warn {
border-left-color: #FFC400;
background: linear-gradient(to right, rgba(255,196,0,0.08), var(--surface) 60%);
}
.doc-callout-warn::before {
content: "!";
background: #FFC400;
color: #1a1300;
font-family: inherit;
font-style: normal;
}
.doc-callout-success {
border-left-color: #1ABC4E;
background: linear-gradient(to right, rgba(26,188,78,0.08), var(--surface) 60%);
}
.doc-callout-success::before {
content: "✓";
background: #1ABC4E;
color: #fff;
font-family: inherit;
font-style: normal;
}
/* Feature card grid — used in "What you can do" sections.
Authors write:
*/
.doc-cards {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
gap: 12px;
margin: 24px 0;
}
.doc-cards-card {
position: relative;
display: block;
padding: 20px 22px;
background: var(--surface);
border: 1px solid var(--line);
border-radius: 12px;
text-decoration: none;
color: var(--ink);
transition: border-color 0.12s, transform 0.12s, box-shadow 0.12s;
}
.doc-cards-card::after {
content: "→";
position: absolute;
top: 18px; right: 22px;
color: var(--slate);
font-size: 16px;
transition: transform 0.12s, color 0.12s;
}
.doc-cards-card:hover {
border-color: var(--ink);
transform: translateY(-1px);
}
.doc-cards-card:hover::after { color: var(--ink); transform: translateX(2px); }
.doc-cards-icon {
display: inline-flex;
align-items: center; justify-content: center;
width: 32px; height: 32px;
border-radius: 8px;
background: var(--bg);
color: var(--ink);
margin-bottom: 14px;
}
.doc-cards-icon svg { width: 16px; height: 16px; stroke: currentColor; fill: none; stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; }
/* Use spans (not h3/p) inside the anchor — marked v14 splits an
when it sees a block-level child like or
. The card
structure becomes title + desc spans, displayed as blocks. */
.doc-cards-card .doc-cards-title {
display: block;
font-size: 16px;
font-weight: 700;
letter-spacing: -0.015em;
margin: 0 0 4px;
color: var(--ink);
}
.doc-cards-card .doc-cards-desc {
display: block;
font-size: 13.5px;
color: var(--slate);
line-height: 1.5;
}
/* Step list — numbered explanations with a connecting rail.
Authors write:
-
Claim a subdomain.
Pick a handle. We check it's free.
…
*/
.doc-steps {
list-style: none;
counter-reset: docstep;
padding: 0;
margin: 24px 0;
display: flex;
flex-direction: column;
gap: 14px;
}
.doc-steps > li {
counter-increment: docstep;
position: relative;
padding: 18px 18px 18px 64px;
background: var(--surface);
border: 1px solid var(--line);
border-radius: 12px;
}
.doc-steps > li::before {
content: counter(docstep);
position: absolute;
left: 18px;
top: 18px;
width: 32px; height: 32px;
border-radius: 8px;
background: var(--ink);
color: var(--mint, #75FB90);
display: inline-flex;
align-items: center; justify-content: center;
font-family: var(--font-mono);
font-size: 13px;
font-weight: 600;
}
.doc-steps > li h3 {
font-size: 16px;
font-weight: 700;
letter-spacing: -0.015em;
margin: 0 0 4px;
color: var(--ink);
}
.doc-steps > li p {
font-size: 14px;
color: var(--slate);
margin: 0;
line-height: 1.55;
}
.doc-steps > li p + p { margin-top: 6px; }
/* Code block headers — when paired with , gives a "SHELL" /
"JAVASCRIPT" label + Copy button. Authors write:
Shell
…
*/
.doc-code {
background: #0a0a0b;
color: #e9e9ea;
border-radius: 12px;
overflow: hidden;
margin: 22px 0;
border-left: 4px solid var(--mint, #75FB90);
}
.doc-code header {
display: flex; justify-content: space-between; align-items: center;
padding: 10px 16px;
font-family: var(--font-mono);
font-size: 11px;
letter-spacing: 0.16em;
text-transform: uppercase;
color: rgba(255,255,255,0.6);
border-bottom: 1px solid rgba(255,255,255,0.08);
}
.doc-code-copy {
background: transparent;
border: 0;
color: rgba(255,255,255,0.7);
font-family: var(--font-mono);
font-size: 11px;
letter-spacing: 0.04em;
cursor: pointer;
padding: 4px 8px;
border-radius: 4px;
}
.doc-code-copy:hover { color: #fff; background: rgba(255,255,255,0.06); }
.doc-code pre {
margin: 0;
padding: 16px;
background: transparent;
border: 0;
border-radius: 0;
color: #e9e9ea;
font-size: 13px;
line-height: 1.55;
overflow-x: auto;
}
/* ──────────────────────────────────────────────────────────────────
Doc visual library — components for showing how things work, not
just describing them. Each component is purely decorative; clicks /
inputs do nothing. The point is the reader sees what they'll see
in-app, rendered inline at brand-consistent fidelity.
────────────────────────────────────────────────────────────────── */
/* Faux UI block — drop a snapshot of an app surface inline. The "PREVIEW"
ribbon top-right makes clear this is illustrative; the click cursor
stays default so nothing reads as interactive. */
.doc-preview {
position: relative;
margin: 22px 0;
padding: 0;
border: 1px solid var(--line);
border-radius: 14px;
background: var(--bg, #f6f6f7);
overflow: hidden;
cursor: default;
}
.doc-preview * { cursor: default !important; }
.doc-preview::after {
content: "PREVIEW";
position: absolute;
top: 10px; right: 12px;
font-family: var(--font-mono, ui-monospace, SFMono-Regular, monospace);
font-size: 10px;
font-weight: 700;
letter-spacing: 0.12em;
color: var(--slate);
background: rgba(255,255,255,0.85);
padding: 4px 8px;
border-radius: 4px;
border: 1px solid var(--line);
z-index: 2;
}
.doc-preview-frame {
background: #fff;
margin: 28px 18px 18px;
border-radius: 10px;
border: 1px solid var(--line);
padding: 18px;
}
.doc-preview-caption {
display: block;
padding: 0 18px 14px;
font-size: 12.5px;
color: var(--slate);
font-style: italic;
}
/* Faux form fields — render at the same scale as the real /app forms.
Inputs are non-functional (readonly + tabindex=-1 in markup). */
.doc-mock-row { display: flex; gap: 12px; flex-wrap: wrap; margin-bottom: 12px; }
.doc-mock-field { flex: 1 1 200px; min-width: 0; }
.doc-mock-label {
font-size: 11px;
font-weight: 700;
text-transform: uppercase;
letter-spacing: 0.08em;
color: var(--slate);
margin-bottom: 6px;
display: block;
}
.doc-mock-input,
.doc-mock-select {
width: 100%;
padding: 9px 12px;
border: 1px solid var(--line);
border-radius: 8px;
font-family: var(--font-mono, ui-monospace, SFMono-Regular, monospace);
font-size: 13px;
color: var(--ink);
background: #fff;
pointer-events: none;
}
.doc-mock-input.is-empty { color: var(--slate); }
.doc-mock-hint {
font-size: 11.5px;
color: var(--slate);
margin-top: 6px;
}
.doc-mock-btn {
display: inline-flex;
align-items: center;
gap: 8px;
padding: 9px 16px;
border-radius: 8px;
border: 1px solid var(--ink);
background: var(--ink);
color: #fff;
font-size: 13px;
font-weight: 600;
pointer-events: none;
}
.doc-mock-btn.is-secondary { background: #fff; color: var(--ink); }
.doc-mock-btn.is-ghost { background: transparent; border-color: var(--line); color: var(--slate); }
/* Toggle widget mock — visualises an on/off control. */
.doc-mock-toggle {
display: inline-flex; align-items: center; gap: 10px;
pointer-events: none;
}
.doc-mock-toggle .t {
display: inline-block;
width: 44px; height: 24px;
border-radius: 999px;
background: rgba(10,10,11,0.18);
position: relative;
}
.doc-mock-toggle .t::after {
content: "";
position: absolute;
top: 2px; left: 2px;
width: 20px; height: 20px;
background: #fff;
border-radius: 50%;
}
.doc-mock-toggle.is-on .t { background: var(--mint, #75FB90); }
.doc-mock-toggle.is-on .t::after { left: 22px; }
.doc-mock-toggle .l {
font-size: 13px;
font-weight: 600;
color: var(--ink);
}
/* "What's next" footer — three concrete next moves at the bottom of
every doc. Replaces vague "see also" lists. Renders as 3 cards. */
.doc-next {
margin-top: 36px;
padding-top: 24px;
border-top: 1px solid var(--line);
}
.doc-next-eyebrow {
font-family: var(--font-mono, ui-monospace, SFMono-Regular, monospace);
font-size: 11px;
font-weight: 700;
letter-spacing: 0.1em;
text-transform: uppercase;
color: var(--slate);
margin-bottom: 14px;
}
.doc-next-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
gap: 12px;
}
.doc-next-card {
display: block;
padding: 16px 18px;
border: 1px solid var(--line);
border-radius: 12px;
background: var(--surface, #fff);
text-decoration: none;
color: var(--ink);
transition: border-color 0.15s ease, transform 0.15s ease, box-shadow 0.15s ease;
}
.doc-next-card:hover {
border-color: var(--ink);
transform: translateY(-2px);
box-shadow: 0 4px 12px rgba(10,10,11,0.06);
}
.doc-next-card .label {
font-size: 11px;
font-weight: 700;
letter-spacing: 0.08em;
text-transform: uppercase;
color: var(--mint-deep, #1ABC4E);
margin-bottom: 6px;
}
.doc-next-card .title {
font-size: 15px;
font-weight: 700;
color: var(--ink);
margin-bottom: 4px;
letter-spacing: -0.01em;
}
.doc-next-card .desc {
font-size: 12.5px;
color: var(--slate);
line-height: 1.5;
}
/* Inline metadata strip at the top of a doc — audience pill + read
time + prerequisites. Sits between the H1 description and the body. */
.doc-meta-strip {
display: flex; flex-wrap: wrap;
gap: 8px;
margin: 4px 0 22px;
padding: 8px 0 18px;
border-bottom: 1px solid var(--line);
}
.doc-meta-pill {
display: inline-flex; align-items: center; gap: 6px;
padding: 4px 10px;
border-radius: 999px;
border: 1px solid var(--line);
background: var(--surface, #fff);
font-family: var(--font-mono, ui-monospace, SFMono-Regular, monospace);
font-size: 11px;
color: var(--slate);
}
.doc-meta-pill strong { color: var(--ink); font-weight: 600; }
.doc-meta-pill svg { width: 12px; height: 12px; stroke: currentColor; fill: none; stroke-width: 1.6; }
/* "Open in app" inline-link badge — always points at a /app/* path so
the reader can jump directly to the surface a doc is describing. */
.doc-open {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 3px 9px 3px 11px;
margin: 0 2px;
border-radius: 999px;
background: var(--ink);
color: #fff !important;
border-bottom: 0 !important;
font-size: 12.5px;
font-weight: 600;
text-decoration: none !important;
letter-spacing: -0.005em;
transition: background 0.15s ease, transform 0.15s ease;
}
.doc-open:hover { background: var(--black, #0A0A0B); transform: translateY(-1px); }
.doc-open::after { content: "↗"; font-weight: 400; opacity: 0.7; }
/* Key/value spec table — for showing config keys, env vars, or any
"name → value" pair list. Cleaner than a markdown table. */
.doc-kv {
margin: 18px 0;
border: 1px solid var(--line);
border-radius: 10px;
overflow: hidden;
}
.doc-kv-row {
display: grid;
grid-template-columns: minmax(140px, 220px) 1fr;
gap: 18px;
padding: 12px 16px;
border-top: 1px solid var(--line);
font-size: 14px;
}
.doc-kv-row:first-child { border-top: 0; }
.doc-kv-row dt {
font-family: var(--font-mono, ui-monospace, SFMono-Regular, monospace);
font-size: 12.5px;
color: var(--ink);
font-weight: 600;
}
.doc-kv-row dd {
margin: 0;
color: var(--slate);
line-height: 1.55;
}
/* Inline "TRY IT" CTA — landed at the end of major how-to sections so
the reader can leave the doc and go do the thing. */
.doc-try {
display: flex;
align-items: center;
justify-content: space-between;
gap: 16px;
margin: 22px 0;
padding: 16px 20px;
background: var(--ink);
color: #fff;
border-radius: 12px;
flex-wrap: wrap;
}
.doc-try .doc-try-text {
flex: 1; min-width: 200px;
}
.doc-try .doc-try-title {
font-weight: 700;
font-size: 15px;
margin-bottom: 2px;
}
.doc-try .doc-try-sub {
font-size: 12.5px;
color: rgba(255,255,255,0.7);
}
.doc-try-btn {
display: inline-flex;
align-items: center;
gap: 8px;
padding: 10px 18px;
background: var(--mint, #75FB90);
color: var(--ink) !important;
border-radius: 8px;
border-bottom: 0 !important;
font-weight: 700;
font-size: 13.5px;
text-decoration: none !important;
transition: filter 0.15s ease;
}
.doc-try-btn:hover { filter: brightness(0.95); }
.doc-try-btn::after { content: "→"; }
/* Visual diagram cell — for inline SVG diagrams (light wrapper). */
.doc-diagram {
margin: 22px 0;
padding: 18px;
background: var(--surface, #fff);
border: 1px solid var(--line);
border-radius: 12px;
overflow: hidden;
}
.doc-diagram svg { width: 100%; height: auto; max-width: 720px; display: block; margin: 0 auto; }
.doc-diagram-caption {
margin-top: 10px;
font-size: 12.5px;
color: var(--slate);
text-align: center;
font-style: italic;
}
.doc-code pre code { background: transparent; padding: 0; color: inherit; border: 0; }