diff --git a/README.md b/README.md
index 2abd555..c945b74 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,23 @@
+<p align="center">
+  <img src="docs/logo.svg" alt="stackglass official logo" width="128" height="128">
+</p>
+
+<p align="center">
+  <a href="https://theworker02.github.io/stackglass/"><img src="https://img.shields.io/badge/docs-live-0B1F33?style=for-the-badge&labelColor=C9A227" alt="Docs"></a>
+  <a href="https://github.com/theworker02/stackglass/releases/tag/v1.0.0"><img src="https://img.shields.io/badge/release-v1.0.0-success?style=for-the-badge" alt="Release"></a>
+  <a href="https://github.com/theworker02/stackglass/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-see%20LICENSE-blue?style=for-the-badge" alt="License"></a>
+  <a href="https://github.com/theworker02/stackglass"><img src="https://img.shields.io/badge/status-maintained-informational?style=for-the-badge" alt="Status"></a>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-1.0.0-0B1F33.svg" alt="version">
+  <img src="https://img.shields.io/badge/category-product-C9A227.svg" alt="category">
+  <img src="https://img.shields.io/badge/pages-enabled-222.svg" alt="pages">
+  <img src="https://img.shields.io/badge/docs-thickened-brightgreen.svg" alt="docs">
+  <img src="https://img.shields.io/badge/notes-detailed-lightgrey.svg" alt="notes">
+</p>
+
+
 <p align="center">
   <img src="assets/stackglass-horizontal.svg" alt="Stackglass" width="420"/>
 </p>
@@ -285,3 +305,16 @@ This project is **proprietary**. Production use, redistribution, and commercial
 ## Acquisition diligence
 
 Buyer-facing diligence materials live in [docs/acquisition/](./docs/acquisition/). Commercial licensing contact path: [COMMERCIAL.md](./COMMERCIAL.md).
+
+## Badges & release notes
+
+| Badge | Meaning |
+| --- | --- |
+| docs live | Public documentation / Pages surface for `stackglass` |
+| release v1.0.0 | Stable tagged release with narrative notes |
+| license | See repository `LICENSE` for terms |
+| status maintained | Actively kept in the @theworker02 portfolio |
+| version 1.0.0 | Documentation and brand completeness milestone |
+| pages enabled | Site intended at `https://theworker02.github.io/stackglass/` |
+
+Detailed narrative for the stable line lives in [CHANGELOG.md](./CHANGELOG.md) and the [v1.0.0 GitHub Release](https://github.com/theworker02/stackglass/releases/tag/v1.0.0).
diff --git a/docs/.nojekyll b/docs/.nojekyll
new file mode 100644
index 0000000..e69de29
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..587e1f9
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,25 @@
+<!DOCTYPE html>
+<html lang="en"><head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+<title>stackglass · v1.0.0</title>
+<link rel="stylesheet" href="styles.css">
+<link rel="icon" href="logo.svg" type="image/svg+xml">
+</head><body>
+<header class="hero">
+<img src="logo.svg" alt="stackglass official logo" width="96" height="96">
+<div>
+<p class="kicker sans">@theworker02/stackglass · v1.0.0</p>
+<h1>stackglass</h1>
+<p class="lede">Stackglass is the observability and verification layer for AI-assisted development.</p>
+</div>
+</header>
+<main class="wrap">
+<section>
+<h2>Release v1.0.0</h2>
+<p>Stable documentation, official logo, badge pack, and detailed release notes.</p>
+<p><a href="https://github.com/theworker02/stackglass/releases/tag/v1.0.0">View release notes</a> ·
+<a href="https://github.com/theworker02/stackglass">Source</a></p>
+</section>
+</main>
+<footer class="sans">v1.0.0 · @theworker02</footer>
+</body></html>
diff --git a/docs/logo.svg b/docs/logo.svg
new file mode 100644
index 0000000..1f464cc
--- /dev/null
+++ b/docs/logo.svg
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="stackglass mark">
+  <rect width="128" height="128" rx="18" fill="#0B1F33"/>
+  <rect x="24" y="78" width="20" height="22" rx="3" fill="none" stroke="#6177c3" stroke-width="4"/>
+  <rect x="50" y="58" width="24" height="42" rx="3" fill="none" stroke="#6177c3" stroke-width="4"/>
+  <rect x="80" y="32" width="28" height="68" rx="3" fill="#6177c3"/>
+  <path d="M28 70l8-10 8 6" fill="none" stroke="#6177c3" stroke-width="4" stroke-linecap="round"/>
+</svg>
diff --git a/docs/styles.css b/docs/styles.css
new file mode 100644
index 0000000..abb4a55
--- /dev/null
+++ b/docs/styles.css
@@ -0,0 +1,225 @@
+:root {
+  --navy: #0B1F33;
+  --navy-2: #14324d;
+  --gold: #C9A227;
+  --gold-soft: #e6d08a;
+  --paper: #f4efe3;
+  --card: #fffdf8;
+  --ink: #122433;
+  --muted: #5a6874;
+  --line: #d9d0ba;
+  --code-bg: #0B1F33;
+  --code-fg: #f4efe3;
+  --shadow: 0 18px 40px rgba(11, 31, 51, 0.12);
+}
+
+* { box-sizing: border-box; }
+
+html {
+  scroll-behavior: smooth;
+}
+
+body {
+  margin: 0;
+  color: var(--ink);
+  background:
+    radial-gradient(1200px 420px at 10% -10%, rgba(201, 162, 39, 0.16), transparent 55%),
+    linear-gradient(180deg, #f7f3ea 0%, var(--paper) 220px);
+  font-family: "Iowan Old Style", "Palatino Linotype", Palatino, "Times New Roman", serif;
+  line-height: 1.65;
+}
+
+.sans, nav, table, .btn, .kicker, footer {
+  font-family: "Segoe UI", "Helvetica Neue", Arial, sans-serif;
+}
+
+a {
+  color: var(--navy);
+  text-decoration-color: var(--gold);
+  text-underline-offset: 0.18em;
+}
+
+a:hover { color: #081524; }
+
+.nav {
+  position: sticky;
+  top: 0;
+  z-index: 20;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 0.7rem 1.4rem;
+  background: rgba(11, 31, 51, 0.96);
+  color: #fff;
+  border-bottom: 3px solid var(--gold);
+  backdrop-filter: blur(8px);
+}
+
+.nav a { color: #fff; text-decoration: none; }
+.nav .links { display: flex; gap: 1.1rem; font-size: 0.92rem; letter-spacing: 0.02em; }
+.nav .links a:hover { color: var(--gold-soft); }
+.nav .brand-lockup {
+  display: flex;
+  align-items: center;
+  gap: 0.65rem;
+  font-weight: 650;
+  letter-spacing: 0.04em;
+}
+.nav img { width: 32px; height: 32px; }
+
+.hero {
+  max-width: 980px;
+  margin: 0 auto;
+  padding: 3.2rem 1.4rem 1.4rem;
+  display: grid;
+  grid-template-columns: 96px 1fr;
+  gap: 1.4rem;
+  align-items: center;
+}
+
+.hero img {
+  width: 96px;
+  height: 96px;
+  filter: drop-shadow(0 10px 18px rgba(11, 31, 51, 0.25));
+}
+
+.kicker {
+  margin: 0 0 0.35rem;
+  color: var(--gold);
+  font-size: 0.78rem;
+  letter-spacing: 0.16em;
+  text-transform: uppercase;
+  font-weight: 700;
+}
+
+h1 {
+  margin: 0;
+  font-size: clamp(2rem, 4vw, 3.1rem);
+  line-height: 1.12;
+  color: var(--navy);
+}
+
+.lede {
+  margin: 0.7rem 0 0;
+  max-width: 62ch;
+  font-size: 1.15rem;
+  color: var(--muted);
+}
+
+.badges { display: flex; flex-wrap: wrap; gap: 0.45rem; margin-top: 1rem; }
+.badge {
+  display: inline-block;
+  padding: 0.18rem 0.55rem;
+  border: 1px solid var(--gold);
+  color: var(--navy);
+  background: rgba(201, 162, 39, 0.12);
+  font-size: 0.75rem;
+  letter-spacing: 0.04em;
+  border-radius: 999px;
+}
+
+.wrap {
+  max-width: 980px;
+  margin: 0 auto;
+  padding: 0 1.4rem 4rem;
+}
+
+section {
+  background: var(--card);
+  border: 1px solid var(--line);
+  border-radius: 16px;
+  padding: 1.5rem 1.6rem 1.35rem;
+  margin: 1.1rem 0;
+  box-shadow: var(--shadow);
+}
+
+h2 {
+  margin: 0 0 0.7rem;
+  color: var(--navy);
+  font-size: 1.35rem;
+  padding-bottom: 0.45rem;
+  border-bottom: 2px solid var(--gold);
+  display: inline-block;
+}
+
+h3 { color: var(--navy-2); margin: 1.1rem 0 0.4rem; }
+
+p { margin: 0.55rem 0; }
+
+ul, ol { margin: 0.4rem 0 0.7rem; padding-left: 1.2rem; }
+
+pre, code, kbd {
+  font-family: "Cascadia Code", Consolas, "Courier New", monospace;
+}
+
+code, kbd {
+  background: #efe8d6;
+  padding: 0.08em 0.38em;
+  border-radius: 4px;
+  font-size: 0.92em;
+}
+
+pre {
+  background: var(--code-bg);
+  color: var(--code-fg);
+  padding: 1rem 1.1rem;
+  overflow-x: auto;
+  border-radius: 10px;
+  border-left: 5px solid var(--gold);
+  font-size: 0.9rem;
+  line-height: 1.5;
+}
+
+pre code { background: transparent; color: inherit; padding: 0; }
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 0.7rem 0 0.2rem;
+  font-size: 0.95rem;
+}
+
+th, td {
+  text-align: left;
+  padding: 0.55rem 0.6rem;
+  border-bottom: 1px solid var(--line);
+  vertical-align: top;
+}
+
+th {
+  color: var(--navy);
+  background: #f3ead3;
+  font-weight: 700;
+}
+
+.callout {
+  background: #0B1F33;
+  color: #f7f3ea;
+  border-radius: 12px;
+  padding: 1rem 1.15rem;
+  margin: 0.9rem 0 0.2rem;
+}
+.callout strong { color: var(--gold-soft); }
+
+.grid-2 {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1rem;
+}
+
+.ok { color: #1d6b3a; font-weight: 700; }
+.fail { color: #9b2c2c; font-weight: 700; }
+
+footer {
+  max-width: 980px;
+  margin: 0 auto;
+  padding: 0 1.4rem 2.5rem;
+  color: var(--muted);
+  font-size: 0.92rem;
+}
+
+@media (max-width: 760px) {
+  .hero, .grid-2 { grid-template-columns: 1fr; }
+  .nav { flex-direction: column; align-items: flex-start; }
+}