:root{
  --paper:#f7f4ee; --paper2:#efe9df; --card:#fffdf8; --ink:#1d2b2a; --ink-soft:#5a6463;
  --teal:#0e4b43; --teal-deep:#0a3a34; --terracotta:#c15a3c; --amber:#dca22f;
  --line:#e4ded2; --good:#2f7d5b;
  --shadow:0 18px 40px -24px rgba(14,75,67,.45);
}
*{box-sizing:border-box}
html{scroll-behavior:smooth}

/* CiVQ site header / footer (brand chrome around the guide) */
.sitehead{position:sticky;top:0;z-index:40;display:flex;align-items:center;gap:18px;
  padding:11px clamp(16px,4vw,40px);background:var(--teal-deep);color:#f3efe6;border-bottom:1px solid #0a322d}
.sitehead .wm{display:flex;align-items:center;gap:9px;font-weight:700;font-size:17px;color:#fff;text-decoration:none}
.sitehead .wm .mark{width:22px;height:22px;border-radius:6px;background:linear-gradient(135deg,#1d8a7c,var(--terracotta));display:inline-block}
.sitehead .wm small{font-weight:500;font-size:11px;color:#a9c4be;letter-spacing:.04em}
.sitehead nav{display:flex;gap:18px;margin-left:auto;font-size:14px;font-weight:500}
.sitehead nav a{color:#cfe0db;text-decoration:none}
.sitehead nav a:hover{color:#fff}
.sitehead .demo{background:var(--terracotta);color:#fff;border-radius:999px;padding:5px 13px;font-size:13px;font-weight:600}
.sitehead .demo:hover{color:#fff;opacity:.92}
@media(max-width:680px){.sitehead nav a:not(.demo){display:none}}

.sitefoot{background:var(--teal-deep);color:#cfe0db;padding:34px clamp(16px,4vw,48px) 26px}
.sitefoot .cols{display:grid;grid-template-columns:1.4fr 1fr 1fr 1fr;gap:26px;max-width:1100px;margin:0 auto}
.sitefoot h5{margin:0 0 10px;font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:#8fb0aa}
.sitefoot a{display:block;color:#cfe0db;text-decoration:none;font-size:14px;padding:3px 0}
.sitefoot a:hover{color:#fff}
.sitefoot .brand{color:#fff;font-weight:700;font-size:18px;display:flex;align-items:center;gap:9px}
.sitefoot .brand .mark{width:22px;height:22px;border-radius:6px;background:linear-gradient(135deg,#1d8a7c,var(--terracotta))}
.sitefoot .tag{font-size:13px;color:#9fbcb6;margin-top:8px;max-width:30ch}
.sitefoot .bar{max-width:1100px;margin:24px auto 0;padding-top:16px;border-top:1px solid #0a322d;font-size:12.5px;color:#8fb0aa;display:flex;justify-content:space-between;gap:12px;flex-wrap:wrap}
@media(max-width:760px){.sitefoot .cols{grid-template-columns:1fr 1fr}}
body{margin:0;background:var(--paper);color:var(--ink);
  font:16px/1.65 ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,Helvetica,Arial}
a{color:var(--teal);text-decoration:none}
a:hover{text-decoration:underline}
h1,h2,h3{line-height:1.18;letter-spacing:-.01em}
code{background:var(--paper2);padding:.1em .42em;border-radius:5px;font-size:.86em;
  font-family:ui-monospace,SFMono-Regular,Menlo,monospace}
pre{background:#10211f;color:#e8efed;padding:16px 18px;border-radius:12px;overflow:auto;
  font-size:13px;line-height:1.6;border:1px solid #1c3330}
pre code{background:none;padding:0;color:inherit;font-size:13px}
.wrap{display:grid;grid-template-columns:272px 1fr;max-width:1340px;margin:0 auto}

/* Sidebar */
aside{position:sticky;top:46px;align-self:start;height:calc(100vh - 46px);overflow-y:auto;
  border-right:1px solid var(--line);padding:20px 16px 60px;background:var(--paper);z-index:20}
.sitehead .menubtn{display:none;background:none;border:none;color:#fff;font-size:20px;cursor:pointer;padding:0 4px}
.brand{display:flex;align-items:center;gap:10px;font-weight:700;font-size:18px;text-decoration:none;color:var(--ink)}
.brand:hover{text-decoration:none}
.brand .mark{width:26px;height:26px;border-radius:7px;
  background:linear-gradient(135deg,var(--teal),var(--terracotta));display:inline-block}
.brand small{display:block;font-weight:500;font-size:11px;color:var(--ink-soft);letter-spacing:.04em;text-transform:uppercase}
.search{position:relative;margin:16px 0 8px}
.search input{width:100%;padding:9px 12px 9px 34px;border:1px solid var(--line);border-radius:10px;
  background:var(--card);font-size:14px}
.search input:focus{outline:2px solid var(--teal);outline-offset:1px}
.search svg{position:absolute;left:10px;top:50%;transform:translateY(-50%);width:16px;height:16px;opacity:.5}
.search kbd{position:absolute;right:9px;top:50%;transform:translateY(-50%);font-size:11px;color:var(--ink-soft);
  border:1px solid var(--line);border-radius:5px;padding:1px 5px;background:var(--paper2)}
nav.toc{margin-top:10px;font-size:14px}
nav.toc a{display:block;color:var(--ink-soft);padding:6px 10px;border-radius:8px;border-left:2px solid transparent}
nav.toc a:hover{background:var(--paper2);text-decoration:none}
nav.toc a.active{color:var(--teal-deep);background:var(--paper2);border-left-color:var(--terracotta);font-weight:600}
nav.toc .grp{margin:14px 0 4px;font-size:11px;text-transform:uppercase;letter-spacing:.08em;color:var(--terracotta);font-weight:700;padding-left:10px}

/* Main */
main{padding:0 clamp(20px,4vw,64px) 120px;min-width:0}
.topbar{display:none}
header.hero{padding:54px 0 26px;border-bottom:1px solid var(--line);margin-bottom:8px}
.eyebrow{font-size:12px;letter-spacing:.12em;text-transform:uppercase;color:var(--terracotta);font-weight:700}
header.hero h1{font-size:clamp(30px,4.6vw,46px);margin:.3em 0 .25em}
header.hero p.sub{font-size:18px;color:var(--ink-soft);max-width:64ch;margin:0}
.meta-row{display:flex;flex-wrap:wrap;gap:10px;margin-top:20px}
.chip{background:var(--card);border:1px solid var(--line);border-radius:999px;padding:6px 14px;font-size:13px;font-weight:600;color:var(--teal-deep)}
.pager{display:flex;justify-content:space-between;gap:14px;margin-top:46px;padding-top:22px;border-top:1px solid var(--line)}
.pager a{flex:1;background:var(--card);border:1px solid var(--line);border-radius:12px;padding:14px 16px}
.pager a:hover{box-shadow:var(--shadow);text-decoration:none}
.pager .dir{font-size:11px;text-transform:uppercase;letter-spacing:.07em;color:var(--terracotta);font-weight:700}
.pager .ttl{font-weight:600;color:var(--teal-deep)}
.pager a.next{text-align:right}

.block{padding:34px 0 8px}
h2{font-size:25px;margin:0 0 6px}
h3{font-size:18px;margin:28px 0 8px}
.lead{color:var(--ink-soft);font-size:17px;max-width:72ch;margin:.2em 0 1.3em}

/* Screenshot in browser chrome */
figure.shot{margin:18px 0 6px;border-radius:14px;overflow:hidden;border:1px solid var(--line);
  box-shadow:var(--shadow);background:var(--card)}
.chrome{display:flex;align-items:center;gap:8px;padding:9px 14px;background:#eef0ee;border-bottom:1px solid var(--line)}
.dot{width:11px;height:11px;border-radius:50%}
.dot.r{background:#e0655a}.dot.y{background:#e3b04b}.dot.g{background:#5bb873}
.chrome .url{margin-left:10px;font-size:12.5px;color:#5a6463;background:#fff;border:1px solid var(--line);
  border-radius:6px;padding:3px 12px;font-family:ui-monospace,monospace}
.shotbody{position:relative;line-height:0}
.shotbody img{width:100%;height:auto;display:block;cursor:zoom-in}
figcaption{font-size:13px;color:var(--ink-soft);padding:10px 14px;line-height:1.5}

/* Numbered callout pins */
.pin{position:absolute;transform:translate(-50%,-50%);width:30px;height:30px;border-radius:50%;
  background:var(--terracotta);color:#fff;display:grid;place-items:center;font-weight:700;font-size:14px;
  border:3px solid #fff;box-shadow:0 4px 10px rgba(0,0,0,.3);z-index:3}
.pin::after{content:attr(data-tip);position:absolute;bottom:130%;left:50%;transform:translateX(-50%) scale(.96);
  background:var(--ink);color:#fff;padding:7px 11px;border-radius:8px;font-size:12.5px;font-weight:500;line-height:1.35;
  white-space:normal;width:max-content;max-width:230px;opacity:0;pointer-events:none;transition:.14s;z-index:5}
.pin:hover::after{opacity:1;transform:translateX(-50%) scale(1)}
.pin:hover{background:var(--teal)}

/* Steps */
ol.steps{list-style:none;counter-reset:s;padding:0;margin:14px 0 6px;display:grid;gap:10px}
ol.steps li{counter-increment:s;position:relative;padding:12px 14px 12px 50px;background:var(--card);
  border:1px solid var(--line);border-radius:11px}
ol.steps li::before{content:counter(s);position:absolute;left:12px;top:11px;width:26px;height:26px;border-radius:50%;
  background:var(--terracotta);color:#fff;display:grid;place-items:center;font-size:13px;font-weight:700}
ol.steps li b{color:var(--teal-deep)}

/* Module cards / generic card grid */
.filter{display:flex;align-items:center;gap:10px;margin:6px 0 16px}
.filter input{flex:1;max-width:340px;padding:9px 14px;border:1px solid var(--line);border-radius:10px;background:var(--card);font-size:14px}
.cards{display:grid;grid-template-columns:repeat(auto-fill,minmax(250px,1fr));gap:14px}
.cards.lg{grid-template-columns:repeat(auto-fill,minmax(300px,1fr))}
.cardx{background:var(--card);border:1px solid var(--line);border-radius:13px;padding:16px 16px 14px;transition:.15s;display:block;color:inherit}
a.cardx:hover{box-shadow:var(--shadow);transform:translateY(-2px);text-decoration:none}
.cardx h4{margin:0 0 4px;font-size:16px;color:var(--teal-deep);display:flex;align-items:center;gap:8px}
.cardx .tag{font-size:11px;font-weight:700;color:var(--terracotta);text-transform:uppercase;letter-spacing:.05em}
.cardx p{margin:6px 0 0;font-size:13.5px;color:var(--ink-soft)}

.grid2{display:grid;grid-template-columns:1fr 1fr;gap:22px;align-items:start}
@media(max-width:980px){.grid2{grid-template-columns:1fr}}

/* Architecture diagram */
.arch{display:grid;gap:12px;margin:18px 0}
.arch .row{display:flex;gap:12px;flex-wrap:wrap}
.box{flex:1;min-width:150px;background:var(--card);border:1px solid var(--line);border-radius:12px;padding:14px}
.box.teal{border-color:var(--teal);background:#eef5f3}
.box .t{font-weight:700;color:var(--teal-deep);font-size:15px}
.box .d{font-size:13px;color:var(--ink-soft);margin-top:3px}
.flowdown{text-align:center;color:var(--terracotta);font-size:20px;line-height:1}

/* Requirements table */
table.req{width:100%;border-collapse:collapse;margin:16px 0;background:var(--card);border:1px solid var(--line);border-radius:12px;overflow:hidden}
table.req th,table.req td{text-align:left;padding:11px 14px;border-bottom:1px solid var(--line);font-size:14px;vertical-align:top}
table.req th{background:var(--paper2);color:var(--teal-deep);font-size:12px;text-transform:uppercase;letter-spacing:.04em}
table.req tr:last-child td{border-bottom:none}
table.req code{white-space:nowrap}

.callout{background:#eef5f3;border:1px solid var(--teal);border-left-width:4px;border-radius:10px;padding:13px 16px;margin:16px 0;font-size:14.5px}
.callout.warn{background:#fbf2ea;border-color:var(--terracotta)}
.note{font-size:13px;color:var(--ink-soft)}
footer{padding:40px 0 0;color:var(--ink-soft);font-size:13px;border-top:1px solid var(--line);margin-top:40px}

/* Lightbox */
.lb{position:fixed;inset:0;background:rgba(15,20,19,.92);display:none;z-index:60;padding:24px;overflow:auto;cursor:zoom-out}
.lb.open{display:block}
.lb img{display:block;margin:0 auto;max-width:1100px;width:100%;border-radius:8px;box-shadow:0 30px 80px rgba(0,0,0,.6)}
.lb .x{position:fixed;top:16px;right:22px;color:#fff;font-size:30px;cursor:pointer;font-weight:300}

/* Search overlay */
.sr{position:fixed;inset:0;background:rgba(15,20,19,.55);display:none;z-index:70;padding:9vh 16px 16px}
.sr.open{display:block}
.sr .panel{max-width:680px;margin:0 auto;background:var(--card);border:1px solid var(--line);border-radius:16px;
  box-shadow:0 40px 90px -20px rgba(0,0,0,.5);overflow:hidden}
.sr .top{display:flex;align-items:center;gap:10px;padding:14px 18px;border-bottom:1px solid var(--line)}
.sr .top input{flex:1;border:none;background:none;font-size:18px;outline:none;color:var(--ink)}
.sr .results{max-height:60vh;overflow-y:auto}
.sr .res{display:block;padding:13px 18px;border-bottom:1px solid var(--line);color:inherit}
.sr .res:hover,.sr .res.sel{background:var(--paper2);text-decoration:none}
.sr .res .g{font-size:11px;text-transform:uppercase;letter-spacing:.05em;color:var(--terracotta);font-weight:700}
.sr .res .t{font-weight:600;color:var(--teal-deep);margin:1px 0 2px}
.sr .res .s{font-size:13px;color:var(--ink-soft)}
.sr .res mark{background:#ffe9a8;color:inherit;padding:0 1px;border-radius:3px}
.sr .empty{padding:24px 18px;color:var(--ink-soft);font-size:14px}
.sr .hint{padding:9px 18px;font-size:11.5px;color:var(--ink-soft);background:var(--paper2);display:flex;gap:14px}

/* Mobile */
.topbar{display:none}
@media(max-width:880px){
  .wrap{grid-template-columns:1fr}
  aside{position:fixed;top:0;left:0;height:100vh;width:280px;transform:translateX(-100%);transition:.2s;box-shadow:var(--shadow);z-index:50}
  aside.open{transform:none}
  .sitehead .menubtn{display:inline-flex;align-items:center}
}