Skip to content

armgit / Ix

Public Imported from GitHub
0

Understand any codebase instantly. System intelligence for codebases, built for humans and AI.

docs: match the docs site's header and scrolling to ix-infra.com

KageBinaryb362d59ce30e
diff --git a/docs-site/astro.config.mjs b/docs-site/astro.config.mjs
index e29f3fd6..2fba14f4 100644
--- a/docs-site/astro.config.mjs
+++ b/docs-site/astro.config.mjs
@@ -24,10 +24,11 @@ export default defineConfig({
starlight({
title: 'Ix Docs',
description: 'Documentation for Ix, the persistent codebase graph for humans and AI agents.',
- logo: {
- light: './src/assets/logo-light.png',
- dark: './src/assets/logo-dark.png',
- alt: 'Ix',
+ components: {
+ // ix-infra.com's look: its wordmark in the header, and dark only.
+ SiteTitle: './src/components/SiteTitle.astro',
+ ThemeProvider: './src/components/ThemeProvider.astro',
+ ThemeSelect: './src/components/ThemeSelect.astro',
},
favicon: '/favicon.png',
head: [
diff --git a/docs-site/src/assets/logo-light.png b/docs-site/src/assets/logo-light.png
deleted file mode 100644
index 02ab503f..00000000
Binary files a/docs-site/src/assets/logo-light.png and /dev/null differ
diff --git a/docs-site/src/components/SiteTitle.astro b/docs-site/src/components/SiteTitle.astro
new file mode 100644
index 00000000..047c3753
--- /dev/null
+++ b/docs-site/src/components/SiteTitle.astro
@@ -0,0 +1,53 @@
+---
+// Copyright 2026 Ix Infrastructure Inc.
+
+// Replaces Starlight's SiteTitle with ix-infra.com's wordmark: the paper-plane
+// logo and a bold, tightly set "Ix", followed by a quieter "Docs" so the header
+// says which site this is without competing with the brand.
+import logo from '../assets/logo-dark.png';
+
+const { siteTitleHref } = Astro.locals.starlightRoute;
+---
+
+<a href={siteTitleHref} class="site-title" aria-label="Ix Docs home" translate="no">
+ <img src={logo.src} width={logo.width} height={logo.height} alt="" />
+ <span class="wordmark">Ix</span>
+ <span class="section">Docs</span>
+</a>
+
+<style>
+ .site-title {
+ display: inline-flex;
+ align-items: center;
+ gap: 3px;
+ text-decoration: none;
+ white-space: nowrap;
+ transition: filter 200ms cubic-bezier(0.25, 0.46, 0.45, 0.94);
+ }
+ .site-title:hover {
+ filter: drop-shadow(0 0 10px rgba(91, 143, 212, 0.24));
+ }
+ img {
+ width: 30px;
+ height: 30px;
+ object-fit: contain;
+ }
+ /* The ix-infra.com nav wordmark, at the docs header's height. */
+ .wordmark {
+ color: #e4e1de;
+ font-size: 26px;
+ line-height: 1;
+ font-weight: 700;
+ letter-spacing: -0.04em;
+ }
+ .section {
+ margin-left: 10px;
+ padding-left: 12px;
+ border-left: 1px solid rgba(147, 207, 255, 0.22);
+ color: rgba(228, 225, 222, 0.68);
+ font-size: 17px;
+ font-weight: 500;
+ line-height: 22px;
+ letter-spacing: -0.01em;
+ }
+</style>
diff --git a/docs-site/src/components/ThemeProvider.astro b/docs-site/src/components/ThemeProvider.astro
new file mode 100644
index 00000000..a4ee6ea1
--- /dev/null
+++ b/docs-site/src/components/ThemeProvider.astro
@@ -0,0 +1,13 @@
+---
+// Copyright 2026 Ix Infrastructure Inc.
+
+// Replaces Starlight's ThemeProvider: the docs are dark only, like ix-infra.com,
+// whatever the operating system prefers. Inlined, as Starlight's is, so the page
+// never paints in the wrong theme first. ThemeSelect is replaced with nothing,
+// so there is no picker that could change it.
+---
+
+<script is:inline>
+ document.documentElement.dataset.theme = 'dark';
+ window.StarlightThemeProvider = { updatePickers() {} };
+</script>
diff --git a/docs-site/src/components/ThemeSelect.astro b/docs-site/src/components/ThemeSelect.astro
new file mode 100644
index 00000000..7f71c5f8
--- /dev/null
+++ b/docs-site/src/components/ThemeSelect.astro
@@ -0,0 +1,6 @@
+---
+// Copyright 2026 Ix Infrastructure Inc.
+
+// Replaces Starlight's theme picker with nothing: the docs are dark only, like
+// ix-infra.com (see ThemeProvider.astro).
+---
diff --git a/docs-site/src/styles/theme.css b/docs-site/src/styles/theme.css
index a6f03a78..07c25d74 100644
--- a/docs-site/src/styles/theme.css
+++ b/docs-site/src/styles/theme.css
@@ -1,6 +1,7 @@
/* Copyright 2026 Ix Infrastructure Inc. */
-/* Brand tokens from ix-infra.com: navy background, #489AF1 accent, Inter. */
+/* Brand tokens from ix-infra.com: navy background, #489AF1 accent, Inter. The
+ docs are dark only, like the site (components/ThemeProvider.astro). */
:root {
--sl-font: 'Inter Variable', system-ui, sans-serif;
@@ -21,25 +22,7 @@
--sl-color-black: #0a0f2c;
}
-:root[data-theme='light'] {
- --sl-color-accent-low: #dbeafd;
- --sl-color-accent: #1f6fd1;
- --sl-color-accent-high: #0e3a73;
- --sl-color-white: #0a0f2c;
- --sl-color-gray-1: #1b2440;
- --sl-color-gray-2: #33405f;
- --sl-color-gray-3: #56627f;
- --sl-color-gray-4: #8a93a8;
- --sl-color-gray-5: #c8ccd6;
- --sl-color-gray-6: #eceae7;
- --sl-color-gray-7: #f6f5f3;
- --sl-color-black: #ffffff;
-}
-.site-title img {
- height: 1.6rem;
- width: auto;
-}
.sl-link-button.primary {
background: var(--sl-color-accent);
@@ -53,3 +36,44 @@
color: var(--sl-color-accent-high);
font-weight: 600;
}
+
+/* The header, as ix-infra.com's nav: translucent navy over the page, blurred. */
+:root[data-theme='dark'] {
+ --sl-color-bg-nav: rgba(10, 15, 44, 0.82);
+}
+header.header {
+ backdrop-filter: blur(14px) saturate(140%);
+ -webkit-backdrop-filter: blur(14px) saturate(140%);
+ border-bottom-color: rgba(147, 207, 255, 0.12);
+}
+
+/* Scrolling, as on ix-infra.com: smooth, unless the visitor asked for less
+ motion, and thin navy-tinted scrollbars rather than the browser's bright
+ default, which Windows draws for the page and the sidebar side by side. */
+html {
+ color-scheme: dark;
+ scroll-behavior: smooth;
+}
+@media (prefers-reduced-motion: reduce) {
+ html {
+ scroll-behavior: auto;
+ }
+}
+* {
+ scrollbar-width: thin;
+ scrollbar-color: rgba(147, 207, 255, 0.22) transparent;
+}
+::-webkit-scrollbar {
+ width: 8px;
+ height: 8px;
+}
+::-webkit-scrollbar-track {
+ background: transparent;
+}
+::-webkit-scrollbar-thumb {
+ background: rgba(147, 207, 255, 0.22);
+ border-radius: 8px;
+}
+::-webkit-scrollbar-thumb:hover {
+ background: rgba(147, 207, 255, 0.36);
+}