/** * DocSmith Base CSS * * A modern, Mintlify-inspired documentation theme with refined aesthetics. * Features: elegant typography, smooth animations, dark/light themes, and a cohesive color system. * * Anchor Points (data-ds attributes): * - data-ds="header" - Page header * - data-ds="layout" - Main layout container * - data-ds="sidebar" - Side navigation * - data-ds="content" - Document content * - data-ds="toc" - Table of contents * - data-ds="footer" - Page footer */ /* Google Fonts: moved to HTML tags for parallel loading */ /* ============================================ CSS Variables - Design Tokens ============================================ */ :root { /* Typography */ --font-sans: 'Plus Jakarta Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; --font-mono: 'JetBrains Mono', 'SF Mono', Monaco, Consolas, monospace; /* Primary Brand Color - Emerald */ --color-primary-50: #ecfdf5; --color-primary-100: #d1fae5; --color-primary-200: #a7f3d0; --color-primary-300: #6ee7b7; --color-primary-400: #34d399; --color-primary-500: #10b981; --color-primary-600: #059669; --color-primary-700: #047857; --color-primary-800: #065f46; --color-primary-900: #064e3b; /* Light Theme (default) */ --color-gray-50: #f9fafb; --color-gray-100: #f3f4f6; --color-gray-200: #e5e7eb; --color-gray-300: #d1d5db; --color-gray-400: #9ca3af; --color-gray-500: #6b7280; --color-gray-600: #4b5563; --color-gray-700: #374151; --color-gray-800: #1f2937; --color-gray-900: #111827; --color-gray-950: #030712; /* Semantic Colors - Light Theme */ --color-text-primary: var(--color-gray-900); --color-text-secondary: var(--color-gray-600); --color-text-muted: var(--color-gray-400); --color-bg-primary: #ffffff; --color-bg-secondary: var(--color-gray-50); --color-bg-tertiary: var(--color-gray-100); --color-border: var(--color-gray-200); --color-border-light: var(--color-gray-100); /* Code Block Colors */ --code-bg: #0f172a; --code-text: #e2e8f0; --code-comment: #64748b; --code-keyword: #f472b6; --code-string: #a5f3fc; --code-function: #fbbf24; /* Effects */ --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05); --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1); --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1); --shadow-glow: 0 0 40px -10px var(--color-primary-400); /* Layout Dimensions - Mintlify-inspired */ --header-height: 64px; --sidebar-width: 260px; --toc-width: 240px; --content-max-width: 720px; --content-gap: 64px; --layout-max-width: 1440px; /* Animation */ --transition-fast: 150ms cubic-bezier(0.4, 0, 0.2, 1); --transition-base: 200ms cubic-bezier(0.4, 0, 0.2, 1); --transition-slow: 300ms cubic-bezier(0.4, 0, 0.2, 1); } /* Dark Theme */ [data-theme="dark"] { --color-text-primary: #f9fafb; --color-text-secondary: #d1d5db; --color-text-muted: #6b7280; --color-bg-primary: #0f172a; --color-bg-secondary: #1e293b; --color-bg-tertiary: #334155; --color-border: #334155; --color-border-light: #1e293b; --color-primary-50: #064e3b; --color-primary-100: #065f46; --color-primary-700: #6ee7b7; --color-primary-800: #a7f3d0; --color-primary-900: #d1fae5; --code-bg: #1e293b; } /* ============================================ Reset & Base ============================================ */ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; } html { font-size: 16px; -webkit-text-size-adjust: 100%; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; scroll-behavior: smooth; } body { min-height: 100vh; font-family: var(--font-sans); font-size: 1rem; line-height: 1.7; color: var(--color-text-primary); background: var(--color-bg-primary); overflow-x: hidden; transition: background-color var(--transition-base), color var(--transition-base); } ::selection { background: var(--color-primary-200); color: var(--color-primary-900); } [data-theme="dark"] ::selection { background: var(--color-primary-700); color: var(--color-bg-primary); } /* ============================================ Scrollbar Styling ============================================ */ ::-webkit-scrollbar { width: 8px; height: 8px; } ::-webkit-scrollbar-track { background: transparent; } ::-webkit-scrollbar-thumb { background: var(--color-gray-300); border-radius: 4px; } ::-webkit-scrollbar-thumb:hover { background: var(--color-gray-400); } [data-theme="dark"] ::-webkit-scrollbar-thumb { background: var(--color-gray-600); } [data-theme="dark"] ::-webkit-scrollbar-thumb:hover { background: var(--color-gray-500); } /* ============================================ Header ============================================ */ [data-ds="header"] { position: sticky; top: 0; z-index: 100; display: flex; align-items: center; height: var(--header-height); padding: 0 2rem; background: rgba(255, 255, 255, 0.85); backdrop-filter: blur(12px); -webkit-backdrop-filter: blur(12px); border-bottom: 1px solid var(--color-border-light); transition: background-color var(--transition-base), border-color var(--transition-base); } [data-theme="dark"] [data-ds="header"] { background: rgba(15, 23, 42, 0.85); } [data-ds="header"] .site-title { font-size: 1.125rem; font-weight: 700; color: var(--color-text-primary); text-decoration: none; display: flex; align-items: center; gap: 0.5rem; transition: color var(--transition-fast); } [data-ds="header"] .site-title::before { content: ''; display: inline-block; width: 8px; height: 8px; background: linear-gradient(135deg, var(--color-primary-400), var(--color-primary-600)); border-radius: 2px; transform: rotate(45deg); } [data-ds="header"] .site-title:hover { color: var(--color-primary-600); } [data-theme="dark"] [data-ds="header"] .site-title:hover { color: var(--color-primary-400); } /* Header Controls Container */ [data-ds="header"] .header-controls { margin-left: auto; display: flex; align-items: center; gap: 0.75rem; } /* Language Dropdown */ [data-ds="header"] .lang-dropdown { position: relative; } [data-ds="header"] .lang-dropdown-trigger { display: flex; align-items: center; gap: 0.5rem; padding: 0.5rem 0.875rem; font-size: 0.8125rem; font-weight: 500; color: var(--color-text-secondary); background: var(--color-bg-secondary); border: 1px solid var(--color-border-light); border-radius: 8px; cursor: pointer; transition: all var(--transition-fast); } [data-ds="header"] .lang-dropdown-trigger:hover { color: var(--color-text-primary); background: var(--color-bg-tertiary); border-color: var(--color-border); } [data-ds="header"] .lang-dropdown-trigger svg { width: 12px; height: 12px; transition: transform var(--transition-fast); } [data-ds="header"] .lang-dropdown:hover .lang-dropdown-trigger svg { transform: rotate(180deg); } [data-ds="header"] .lang-dropdown-menu { position: absolute; top: calc(100% + 4px); right: 0; min-width: 140px; padding: 0.375rem; background: var(--color-bg-primary); border: 1px solid var(--color-border); border-radius: 10px; box-shadow: var(--shadow-lg); opacity: 0; visibility: hidden; transform: translateY(-8px); transition: all var(--transition-fast); z-index: 200; } [data-ds="header"] .lang-dropdown:hover .lang-dropdown-menu { opacity: 1; visibility: visible; transform: translateY(0); } [data-ds="header"] .lang-dropdown-menu a { display: flex; align-items: center; gap: 0.5rem; padding: 0.5rem 0.75rem; font-size: 0.8125rem; font-weight: 500; color: var(--color-text-secondary); text-decoration: none; border-radius: 6px; transition: all var(--transition-fast); } [data-ds="header"] .lang-dropdown-menu a:hover { color: var(--color-text-primary); background: var(--color-bg-secondary); } [data-ds="header"] .lang-dropdown-menu a.active { color: var(--color-primary-600); background: var(--color-primary-50); } [data-theme="dark"] [data-ds="header"] .lang-dropdown-menu a.active { color: var(--color-primary-400); background: var(--color-primary-50); } [data-ds="header"] .lang-dropdown-menu a .lang-flag { font-size: 1rem; line-height: 1; } /* Theme Toggle */ [data-ds="header"] .theme-toggle { display: flex; align-items: center; justify-content: center; width: 36px; height: 36px; padding: 0; background: var(--color-bg-secondary); border: 1px solid var(--color-border-light); border-radius: 8px; cursor: pointer; transition: all var(--transition-fast); } [data-ds="header"] .theme-toggle:hover { background: var(--color-bg-tertiary); border-color: var(--color-border); } [data-ds="header"] .theme-toggle svg { width: 18px; height: 18px; color: var(--color-text-secondary); transition: color var(--transition-fast); } [data-ds="header"] .theme-toggle:hover svg { color: var(--color-text-primary); } /* Sun/Moon icon states */ [data-ds="header"] .theme-toggle .icon-sun { display: block; } [data-ds="header"] .theme-toggle .icon-moon { display: none; } [data-theme="dark"] [data-ds="header"] .theme-toggle .icon-sun { display: none; } [data-theme="dark"] [data-ds="header"] .theme-toggle .icon-moon { display: block; } /* Legacy lang-switcher (fallback) */ [data-ds="header"] .lang-switcher { margin-left: auto; display: flex; align-items: center; gap: 0.25rem; padding: 4px; background: var(--color-bg-secondary); border-radius: 8px; border: 1px solid var(--color-border-light); } [data-ds="header"] .lang-switcher a { padding: 0.375rem 0.75rem; font-size: 0.8125rem; font-weight: 500; color: var(--color-text-secondary); text-decoration: none; border-radius: 6px; transition: all var(--transition-fast); } [data-ds="header"] .lang-switcher a:hover { color: var(--color-text-primary); background: var(--color-bg-primary); } [data-ds="header"] .lang-switcher a.active { color: var(--color-primary-700); background: var(--color-bg-primary); box-shadow: var(--shadow-sm); } [data-theme="dark"] [data-ds="header"] .lang-switcher a.active { color: var(--color-primary-400); } /* ============================================ Layout - Mintlify-inspired three-column ============================================ */ [data-ds="layout"] { display: grid; grid-template-columns: var(--sidebar-width) minmax(0, 1fr) var(--toc-width); max-width: var(--layout-max-width); margin: 0 auto; min-height: calc(100vh - var(--header-height)); } /* ============================================ Sidebar Navigation ============================================ */ [data-ds="sidebar"] { position: sticky; top: var(--header-height); height: calc(100vh - var(--header-height)); overflow-y: auto; padding: 1.5rem 1rem 1.5rem 1.5rem; border-right: 1px solid var(--color-border-light); background: var(--color-bg-primary); transition: background-color var(--transition-base), border-color var(--transition-base); } [data-ds="sidebar"] ul { list-style: none; } [data-ds="sidebar"] li { margin-bottom: 2px; } [data-ds="sidebar"] a { display: flex; align-items: center; padding: 0.5rem 0.875rem; font-size: 0.875rem; font-weight: 450; color: var(--color-text-secondary); text-decoration: none; border-radius: 8px; transition: all var(--transition-fast); position: relative; } [data-ds="sidebar"] a:hover { color: var(--color-text-primary); background: var(--color-bg-secondary); } [data-ds="sidebar"] a.active { color: var(--color-primary-700); background: var(--color-primary-50); font-weight: 500; } [data-theme="dark"] [data-ds="sidebar"] a.active { color: var(--color-primary-400); } [data-ds="sidebar"] a.active::before { content: ''; position: absolute; left: 0; top: 50%; transform: translateY(-50%); width: 3px; height: 60%; background: var(--color-primary-500); border-radius: 0 2px 2px 0; } [data-ds="sidebar"] .nav-group-title { display: block; padding: 0.75rem 0.875rem 0.5rem; font-size: 0.6875rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.08em; color: var(--color-text-muted); text-decoration: none; margin-top: 1.25rem; border-radius: 8px; transition: all var(--transition-fast); } [data-ds="sidebar"] .nav-group-title:first-child { margin-top: 0; } [data-ds="sidebar"] .nav-group-title:hover { color: var(--color-text-primary); background: var(--color-bg-secondary); } [data-ds="sidebar"] .nav-group-title.active { color: var(--color-primary-700); background: var(--color-primary-50); } [data-theme="dark"] [data-ds="sidebar"] .nav-group-title.active { color: var(--color-primary-400); } /* Nested navigation */ [data-ds="sidebar"] ul ul { padding-left: 0.75rem; margin-left: 0.875rem; border-left: 1px solid var(--color-border-light); } [data-ds="sidebar"] ul ul a { font-size: 0.8125rem; } /* ============================================ Main Content - Centered with max-width ============================================ */ [data-ds="content"] { max-width: var(--content-max-width); width: 100%; margin: 0 auto; padding: 2.5rem var(--content-gap) 2.5rem 2rem; animation: fadeIn 0.4s ease-out; } @keyframes fadeIn { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } } /* ============================================ Table of Contents ============================================ */ [data-ds="toc"] { position: sticky; top: var(--header-height); height: calc(100vh - var(--header-height)); overflow-y: auto; padding: 1.5rem 1.5rem 1.5rem 0; font-size: 0.8125rem; } [data-ds="toc"] .toc-title { font-size: 0.6875rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.08em; color: var(--color-text-muted); margin-bottom: 1rem; padding-left: 1rem; } [data-ds="toc"] ul { list-style: none; } [data-ds="toc"] li { margin-bottom: 2px; } [data-ds="toc"] a { display: block; padding: 0.375rem 1rem; color: var(--color-text-secondary); text-decoration: none; border-left: 2px solid transparent; transition: all var(--transition-fast); line-height: 1.5; } [data-ds="toc"] a:hover { color: var(--color-text-primary); border-left-color: var(--color-gray-300); } [data-theme="dark"] [data-ds="toc"] a:hover { border-left-color: var(--color-gray-600); } [data-ds="toc"] a.active { color: var(--color-primary-600); border-left-color: var(--color-primary-500); background: linear-gradient(90deg, var(--color-primary-50), transparent); } [data-theme="dark"] [data-ds="toc"] a.active { color: var(--color-primary-400); } /* Nested TOC levels */ [data-ds="toc"] ul ul a { padding-left: 1.75rem; font-size: 0.75rem; } [data-ds="toc"] ul ul ul a { padding-left: 2.5rem; } /* ============================================ Footer ============================================ */ [data-ds="footer"] { grid-column: 1 / -1; padding: 2rem 2rem; border-top: 1px solid var(--color-border-light); background: var(--color-bg-secondary); text-align: center; font-size: 0.8125rem; color: var(--color-text-muted); transition: background-color var(--transition-base), border-color var(--transition-base); } .docsmith-badge { display: inline-flex; align-items: center; gap: 0.4rem; color: var(--color-text-muted); text-decoration: none; padding: 0.375rem 0.75rem; border-radius: 6px; transition: color 0.2s ease, background-color 0.2s ease; letter-spacing: 0.01em; } .docsmith-badge:hover { color: var(--color-primary-600); background-color: var(--color-primary-50); } [data-theme="dark"] .docsmith-badge:hover { color: var(--color-primary-400); } .docsmith-badge strong { font-weight: 600; } .docsmith-badge-icon { flex-shrink: 0; opacity: 0.6; transition: opacity 0.2s ease, transform 0.2s ease; } .docsmith-badge:hover .docsmith-badge-icon { opacity: 1; transform: translateY(-1px); } /* ============================================ Typography ============================================ */ [data-ds="content"] h1 { font-size: 2.25rem; font-weight: 700; letter-spacing: -0.025em; margin-bottom: 1rem; line-height: 1.25; background: linear-gradient(135deg, var(--color-gray-900) 0%, var(--color-gray-700) 100%); -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text; } [data-theme="dark"] [data-ds="content"] h1 { background: linear-gradient(135deg, #f9fafb 0%, #d1d5db 100%); -webkit-background-clip: text; background-clip: text; } [data-ds="content"] h2 { font-size: 1.5rem; font-weight: 650; letter-spacing: -0.02em; margin-top: 3rem; margin-bottom: 1rem; padding-bottom: 0.75rem; border-bottom: 1px solid var(--color-border); line-height: 1.35; color: var(--color-text-primary); } [data-ds="content"] h3 { font-size: 1.25rem; font-weight: 600; letter-spacing: -0.01em; margin-top: 2.25rem; margin-bottom: 0.75rem; line-height: 1.4; color: var(--color-text-primary); } [data-ds="content"] h4 { font-size: 1.0625rem; font-weight: 600; margin-top: 1.75rem; margin-bottom: 0.625rem; color: var(--color-text-primary); } [data-ds="content"] p { margin-bottom: 1.25rem; color: var(--color-text-secondary); } [data-ds="content"] strong { font-weight: 600; color: var(--color-text-primary); } [data-ds="content"] a { color: var(--color-primary-600); text-decoration: none; font-weight: 500; transition: color var(--transition-fast); border-bottom: 1px solid transparent; } [data-theme="dark"] [data-ds="content"] a { color: var(--color-primary-400); } [data-ds="content"] a:hover { color: var(--color-primary-700); border-bottom-color: var(--color-primary-300); } [data-theme="dark"] [data-ds="content"] a:hover { color: var(--color-primary-300); border-bottom-color: var(--color-primary-600); } /* ============================================ Lists ============================================ */ [data-ds="content"] ul, [data-ds="content"] ol { margin-bottom: 1.25rem; padding-left: 1.25rem; } [data-ds="content"] li { margin-bottom: 0.625rem; color: var(--color-text-secondary); position: relative; } [data-ds="content"] ul > li::marker { color: var(--color-primary-400); } [data-ds="content"] ol > li::marker { color: var(--color-primary-600); font-weight: 600; } [data-theme="dark"] [data-ds="content"] ol > li::marker { color: var(--color-primary-400); } [data-ds="content"] li > ul, [data-ds="content"] li > ol { margin-top: 0.5rem; margin-bottom: 0; } /* ============================================ Code ============================================ */ [data-ds="content"] code { font-family: var(--font-mono); font-size: 0.875em; font-weight: 450; background: var(--color-primary-50); color: var(--color-primary-700); padding: 0.2em 0.4em; border-radius: 6px; border: 1px solid var(--color-primary-100); } [data-theme="dark"] [data-ds="content"] code { background: var(--color-bg-tertiary); color: var(--color-primary-400); border-color: var(--color-border); } [data-ds="content"] pre { margin-bottom: 1.75rem; padding: 1.25rem 1.5rem; background: var(--code-bg); border-radius: 12px; overflow-x: auto; box-shadow: var(--shadow-lg), inset 0 1px 0 rgba(255,255,255,0.05); position: relative; } [data-ds="content"] pre::before { content: ''; position: absolute; top: 12px; left: 16px; display: flex; gap: 8px; } [data-ds="content"] pre code { background: transparent; border: none; padding: 0; font-size: 0.875rem; font-weight: 400; color: var(--code-text); line-height: 1.7; } /* ============================================ Tables ============================================ */ [data-ds="content"] table { width: 100%; margin-bottom: 1.75rem; border-collapse: collapse; font-size: 0.9375rem; border-radius: 12px; overflow: hidden; box-shadow: 0 0 0 1px var(--color-border); } [data-ds="content"] th, [data-ds="content"] td { padding: 0.875rem 1.25rem; text-align: left; border-bottom: 1px solid var(--color-border-light); } [data-ds="content"] th { background: var(--color-bg-secondary); font-weight: 600; color: var(--color-text-primary); font-size: 0.8125rem; text-transform: uppercase; letter-spacing: 0.05em; } [data-ds="content"] td { color: var(--color-text-secondary); } [data-ds="content"] tr:last-child td { border-bottom: none; } [data-ds="content"] tbody tr { transition: background var(--transition-fast); } [data-ds="content"] tbody tr:hover { background: var(--color-bg-secondary); } /* ============================================ Blockquotes / Callouts ============================================ */ [data-ds="content"] blockquote { margin: 1.5rem 0 1.75rem; padding: 1rem 1.5rem; border-left: 4px solid var(--color-primary-400); background: linear-gradient(135deg, var(--color-primary-50), var(--color-bg-secondary)); border-radius: 0 12px 12px 0; position: relative; overflow: hidden; } [data-theme="dark"] [data-ds="content"] blockquote { background: linear-gradient(135deg, var(--color-primary-50), var(--color-bg-secondary)); } [data-ds="content"] blockquote::before { content: ''; position: absolute; top: 0; right: 0; width: 100px; height: 100%; background: linear-gradient(90deg, transparent, var(--color-primary-50)); opacity: 0.5; } [data-ds="content"] blockquote p { position: relative; color: var(--color-primary-800); } [data-theme="dark"] [data-ds="content"] blockquote p { color: var(--color-primary-200); } [data-ds="content"] blockquote p:last-child { margin-bottom: 0; } /* ============================================ Images ============================================ */ [data-ds="content"] img { max-width: 100%; height: auto; border-radius: 12px; margin: 1.5rem 0; box-shadow: var(--shadow-md); transition: transform var(--transition-slow), box-shadow var(--transition-slow); } [data-ds="content"] img:hover { transform: scale(1.01); box-shadow: var(--shadow-lg); } /* ============================================ Horizontal Rule ============================================ */ [data-ds="content"] hr { margin: 3rem 0; border: none; height: 1px; background: linear-gradient(90deg, transparent, var(--color-border), transparent); } /* ============================================ Anchor Links for Headings ============================================ */ [data-ds="content"] .header-anchor { color: var(--color-text-muted); text-decoration: none; margin-left: 0.5rem; opacity: 0; font-weight: 400; transition: all var(--transition-fast); } [data-ds="content"] h1:hover .header-anchor, [data-ds="content"] h2:hover .header-anchor, [data-ds="content"] h3:hover .header-anchor, [data-ds="content"] h4:hover .header-anchor { opacity: 1; } [data-ds="content"] .header-anchor:hover { color: var(--color-primary-500); } /* ============================================ Responsive Design ============================================ */ @media (max-width: 1400px) { :root { --content-gap: 48px; } } @media (max-width: 1200px) { [data-ds="toc"] { display: none; } [data-ds="layout"] { grid-template-columns: var(--sidebar-width) minmax(0, 1fr); } [data-ds="content"] { padding: 2rem 3rem 2rem 2rem; } } @media (max-width: 900px) { :root { --sidebar-width: 240px; } [data-ds="content"] { padding: 2rem; } } @media (max-width: 768px) { [data-ds="header"] { padding: 0 1rem; } [data-ds="layout"] { grid-template-columns: 1fr; } [data-ds="sidebar"] { position: static; height: auto; border-right: none; border-bottom: 1px solid var(--color-border-light); padding: 1rem; max-height: 50vh; } [data-ds="content"] { padding: 1.5rem; max-width: 100%; } [data-ds="content"] h1 { font-size: 1.75rem; } [data-ds="content"] h2 { font-size: 1.375rem; } [data-ds="content"] pre { border-radius: 8px; padding: 1rem; margin-left: -1.5rem; margin-right: -1.5rem; width: calc(100% + 3rem); } [data-ds="header"] .header-controls { gap: 0.5rem; } [data-ds="header"] .lang-dropdown-trigger { padding: 0.375rem 0.625rem; font-size: 0.75rem; } [data-ds="header"] .theme-toggle { width: 32px; height: 32px; } [data-ds="header"] .theme-toggle svg { width: 16px; height: 16px; } } /* ============================================ Print Styles ============================================ */ @media print { [data-ds="header"], [data-ds="sidebar"], [data-ds="toc"], [data-ds="footer"] { display: none; } [data-ds="layout"] { display: block; } [data-ds="content"] { max-width: 100%; padding: 0; } }