/* --------------------------------------------------------------------------- AppSignal docs (Mintlify, Luma theme) — header tweaks. Three things live here: 1. Visually hide the "AppSignal Documentation" wrapper tab in the top nav. 2. Style the section separators injected into nav dropdowns by header-separators.js. 3. Brand the header (bar, nav items, buttons, dropdown panels) to match the appsignal.com / old docs.appsignal.com header. --------------------------------------------------------------------------- */ /* =========================================================================== Design tokens — theme-aware color variables. Every branded color below is a token. Structure/typography rules in this file are theme-agnostic (they apply in both light and dark); only these token VALUES differ per theme, so one set of rules serves both modes. Light values are the exact AppSignal light palette this file already used. Dark values are the WCAG-AA "dark v2" set from the AppSignal color-tokens tool (neutral near-black surfaces, brightened text/links/semantics). --------------------------------------------------------------------------- */ :root { --text-heading: #111827; /* page headings */ --text-default: #203053; /* gray-800 — strong body text, links on surfaces */ --text-secondary: #415377; /* gray-700 — body copy, nav, TOC */ --text-muted: #67789d; /* gray-600 — eyebrows, sub-items */ --text-subtle: #8896b3; /* gray-500 — labels, captions */ --text-strong: #0a1530; /* gray-900 — active sidebar item */ --link: #336abc; /* inline links, hover/active accents */ --link-hover: #1d3b69; --edge-default: #d9dde7; /* gray-200 — table/TOC/pager/sidebar borders */ --page-bg: #ffffff; --surface-subtle: #f5f7f9; /* gray-100 — sidebar column, code/table fills */ --surface-hover: #edf0f5; /* sidebar row hover */ --surface-active: #e8ecf3; /* sidebar active pill */ --panel-bg: #ffffff; /* nav dropdown panel */ --iconbox-bg: #ffffff; /* dropdown icon box */ /* The navy bar (navbar + footer) and the elements painted on it. */ --bar-bg: #0a1530; /* gray-900 navy band */ --bar-border: #203053; /* gray-800 dividers on the band */ --bar-text: #d9dde7; /* nav links on the band */ --bar-icon: #a2adc4; /* carets, social/footer icons on the band */ /* The bar is dark in both themes, so the white Support button keeps one fixed color across themes. The CTA is azure-500 in light and gets the recommended azure-400 in .dark (see below). */ --bar-btn-bg: #ffffff; /* the white Support button */ --bar-btn-text: #203053; /* gray-800 — Support button label */ --bar-btn-hover: #f4f6fa; /* Support button hover wash */ --cta-bg: #1b44da; /* azure-500 — the "Get started" CTA */ /* Elevation shadows. Light uses AppSignal's soft navy tint; .dark swaps to a deeper black since the navy tint is invisible on dark surfaces. */ --shadow-iconbox: 0 1px 2px rgb(0 0 0 / 0.05); --shadow-iconbox-hover: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1); --shadow-panel: 0 1px 3px 0 rgba(10, 21, 48, 0.1), 0 1px 2px -1px rgba(10, 21, 48, 0.1); } .dark { --text-heading: #f5f5f5; --text-default: #e5e5e5; /* neutral-200 */ --text-secondary: #a3a3a3; /* neutral-400 */ --text-muted: #8b8b8b; /* neutral-500 */ --text-subtle: #787878; --text-strong: #f5f5f5; --link: #60a5fa; /* azure-350D */ --link-hover: #4a6ae8; /* azure-400 */ --edge-default: #383838; /* neutral-750 */ --page-bg: #141414; /* neutral-950 canvas */ --surface-subtle: #1c1c1c; --surface-hover: #242424; --surface-active: #2e2e2e; --panel-bg: #1e1e1e; /* neutral-850 */ --iconbox-bg: #2a2a2a; /* neutral-800 */ /* In dark the bar follows the token surfaces (neutral), not navy. The white Support button (--bar-btn-*) stays fixed across themes; the CTA brightens to the recommended dark azure (azure-400). */ --bar-bg: #1a1a1a; --bar-border: #2e2e2e; --bar-text: #c8c8c8; --bar-icon: #8b8b8b; --cta-bg: #4a6ae8; /* azure-400 — recommended dark-mode azure */ /* Deeper black elevation for dark surfaces. */ --shadow-iconbox: 0 1px 2px rgb(0 0 0 / 0.4); --shadow-iconbox-hover: 0 2px 6px -1px rgb(0 0 0 / 0.55), 0 1px 3px -1px rgb(0 0 0 / 0.45); --shadow-panel: 0 4px 12px -2px rgb(0 0 0 / 0.6), 0 2px 6px -2px rgb(0 0 0 / 0.5); } /* 1. Wrapper tab ---------------------------------------------------------- The docs sections render in the left sidebar as `anchors`, which Mintlify only allows nested inside a tab. That wrapper tab ("AppSignal Documentation", linking to /getting-started) is structurally required but visually redundant — the sidebar already lists every section — so we take it out of view. We use a visually-hidden (sr-only) pattern rather than `display: none` on purpose: it keeps the descriptive link in the rendered DOM and the accessibility tree, so its anchor text stays meaningful to crawlers/screen readers instead of being dropped (the SEO intent). /getting-started is also linked from in-content pages and the sidebar anchor, so nothing is orphaned. NOTE: this selector is coupled to Mintlify's navbar markup (a tab `

` inside #navbar whose link href starts with /getting-started). Re-check it on Mintlify version bumps. Scoped to #navbar so the sidebar anchor and other /getting-started links are untouched. */ #navbar li:has(> a[href^="/getting-started"]) { position: absolute !important; width: 1px !important; height: 1px !important; padding: 0 !important; margin: -1px !important; overflow: hidden !important; clip: rect(0 0 0 0) !important; clip-path: inset(50%) !important; white-space: nowrap !important; border: 0 !important; } /* 2. Dropdown section separators ----------------------------------------- header-separators.js inserts before the first item of each section in a nav dropdown (e.g. Platform's OVERVIEW / INTELLIGENCE / HOSTING). Match the marketing header's section h3 eyebrows: 14px/600, 0.7px tracking, gray-600. */ .docs-menu-separator { padding: 0 8px 12px; font-size: 14px; font-weight: 600; line-height: 1.25; letter-spacing: 0.7px; text-transform: uppercase; color: var(--text-muted); /* gray-600 — same eyebrow tone used elsewhere in the docs */ pointer-events: none; /* it's a label, not a menu item */ user-select: none; } /* Subsequent sections get a full-bleed divider above them, like the marketing header's `border-b border-gray-200 -mx-3` rules between menu groups. The negative margins bleed past the panel's 12px side padding; the left padding compensates (12px bleed + 8px label inset). */ [role="menu"] > .docs-menu-separator:not(:first-child) { margin: 8px -12px 0; padding: 20px 20px 12px; border-top: 1px solid var(--edge-default); } /* =========================================================================== AppSignal branding. Ported from PR #494 (https://github.com/appsignal/appsignal-web/pull/494), with every selector re-verified against the current Mintlify/Luma DOM (the nav was rebuilt since #494, so several selectors were updated). These rules apply in BOTH themes: the structure/typography is theme-agnostic and every color is a token (see "Design tokens" above) that resolves to the light value under `:root` and the dark value under `.dark`. Dark mode is enabled via docs.json `appearance.default: "system"`. The few selectors that target Mintlify's light utility classes (e.g. `bg-background-light`) still match in dark because Tailwind keeps both light and `dark:` class names in the attribute — only the token value swaps. Brand tokens (packages/ui/tailwind.preset.js): gray-900 #0A1530 · gray-800 #203053 · gray-700 #415377 · gray-600 #67789D gray-500 #8896B3 · gray-200 #D9DDE7 · azure-500 (primary) #1B44DA --------------------------------------------------------------------------- */ /* --- Navbar bar ---------------------------------------------------------- The navbar background is painted by an absolute layer (`

`); #494's old `#navbar-transition` / `[data-is-opaque]` layer no longer exists. Recolor that layer navy and the divider layer's bottom border to gray-800. The opened dropdown panels are Radix-portaled to (outside #navbar), so none of these `#navbar …` rules reach them — only the trigger tabs on the bar. Panels are styled in the "Nav dropdown panels" section below. */ html #navbar div[class*="bg-background-light"] { background-color: var(--bar-bg); backdrop-filter: none; -webkit-backdrop-filter: none; } html #navbar div.border-b { border-bottom-color: var(--bar-border); } /* Nav links, trigger tabs and buttons — light gray on navy, white on hover (matches the apps/com & blog header: text-gray-200 / hover:text-white). */ html #navbar a, html #navbar button { color: var(--bar-text); } html #navbar a:hover, html #navbar button:hover { color: #ffffff; } /* Search + Ask Assistant triggers — keep their icon / label / ⌘-kbd legible on navy (gray-500), overriding the navbar link color inherited above. Both get the identical treatment so the two pills read as a matched pair. */ html #navbar [class*="group/search"], html #navbar [class*="group/search"] *, html #navbar #assistant-entry, html #navbar #assistant-entry * { color: var(--text-subtle); } /* The assistant label ships font-medium (500) where "Search…" is 400 — flatten it to match. The ⌘I kbd span (text-xs font-semibold) keeps its 600, same as search's ⌘K. */ html #navbar #assistant-entry span:not([class*="text-xs"]) { font-weight: 400; } /* The ⌘K / ⌘I shortcut badges carry `bg-white` + a gray text tone in light, and `dark:bg-background-dark` + dimmer text in dark. Both pills sit on the dark bar in either theme, so the badge shouldn't change when the UI goes dark — pin both its background and text to the light values so ⌘K and ⌘I read identically across themes. */ html.dark #navbar [class*="group/search"] [class*="text-xs"][class*="rounded-full"], html.dark #navbar #assistant-entry [class*="text-xs"][class*="rounded-full"] { background-color: #ffffff; color: #8896b3; } /* NOTE: the "Get started" CTA renders with white text and a hidden chevron. Its background is pinned to --cta-bg (see the bar tokens) — azure-500 in light, the recommended azure-400 in dark — instead of Mintlify's per-theme `primary`. The squared-off rules live further down with the other top-bar buttons. */ /* --- Sidebar group headings + right-hand "On this page" heading ---------- → the uppercase gray-600 eyebrow style used across docs.appsignal.com. */ html .sidebar-title, html .sidebar-title > *, html h2.m-0.font-normal, html h2.m-0.font-normal button, html h2.m-0.font-normal button:hover, html h2.m-0.font-normal span { color: var(--text-muted); font-size: 14px; font-weight: 600; line-height: 17.5px; letter-spacing: 0.7px; text-transform: uppercase; } /* Hide the leading chevron on "On this page" and close the gap it leaves. Tailwind's space-x-2 is `> :not([hidden]) ~ :not([hidden])`, which still matches the span because the svg is hidden via `display:none`, not the `hidden` attribute — and at (0,3,0) it outranks a plain `button > span`. `!important` reclaims the 8px so the eyebrow left-aligns with the TOC items and the nested rail below it. */ html h2.m-0.font-normal button svg { display: none; } html h2.m-0.font-normal button > span { margin-left: 0 !important; } /* --- Breadcrumb / eyebrow above the page title -------------------------- Mintlify renders `

` already in primary blue at 14px/600; just add uppercase + tracking to match the docs eyebrow. */ html .eyebrow { letter-spacing: 0.7px; text-transform: uppercase; } /* --- Sidebar links -------------------------------------------------------- Inactive items → gray-800 (Mintlify defaults to gray-700). The right-hand "On this page" links are styled in their own section near the end. */ html nav[aria-label="Pages"] a:not([aria-current]) { color: var(--text-default); } /* Strip Mintlify's blue tint on the active item. The desktop sidebar then re-adds a neutral pill (see "Gray sidebar column" section); this keeps the mobile drawer's active item flat. */ html nav a[aria-current="page"], html aside a[aria-current="page"] { background-color: transparent; } /* --- Body text ---------------------------------------------------------- The rendered MDX body is `.mdx-content` (carries `prose prose-gray`). Set the Tailwind Typography tokens AND target the body elements directly so paragraphs/lists use AppSignal gray-700 instead of Mintlify's near-black. */ html .prose { --tw-prose-body: var(--text-secondary); --tw-prose-lead: var(--text-secondary); --tw-prose-links: var(--link); } /* `:not(.callout *)` keeps this rule out of callouts — otherwise its (0,2,2) specificity beats the callout's single `text-{hue}-800` class and grays out the variant-colored text. */ html .mdx-content p:not(.callout *), html .mdx-content li:not(.callout *), html #content-area header p { color: var(--text-secondary); } /* --- Rounded corners → 8px ---------------------------------------------- Callouts (rounded-2xl / 16px), code groups (16px outer, 14px inner) and the "Copy page" pill — all brought to the docs' 8px convention. The prev/next pager is restyled wholesale in its own section near the end. */ html .callout { border-radius: 8px; } html .code-group { border-radius: 8px; } /* Inner code surface carries `rounded-xt` (14px, !important) so we need !important to win. A standalone fence's surface → 8px; inside a code group it nests at 6px (the group's 8px outer minus its 2px padding). The more specific group rule wins over the standalone one for grouped blocks. */ html .code-block-background { border-radius: 8px !important; } html .code-group .code-block-background { border-radius: 6px !important; } html [class*="min-w-[156px]"] > button:first-child { border-radius: 8px 0 0 8px; } html [class*="min-w-[156px]"] > button:last-child { border-radius: 0 8px 8px 0; } /* Light-mode page background — explicit white. */ html body { background-color: var(--page-bg); } /* =========================================================================== Header parity with the appsignal.com / old docs header. All target values below are computed styles read off the live docs.appsignal.com header (navy bar, plain-text nav items, 4px-radius buttons, white 288px dropdown panels with bordered icon boxes). --------------------------------------------------------------------------- */ /* --- Centering the menu --------------------------------------------------- Mintlify's navbar row is [logo flex-1][nav][buttons flex-1]: the leftover space is split equally, so the menu's center sits left of the bar's center by half the width difference between the two sides — and the right side (search + assistant + Support + CTA) is far wider than the logo. Pin the nav to the true center instead. Only when the bar is wide enough that the centered menu can't collide with the right-side buttons (measured: menu ≈565px, compact right group ≈295px → safe from ≈1255px; 1320 leaves a ≥33px gap); below that, Mintlify's flex flow (and its overflow handling) takes over again. The containing block is the `div.relative` wrapping the row — same height as the row and symmetric within the bar, so 50% here is the bar's center. */ @container navbar (min-width: 1320px) { html #navbar nav[aria-label="Main"] { position: absolute; /* True center, optically nudged left: the busier right-side group makes a dead-centered menu read right-heavy. */ left: calc(50% - 80px); top: 50%; transform: translate(-50%, -50%); } } /* At ≥1500px container width Mintlify expands the search pill ("Search… ⌘K") and assistant button ("Ask Assistant") to their labeled forms, growing the right group to 608px measured from the bar's right edge — which would run into the menu while it's pinned at calc(50% - 80px). Keep the labels (they fit — the bar has slack on the logo side) and instead let the menu slide left just far enough to clear them: its center may not pass 100% - 608px (right group) - 20px (gap) - 282px (half the menu) = 100% - 910px. The min() recenters the menu automatically once the bar is wide enough (≥1660px) and slides it left continuously below that. */ @container navbar (min-width: 1500px) { html #navbar nav[aria-label="Main"] { left: min(calc(50% - 80px), calc(100% - 910px)); } } /* --- Top bar nav items --------------------------------------------------- Old header items are plain text: 16px/400 gray-200 → white, no icons, no hover pill. The Mintlify triggers render a leading mask-icon svg, the label, then a caret svg — hide both. */ html #navbar nav[aria-label="Main"] li > button > svg:first-of-type, html #navbar nav[aria-label="Main"] li > a > svg:first-of-type, html #navbar nav[aria-label="Main"] li > button > svg:last-of-type { display: none; } /* Caret: the old header uses Font Awesome's solid angle-down — a chunky filled chevron whose glyph fills its viewBox. Mintlify's Lucide chevron is a thin 2px stroke that only covers ~half of its box, so it reads tiny even when enlarged. Draw the real FA glyph instead, as a mask-painted ::after (a flex item in the trigger, so the existing gap applies), loaded from the same FontAwesome CDN Mintlify already pulls its nav icons from. Sized to the old caret's measured box (≈9.4×12.8 at font-size 10.8px). */ html #navbar nav[aria-label="Main"] li > button::after { content: ""; flex-shrink: 0; width: 10px; height: 13px; background-color: var(--bar-icon); /* gray-400 — measured off the old header */ -webkit-mask: url(https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/solid/angle-down.svg) center / contain no-repeat; mask: url(https://d3gk2c5xim1je2.cloudfront.net/fontawesome/v7.2.0/solid/angle-down.svg) center / contain no-repeat; } /* Radix returns focus to the trigger when its menu closes, tripping :focus-visible and leaving a blue pill ring after hover-out. The old header has no ring. */ html #navbar nav[aria-label="Main"] li > button:focus-visible, html #navbar nav[aria-label="Main"] li > a:focus-visible { outline: none; } html #navbar nav[aria-label="Main"] li > button, html #navbar nav[aria-label="Main"] li > a { font-size: 16px; font-weight: 400; letter-spacing: normal; padding-left: 12px; /* old: px-3 */ padding-right: 12px; } html #navbar nav[aria-label="Main"] li > button:hover, html #navbar nav[aria-label="Main"] li > a:hover { background-color: transparent; } /* --- Top bar buttons ------------------------------------------------------ Old `c-button c-button--sm`: 34px tall, 4px radius, 16px/400, 4px/12px padding. Support link → the white variant (`c-button--white`, like the old header's "Request demo": white bg, gray-800 text, gray-200 border). The hover color must re-override the navbar-wide white-on-hover link rule. Get started CTA → primary, just squared off from Mintlify's pill. auth-button.js keys off the CTA's users/sign_up href — these rules don't touch the markup. */ html #navbar .navbar-link a { border: 1px solid var(--edge-default); background: var(--bar-btn-bg); color: var(--bar-btn-text); border-radius: 4px; height: 34px; padding: 4px 12px; font-size: 16px; font-weight: 400; } html #navbar .navbar-link a:hover { background: var(--bar-btn-hover); color: var(--bar-btn-text); } /* The label sits in a child that carries Mintlify's own text color (which darkens in dark mode), so color the descendants too — not just the anchor — to keep "Get started" white in both themes. */ html #topbar-cta-button a, html #topbar-cta-button a * { color: #ffffff; } html #topbar-cta-button a { background: var(--cta-bg); border-radius: 4px; height: 34px; padding: 4px 12px; font-size: 16px; font-weight: 400; } /* Mobile (; scope to ours via the .nav-dropdown-item children so the contextual "Copy page" menu and other Radix menus stay untouched. Old panel: white, 288px (w-72), 16px/12px padding, 8px radius, soft navy-tinted shadow, no scroll cap. */ html [data-radix-menu-content]:has(> a.nav-dropdown-item) { width: 288px; max-height: min(80vh, 44rem); padding: 16px 12px; border: none; border-radius: 8px; background-color: var(--panel-bg); box-shadow: var(--shadow-panel); } /* Items: icon box + label, no hover background (old header items only shift text color and lift the icon box shadow). Mintlify's icons are mask-image svgs painted via background-color, so the bordered white "icon box" can't live on the svg itself (the mask would clip it). Instead the box is the anchor's ::before (a real flex item, since pseudo-elements of a flex container participate in layout) and the icon is overlaid on top of it. */ html [data-radix-menu-content] a.nav-dropdown-item { position: relative; gap: 12px; /* old: space-x-3 */ padding: 4px 8px; border-radius: 4px; color: var(--text-secondary); /* gray-700 */ } html [data-radix-menu-content] a.nav-dropdown-item:hover { background-color: transparent; color: var(--text-default); /* gray-800 */ } html [data-radix-menu-content] a.nav-dropdown-item span { font-size: 16px; font-weight: 400; } /* The 28×28 bordered icon box (old: h-7 w-7 border-gray-200 shadow-sm rounded-md, shadow lifts on row hover). */ html [data-radix-menu-content] a.nav-dropdown-item::before { content: ""; display: block; flex-shrink: 0; width: 28px; height: 28px; border: 1px solid var(--edge-default); border-radius: 6px; background-color: var(--iconbox-bg); box-shadow: var(--shadow-iconbox); transition: box-shadow 0.15s; } html [data-radix-menu-content] a.nav-dropdown-item:hover::before { box-shadow: var(--shadow-iconbox-hover); } /* The icon: pulled out of the flex flow and centered over the ::before box (box spans x 8→36px, y centered — a 12px icon centers at left 16px). */ html [data-radix-menu-content] a.nav-dropdown-item > svg:first-of-type { position: absolute; left: 16px; top: 50%; transform: translateY(-50%); width: 12px; height: 12px; min-width: 12px; min-height: 12px; } /* Radix focuses menu items on pointer hover, which trips :focus-visible and paints the browser's blue focus ring on plain mouse hover. The old header has no ring; keyboard users still get the same affordance as hover via Radix's data-highlighted attribute. */ html [data-radix-menu-content] a.nav-dropdown-item:focus-visible { outline: none; } html [data-radix-menu-content] a.nav-dropdown-item[data-highlighted] { color: var(--text-default); } /* Old header items have no trailing external-link arrow. */ html [data-radix-menu-content] a.nav-dropdown-item > svg:last-of-type:not(:first-of-type) { display: none; } /* Per-item icon colors, as on appsignal.com (mask icons are painted via background-color). Default azure, with the marketing palette overrides. */ html [data-radix-menu-content] a.nav-dropdown-item > svg:first-of-type { background-color: #1b44da; /* azure-500 default */ } html [data-radix-menu-content] a[href*="tour/errors"] > svg:first-of-type { background-color: #e05729; /* orange-500 */ } html [data-radix-menu-content] a[href*="tour/performance"] > svg:first-of-type, html [data-radix-menu-content] a[href*="appsignal.com/nodejs"] > svg:first-of-type { background-color: #29a575; /* green-500 */ } html [data-radix-menu-content] a[href*="tour/hosts"] > svg:first-of-type { background-color: #1e9393; /* teal-500 */ } html [data-radix-menu-content] a[href*="tour/anomaly-detection"] > svg:first-of-type, html [data-radix-menu-content] a[href*="appsignal.com/ruby"] > svg:first-of-type { background-color: #c8223d; /* red-500 */ } html [data-radix-menu-content] a[href*="tour/uptime-monitoring"] > svg:first-of-type, html [data-radix-menu-content] a[href*="appsignal.com/javascript"] > svg:first-of-type { background-color: #ec9c24; /* yellow-500 */ } html [data-radix-menu-content] a[href*="tour/metrics"] > svg:first-of-type, html [data-radix-menu-content] a[href*="tour/automated-dashboards"] > svg:first-of-type, html [data-radix-menu-content] a[href*="appsignal.com/elixir"] > svg:first-of-type { background-color: #8537ad; /* purple-500 */ } html [data-radix-menu-content] a[href*="tour/log-management"] > svg:first-of-type { background-color: #ef51c0; /* hot-pink-500 */ } html [data-radix-menu-content] a[href*="tour/check-ins"] > svg:first-of-type, html [data-radix-menu-content] a[href*="tour/workflow"] > svg:first-of-type, html [data-radix-menu-content] a[href*="appsignal.com/python"] > svg:first-of-type { background-color: var(--link); /* blue-500 */ } html [data-radix-menu-content] a[href*="go-monitoring"] > svg:first-of-type { background-color: #3aa2bc; /* cyan-500 */ } html [data-radix-menu-content] a[href*="java-monitoring"] > svg:first-of-type { background-color: #c37b1f; /* coffee-500 */ } html [data-radix-menu-content] a[href*="php-monitoring"] > svg:first-of-type { background-color: #5b62c4; /* indigo-500 */ } /* In dark mode, drop the per-feature brand colors and paint every dropdown icon the dark-mode azure so they match the rest of the dark UI. The html.dark + .nav-dropdown-item specificity beats all the per-href rules above. */ html.dark [data-radix-menu-content] a.nav-dropdown-item > svg:first-of-type { background-color: #60a5fa; /* azure-350D — dark-mode blue */ } /* --- Header height -------------------------------------------------------- Old header: 72px content + 1px border (16px vertical padding around a 40px row). Mintlify's desktop navbar row is h-12 (48px) and three things hang off that number: the fixed sidebar (#sidebar-content, top: 48px, bottom-anchored), the sticky TOC (#content-side-layout, top: 48px, height: 100vh - 48px) and the heading anchor offset (--scroll-mt: 6rem = navbar + 48px breathing room). Bump all four together, desktop only — the

​Contact us

Contact us