feat: Modern styling, draw.io integration, and C4 architecture docs
Build and Deploy Documentation / build (push) Failing after 8s

Styling:
- Dark-first design (Vercel/Linear inspired) with Geist font
- Custom CSS with full --ifm- token overrides
- Glassmorphic navbar, refined sidebar, modern tables
- Gradient hero with animated glow, app cards, C4 section
- Custom badge, tag, and callout components
- Announcement bar, TOC config, dark scrollbar

draw.io:
- Added docusaurus-plugin-drawio + raw-loader
- SMP full pipeline diagram (smp-pipeline.drawio)
- Embedded in architecture overview

Mermaid:
- Added @docusaurus/theme-mermaid
- C4Context, C4Container, C4Component diagrams
- Sequence and graph diagrams in architecture

C4 Architecture (Stock Market Professional):
- L1 Context: system in the world, actors, external systems
- L2 Containers: Data Ingestor, Analysis Engine, Signal Generator, TimescaleDB, Notifier
- L3 Components: deep component breakdown with mermaid C4Component diagrams

Other:
- Sidebar restructured with C4 section and Modules section
- Homepage rebuilt as modern dark landing page
This commit is contained in:
2026-07-16 20:25:09 +00:00
parent f39c2a1e5f
commit 674ec348ce
14 changed files with 2164 additions and 144 deletions
+354 -24
View File
@@ -1,30 +1,360 @@
/**
* Any CSS included here will be global. The classic template
* bundles Infima by default. Infima is a CSS framework designed to
* work well for content-centric websites.
*/
/* ============================================================
SKIC Playground Docs — Modern Dark-First Technical Theme
Inspired by Vercel / Linear design language
Font: Geist (by Vercel) + Geist Mono
============================================================ */
/* You can override the default Infima variables here. */
/* --- Google Fonts / Geist import --- */
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');
/* Geist via CDN */
@import url('https://cdn.jsdelivr.net/npm/geist@1.3.0/dist/fonts/geist-sans/style.css');
@import url('https://cdn.jsdelivr.net/npm/geist@1.3.0/dist/fonts/geist-mono/style.css');
/* ── Design Tokens ───────────────────────────────────────── */
:root {
--ifm-color-primary: #2e8555;
--ifm-color-primary-dark: #29784c;
--ifm-color-primary-darker: #277148;
--ifm-color-primary-darkest: #205d3b;
--ifm-color-primary-light: #33925d;
--ifm-color-primary-lighter: #359962;
--ifm-color-primary-lightest: #3cad6e;
--ifm-code-font-size: 95%;
--docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
/* Brand */
--skic-accent: #6366f1; /* indigo-500 */
--skic-accent-light: #818cf8; /* indigo-400 */
--skic-accent-dark: #4f46e5; /* indigo-600 */
--skic-green: #10b981;
--skic-amber: #f59e0b;
--skic-red: #ef4444;
/* Docusaurus overrides — Light mode */
--ifm-color-primary: #6366f1;
--ifm-color-primary-dark: #4f46e5;
--ifm-color-primary-darker: #4338ca;
--ifm-color-primary-darkest: #3730a3;
--ifm-color-primary-light: #818cf8;
--ifm-color-primary-lighter: #a5b4fc;
--ifm-color-primary-lightest: #c7d2fe;
--ifm-font-family-base: 'Geist', 'Inter', system-ui, sans-serif;
--ifm-font-family-monospace: 'Geist Mono', 'Fira Code', monospace;
--ifm-font-size-base: 15px;
--ifm-line-height-base: 1.7;
--ifm-font-weight-normal: 400;
--ifm-heading-font-weight: 600;
--ifm-heading-letter-spacing: -0.02em;
--ifm-h1-font-size: 2.25rem;
--ifm-h2-font-size: 1.5rem;
--ifm-h3-font-size: 1.2rem;
--ifm-navbar-height: 60px;
--ifm-navbar-shadow: none;
--ifm-toc-border-color: var(--ifm-color-emphasis-200);
--ifm-code-font-size: 0.85rem;
--ifm-code-border-radius: 6px;
--ifm-code-padding-horizontal: 0.4em;
--ifm-code-padding-vertical: 0.15em;
--ifm-pre-border-radius: 10px;
--ifm-pre-padding: 1.25rem;
--ifm-global-radius: 8px;
--ifm-global-shadow-lw: 0 1px 3px 0 rgba(0,0,0,.08);
--ifm-global-shadow-md: 0 4px 12px 0 rgba(0,0,0,.1);
--docusaurus-highlighted-code-line-bg: rgba(99, 102, 241, 0.08);
}
/* For readability concerns, you should choose a lighter palette in dark mode. */
/* ── Dark Mode ───────────────────────────────────────────── */
[data-theme='dark'] {
--ifm-color-primary: #25c2a0;
--ifm-color-primary-dark: #21af90;
--ifm-color-primary-darker: #1fa588;
--ifm-color-primary-darkest: #1a8870;
--ifm-color-primary-light: #29d5b0;
--ifm-color-primary-lighter: #32d8b4;
--ifm-color-primary-lightest: #4fddbf;
--docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
--ifm-color-primary: #818cf8;
--ifm-color-primary-dark: #6366f1;
--ifm-color-primary-darker: #4f46e5;
--ifm-color-primary-darkest: #4338ca;
--ifm-color-primary-light: #a5b4fc;
--ifm-color-primary-lighter: #c7d2fe;
--ifm-color-primary-lightest: #e0e7ff;
--ifm-background-color: #0a0a0a;
--ifm-background-surface-color: #111111;
--ifm-navbar-background-color: rgba(10, 10, 10, 0.85);
--ifm-sidebar-background: #0a0a0a;
--ifm-footer-background-color: #0a0a0a;
--ifm-color-content: #ededed;
--ifm-color-content-secondary:#a1a1a1;
--ifm-color-emphasis-100: #1a1a1a;
--ifm-color-emphasis-200: #222222;
--ifm-color-emphasis-300: #333333;
--ifm-color-emphasis-400: #555555;
--ifm-color-emphasis-600: #999999;
--ifm-color-emphasis-700: #cccccc;
--ifm-color-emphasis-900: #ffffff;
--ifm-toc-border-color: #222222;
--ifm-hr-border-color: #1f1f1f;
--ifm-code-background: #161616;
--ifm-pre-background: #111111;
--ifm-blockquote-border-left-color: var(--skic-accent);
--docusaurus-highlighted-code-line-bg: rgba(129, 140, 248, 0.12);
}
/* ── Typography ──────────────────────────────────────────── */
h1, h2, h3, h4, h5, h6 {
letter-spacing: -0.02em;
font-feature-settings: 'cv02', 'cv03', 'cv04', 'cv11';
}
h1 { font-size: 2.25rem; font-weight: 700; }
h2 { font-size: 1.5rem; border-bottom: 1px solid var(--ifm-color-emphasis-200); padding-bottom: 0.4rem; }
h3 { font-size: 1.15rem; }
p { color: var(--ifm-color-content); }
/* ── Navbar ──────────────────────────────────────────────── */
.navbar {
border-bottom: 1px solid var(--ifm-color-emphasis-200);
backdrop-filter: blur(12px);
-webkit-backdrop-filter: blur(12px);
}
[data-theme='dark'] .navbar {
background: rgba(10, 10, 10, 0.85);
}
.navbar__title {
font-weight: 700;
font-size: 1rem;
letter-spacing: -0.02em;
}
.navbar__logo {
height: 24px;
}
.navbar__link {
font-size: 0.875rem;
font-weight: 500;
color: var(--ifm-color-content-secondary);
transition: color 0.15s ease;
}
.navbar__link:hover,
.navbar__link--active {
color: var(--ifm-color-content) !important;
}
/* ── Sidebar ─────────────────────────────────────────────── */
.theme-doc-sidebar-container {
border-right: 1px solid var(--ifm-color-emphasis-200) !important;
}
.menu__link {
font-size: 0.875rem;
border-radius: 6px;
padding: 0.35rem 0.75rem;
color: var(--ifm-color-content-secondary);
transition: all 0.15s ease;
}
.menu__link:hover {
background: var(--ifm-color-emphasis-100);
color: var(--ifm-color-content);
}
.menu__link--active {
background: var(--ifm-color-emphasis-100) !important;
color: var(--ifm-color-primary) !important;
font-weight: 600;
}
.menu__caret::before {
background: var(--ifm-color-content-secondary);
}
/* ── Code Blocks ─────────────────────────────────────────── */
code {
font-size: 0.84em;
border: 1px solid var(--ifm-color-emphasis-200);
background: var(--ifm-color-emphasis-100);
border-radius: 5px;
}
.prism-code {
font-size: 0.84rem;
line-height: 1.6;
}
.codeBlockContainer_node_modules-\@docusaurus-theme-classic-lib-theme-CodeBlock-Container-styles-module {
border: 1px solid var(--ifm-color-emphasis-200);
}
div[class*="codeBlockContainer"] {
border: 1px solid var(--ifm-color-emphasis-200);
box-shadow: none;
}
div[class*="codeBlockTitle"] {
background: var(--ifm-color-emphasis-100);
border-bottom: 1px solid var(--ifm-color-emphasis-200);
font-size: 0.78rem;
font-family: var(--ifm-font-family-monospace);
color: var(--ifm-color-content-secondary);
}
/* ── Tables ──────────────────────────────────────────────── */
table {
border-collapse: collapse;
width: 100%;
font-size: 0.875rem;
border: 1px solid var(--ifm-color-emphasis-200);
border-radius: 8px;
overflow: hidden;
}
thead {
background: var(--ifm-color-emphasis-100);
}
th {
font-size: 0.75rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.06em;
color: var(--ifm-color-content-secondary);
padding: 0.75rem 1rem;
border-bottom: 1px solid var(--ifm-color-emphasis-200);
}
td {
padding: 0.7rem 1rem;
border-bottom: 1px solid var(--ifm-color-emphasis-100);
}
tr:last-child td { border-bottom: none; }
tbody tr:hover {
background: var(--ifm-color-emphasis-100);
}
/* ── Admonitions (callouts) ──────────────────────────────── */
.admonition {
border-radius: 8px;
border: 1px solid;
border-left-width: 3px;
font-size: 0.9rem;
}
.admonition-note { border-color: var(--ifm-color-emphasis-300); background: var(--ifm-color-emphasis-100); }
.admonition-tip { border-color: var(--skic-green); background: rgba(16, 185, 129, 0.06); }
.admonition-info { border-color: var(--skic-accent); background: rgba(99, 102, 241, 0.06); }
.admonition-warning { border-color: var(--skic-amber); background: rgba(245, 158, 11, 0.06); }
.admonition-danger { border-color: var(--skic-red); background: rgba(239, 68, 68, 0.06); }
.admonition-heading h5 { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.06em; }
/* ── Breadcrumbs ─────────────────────────────────────────── */
.breadcrumbs__link {
font-size: 0.8rem;
}
/* ── TOC ─────────────────────────────────────────────────── */
.table-of-contents__link {
font-size: 0.8rem;
color: var(--ifm-color-content-secondary);
}
.table-of-contents__link:hover,
.table-of-contents__link--active {
color: var(--ifm-color-primary);
}
/* ── Pagination ──────────────────────────────────────────── */
.pagination-nav__link {
border: 1px solid var(--ifm-color-emphasis-200);
border-radius: 8px;
transition: all 0.15s ease;
}
.pagination-nav__link:hover {
border-color: var(--ifm-color-primary);
background: var(--ifm-color-emphasis-100);
}
/* ── Footer ──────────────────────────────────────────────── */
.footer {
border-top: 1px solid var(--ifm-color-emphasis-200);
padding: 2rem 0;
}
.footer__title {
font-size: 0.75rem;
text-transform: uppercase;
letter-spacing: 0.08em;
font-weight: 600;
color: var(--ifm-color-content-secondary);
}
.footer__link-item {
font-size: 0.875rem;
color: var(--ifm-color-content-secondary);
}
/* ── Doc article ─────────────────────────────────────────── */
.markdown {
--ifm-heading-margin-top: 1.75rem;
}
.markdown > h2:first-child { margin-top: 0; }
/* ── Hero (homepage) ─────────────────────────────────────── */
.hero--primary {
background: linear-gradient(135deg, #0a0a0a 0%, #111827 50%, #0a0a0a 100%);
position: relative;
overflow: hidden;
}
.hero--primary::before {
content: '';
position: absolute;
inset: 0;
background: radial-gradient(ellipse at 60% 40%, rgba(99,102,241,0.15) 0%, transparent 65%);
pointer-events: none;
}
.hero__title {
font-size: 3rem;
font-weight: 800;
letter-spacing: -0.04em;
background: linear-gradient(135deg, #ffffff 0%, #a5b4fc 100%);
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
}
.hero__subtitle {
color: #a1a1a1;
font-size: 1.1rem;
font-weight: 400;
}
/* ── Badge component ─────────────────────────────────────── */
.badge--status {
display: inline-flex;
align-items: center;
gap: 0.35rem;
font-size: 0.7rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.06em;
padding: 0.2rem 0.6rem;
border-radius: 100px;
border: 1px solid;
}
.badge--wip { color: var(--skic-amber); border-color: var(--skic-amber); background: rgba(245,158,11,0.08); }
.badge--stable { color: var(--skic-green); border-color: var(--skic-green); background: rgba(16,185,129,0.08); }
.badge--planned { color: var(--ifm-color-content-secondary); border-color: var(--ifm-color-emphasis-300); background: transparent; }
/* ── Scrollbar (webkit) ──────────────────────────────────── */
[data-theme='dark'] ::-webkit-scrollbar { width: 6px; height: 6px; }
[data-theme='dark'] ::-webkit-scrollbar-track { background: transparent; }
[data-theme='dark'] ::-webkit-scrollbar-thumb { background: #333; border-radius: 3px; }
[data-theme='dark'] ::-webkit-scrollbar-thumb:hover { background: #555; }
/* ── Selection ───────────────────────────────────────────── */
::selection { background: rgba(99,102,241,0.25); }