:root {
  --bg: #ffffff;
  --bg-soft: #f6f8fb;
  --bg-code: #0f172a;
  --text: #1e293b;
  --text-muted: #64748b;
  --border: #e2e8f0;
  --accent: #ea580c;
  --accent-dark: #c2410c;
  --accent-soft: #fff7ed;
  --green: #16a34a;
  --amber: #d97706;
  --red: #dc2626;
  --radius: 10px;
  --sidebar-w: 270px;
  --max-w: 860px;
}

* { box-sizing: border-box; }

body {
  margin: 0;
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
  color: var(--text);
  background: var(--bg);
  line-height: 1.7;
  font-size: 16px;
}

/* ---------- layout ---------- */
.layout { display: flex; min-height: 100vh; }

.sidebar {
  width: var(--sidebar-w);
  flex-shrink: 0;
  background: #0f172a;
  color: #cbd5e1;
  padding: 28px 0;
  position: sticky;
  top: 0;
  height: 100vh;
  overflow-y: auto;
}

.brand { padding: 0 24px 20px; border-bottom: 1px solid #1e293b; margin-bottom: 16px; }
.brand a { text-decoration: none; color: #fff; }
.brand .logo { font-size: 22px; font-weight: 800; letter-spacing: -0.5px; }
.brand .logo span { color: #60a5fa; }
.brand .tag { font-size: 12.5px; color: #94a3b8; margin-top: 4px; }

.nav-section { padding: 0 24px; margin-top: 18px; }
.nav-section h4 {
  font-size: 11px; text-transform: uppercase; letter-spacing: 1.2px;
  color: #64748b; margin: 0 0 8px; font-weight: 700;
}
.nav-section a {
  display: block; color: #cbd5e1; text-decoration: none;
  padding: 7px 10px; border-radius: 7px; font-size: 14.5px;
}
.nav-section a:hover { background: #1e293b; color: #fff; }
.nav-section a.active { background: #c2410c; color: #fff; font-weight: 600; }

.main { flex: 1; min-width: 0; }
.content { max-width: var(--max-w); margin: 0 auto; padding: 48px 40px 80px; }

.topbar {
  display: none;
  background: #0f172a; color: #fff; padding: 14px 20px;
  position: sticky; top: 0; z-index: 50;
}
.topbar a { color: #fff; text-decoration: none; font-weight: 700; }
.topbar .menu-btn { float: right; background: none; border: 1px solid #334155; color: #fff; border-radius: 7px; padding: 4px 12px; font-size: 14px; cursor: pointer; }

/* ---------- typography ---------- */
h1 { font-size: 34px; letter-spacing: -0.8px; margin: 0 0 12px; line-height: 1.25; }
h2 { font-size: 24px; letter-spacing: -0.4px; margin: 44px 0 12px; padding-top: 8px; border-top: 1px solid var(--border); }
h2:first-of-type { border-top: none; }
h3 { font-size: 18px; margin: 28px 0 8px; }
p { margin: 0 0 16px; }
.lead { font-size: 18px; color: var(--text-muted); margin-bottom: 28px; }
a { color: var(--accent); }
a:hover { color: var(--accent-dark); }
ul, ol { margin: 0 0 16px; padding-left: 24px; }
li { margin-bottom: 6px; }
hr { border: none; border-top: 1px solid var(--border); margin: 36px 0; }

/* ---------- components ---------- */
code {
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  font-size: 0.88em; background: var(--bg-soft);
  padding: 2px 6px; border-radius: 5px; border: 1px solid var(--border);
}
pre {
  background: var(--bg-code); color: #e2e8f0; border-radius: var(--radius);
  padding: 18px 20px; overflow-x: auto; font-size: 14px; line-height: 1.6;
  position: relative; margin: 0 0 20px;
}
pre code { background: none; border: none; padding: 0; color: inherit; font-size: inherit; }
.copy-btn {
  position: absolute; top: 10px; right: 10px;
  background: #1e293b; color: #cbd5e1; border: 1px solid #334155;
  border-radius: 6px; padding: 4px 10px; font-size: 12px; cursor: pointer;
}
.copy-btn:hover { background: #334155; color: #fff; }

table { width: 100%; border-collapse: collapse; margin: 0 0 20px; font-size: 15px; }
th, td { text-align: left; padding: 10px 14px; border-bottom: 1px solid var(--border); vertical-align: top; }
th { background: var(--bg-soft); font-weight: 700; font-size: 13.5px; text-transform: uppercase; letter-spacing: 0.4px; color: var(--text-muted); }
tr:last-child td { border-bottom: none; }

.callout {
  border-radius: var(--radius); padding: 16px 20px; margin: 0 0 20px;
  border-left: 4px solid var(--accent); background: var(--accent-soft);
}
.callout.warn { border-left-color: var(--amber); background: #fffbeb; }
.callout.danger { border-left-color: var(--red); background: #fef2f2; }
.callout.ok { border-left-color: var(--green); background: #f0fdf4; }
.callout p:last-child { margin-bottom: 0; }
.callout strong:first-child { display: block; margin-bottom: 4px; }

.card-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); gap: 16px; margin: 0 0 24px; }
.card {
  border: 1px solid var(--border); border-radius: var(--radius);
  padding: 20px; text-decoration: none; color: inherit; display: block;
  transition: box-shadow 0.15s, transform 0.15s;
}
.card:hover { box-shadow: 0 6px 20px rgba(0,0,0,0.08); transform: translateY(-2px); }
.card h3 { margin: 0 0 6px; font-size: 16.5px; }
.card h3 a { color: inherit; text-decoration: none; }
.card p { margin: 0; font-size: 14px; color: var(--text-muted); }

.badge {
  display: inline-block; font-size: 12px; font-weight: 700; padding: 2px 10px;
  border-radius: 20px; background: var(--accent-soft); color: var(--accent-dark);
  vertical-align: middle; margin-left: 8px;
}
.badge.new { background: #f0fdf4; color: var(--green); }

.footer { margin-top: 60px; padding-top: 24px; border-top: 1px solid var(--border); color: var(--text-muted); font-size: 14px; }
.footer a { color: var(--text-muted); }

/* breadcrumbs / prev-next */
.pagenav { display: flex; justify-content: space-between; gap: 16px; margin-top: 48px; }
.pagenav a {
  border: 1px solid var(--border); border-radius: var(--radius); padding: 14px 18px;
  text-decoration: none; color: inherit; flex: 1; max-width: 48%;
}
.pagenav a:hover { border-color: var(--accent); }
.pagenav .label { display: block; font-size: 12px; color: var(--text-muted); text-transform: uppercase; letter-spacing: 0.6px; }
.pagenav .next { text-align: right; }

kbd {
  font-family: ui-monospace, monospace; font-size: 13px; background: var(--bg-soft);
  border: 1px solid var(--border); border-bottom-width: 2px; border-radius: 5px; padding: 1px 7px;
}

/* ---------- responsive ---------- */
@media (max-width: 900px) {
  .sidebar { display: none; position: fixed; z-index: 100; width: 280px; box-shadow: 0 0 40px rgba(0,0,0,0.3); }
  .sidebar.open { display: block; }
  .topbar { display: block; }
  .content { padding: 32px 22px 60px; }
  h1 { font-size: 28px; }
  .pagenav { flex-direction: column; }
  .pagenav a { max-width: 100%; }
}