diff --git a/docs/components/landing/Architecture.jsx b/docs/components/landing/Architecture.jsx
index 5f0673f4..9c20d82a 100644
--- a/docs/components/landing/Architecture.jsx
+++ b/docs/components/landing/Architecture.jsx
@@ -33,13 +33,14 @@ const TOOLS = [
   { name: "Yaci CLI", sub: "create-node · topup · tip", c: EMBER },
   { name: "Admin API", sub: ":10000 · REST · Swagger", c: AMBER },
   { name: "Yaci Viewer", sub: ":5173 · block explorer", c: CYAN },
+  { name: "Yano Wallet", sub: "desktop wallet · CIP-30", c: BLUE },
   { name: "CIP-30 wallet", sub: "window.cardano.yacidevkit", c: MINT },
   { name: "MCP server", sub: ":10000/mcp · AI agents", c: PINK },
 ];
 const TOOL_X = 930;
 const TOOL_W = 210;
-const TOOL_H = 52;
-const toolY = (i) => 56 + i * 66;
+const TOOL_H = 48;
+const toolY = (i) => 54 + i * 58;
 
 const curve = (x1, y1, x2, y2) => {
   const mx = (x1 + x2) / 2;
@@ -96,7 +97,7 @@ export default function Architecture() {
             Off-chain SDKs such as MeshJS, Evolution SDK, Lucid Evolution, Cardano Client Lib, PyCardano and Sutra
             connect to the devnet through Yaci Store's Blockfrost-compatible API, Ogmios, Kupo and the Submit API. The
             local devnet runs Yano and cardano-node, in companion or yano-only mode. The Yaci CLI, admin API, Yaci
-            Viewer, the CIP-30 wallet and the MCP server let you operate it.
+            Viewer, Yano Wallet, the CIP-30 wallet and the MCP server let you operate it.
           </desc>
           <defs>
             <linearGradient id="dk-core-stroke" x1="0" y1="0" x2="1" y2="1">
@@ -138,7 +139,7 @@ export default function Architecture() {
           <Wire d={curve(API_X + API_W, 379, cx, 330)} color={MINT} dur={2} delay={0.3} />
 
           {TOOLS.map((t, i) => (
-            <Wire key={t.name} d={curve(TOOL_X, toolY(i) + TOOL_H / 2, cx + cw, 120 + i * 62)} color={t.c} dur={2.3} delay={i * 0.3} />
+            <Wire key={t.name} d={curve(TOOL_X, toolY(i) + TOOL_H / 2, cx + cw, 112 + i * 56)} color={t.c} dur={2.3} delay={i * 0.3} />
           ))}
 
           {/* 01 · SDKs */}
@@ -279,18 +280,18 @@ export default function Architecture() {
             return (
               <g key={t.name}>
                 <rect className="node-bg" x={TOOL_X} y={y} width={TOOL_W} height={TOOL_H} rx="12" />
-                <rect x={TOOL_X} y={y + 15} width="3" height="22" rx="1.5" fill={t.c} />
-                <text className="node-title sm" x={TOOL_X + 18} y={y + 23}>
+                <rect x={TOOL_X} y={y + 13} width="3" height="22" rx="1.5" fill={t.c} />
+                <text className="node-title sm" x={TOOL_X + 18} y={y + 21}>
                   {t.name}
                 </text>
-                <text className="node-sub" x={TOOL_X + 18} y={y + 40}>
+                <text className="node-sub" x={TOOL_X + 18} y={y + 37}>
                   {t.sub}
                 </text>
               </g>
             );
           })}
           <text className="node-sub faint" x={TOOL_X + TOOL_W / 2} y="426" textAnchor="middle">
-            terminal · browser · AI agent
+            terminal · browser · desktop · AI agent
           </text>
         </svg>
       </div>
diff --git a/docs/components/landing/Landing.jsx b/docs/components/landing/Landing.jsx
index 1a81dbca..9a2dc350 100644
--- a/docs/components/landing/Landing.jsx
+++ b/docs/components/landing/Landing.jsx
@@ -3,6 +3,7 @@ import Link from "next/link";
 import { Inter, JetBrains_Mono, Space_Grotesk } from "next/font/google";
 import Architecture from "./Architecture";
 import HeroConsole from "./HeroConsole";
+import YanoWalletArt from "./YanoWalletArt";
 import { BlockfrostTerm, BlockSpeed, CatchUpArt, ForkArt, McpChat, NodeModes, WalletArt } from "./FeatureArt";
 import { useGithubStars, useReveal, useScrolled, useTheme } from "./hooks";
 import {
@@ -43,6 +44,7 @@ const GITHUB_URL = `https://github.com/${GITHUB_REPO}`;
 const RELEASE_URL = `${GITHUB_URL}/releases/tag/${VERSION}`;
 const DISCORD_URL = "https://discord.gg/JtQ54MSw6p";
 const X_URL = "https://x.com/bloxbean";
+const YANO_WALLET_URL = "https://github.com/bloxbean/yano-wallet";
 
 const formatStars = (n) => (n >= 1000 ? `${(n / 1000).toFixed(1).replace(/\.0$/, "")}k` : String(n));
 
@@ -93,6 +95,7 @@ function Nav({ theme, onToggleTheme, stars }) {
         <nav className="dk-nav-links" aria-label="Primary">
           <a href="#how-it-works">How it works</a>
           <a href="#features">Features</a>
+          <a href="#yano-wallet">Yano Wallet</a>
           <a href="#get-started">Get started</a>
           <a href="#whats-new">What&apos;s new</a>
           <Link href="/introduction">Docs</Link>
@@ -270,7 +273,7 @@ function HowItWorks() {
           }
         >
           Your off-chain code talks to the same APIs it uses on mainnet. DevKit runs the chain underneath, indexes
-          every block, and gives you a CLI, an admin API, a wallet and an explorer to drive it.
+          every block, and gives you a CLI, an admin API, wallets and an explorer to drive it.
         </SectionHead>
         <div className="dk-arch-card dk-reveal">
           <Architecture />
@@ -301,6 +304,144 @@ function FeatureCard({ span, accent, icon, badge, title, text, link, children, d
   );
 }
 
+/* ------------------------------------------------------------------ */
+
+const YW_POINTS = [
+  "Create or restore wallets, with multiple accounts",
+  "A CIP-30 browser connector: window.cardano.yano",
+  "Simulate before you sign: see what a transaction does first",
+  "Native assets, staking and governance votes",
+];
+
+/* Step 1 depends on how DevKit was installed. Yaci Viewer only ships in Docker; elsewhere it's an optional npm package. */
+const YW_START = [
+  { id: "native", label: "Homebrew · npm", lines: [["$", "yaci-devkit up --enable-yaci-store"]] },
+  { id: "zip", label: "Zip", lines: [["$", "./yaci-cli up --enable-yaci-store"]] },
+  {
+    id: "docker",
+    label: "Docker",
+    lines: [
+      ["$", "devkit start"],
+      ["yaci-cli:>", "create-node -o --start"],
+    ],
+    docker: true,
+  },
+];
+
+const YW_STEPS = [
+  { cmd: "brew install --cask bloxbean/tap/yano-wallet", note: "macOS · other platforms on GitHub" },
+  { cmd: "Connect → Yaci DevKit → localhost:8080", note: "then topup your address", plain: true },
+  { cmd: "Settings → Browser connector", note: "for dApps: load the connector extension, then install Native Messaging", plain: true },
+];
+
+function YanoWallet() {
+  const [copiedAt, setCopiedAt] = useState(-1);
+  const [startAt, setStartAt] = useState(0);
+  const start = YW_START[startAt];
+  const copy = async (i, text) => {
+    try {
+      await navigator.clipboard.writeText(text);
+      setCopiedAt(i);
+      setTimeout(() => setCopiedAt(-1), 1600);
+    } catch {}
+  };
+
+  return (
+    <section id="yano-wallet" className="dk-section">
+      <div className="dk-container">
+        <div className="dk-yw dk-reveal">
+          <div className="dk-yw-copy">
+            <div className="dk-yw-kicker">
+              <span className="tag">Preview</span>
+              Works with Yano Wallet
+            </div>
+            <h2 className="dk-h2">
+              Sign with a <span className="dk-gradient-text">real wallet</span>
+            </h2>
+            <p className="dk-sub">
+              Yano Wallet is a desktop Cardano wallet designed for your custom devnet. Pick <b>Yaci DevKit</b> on its
+              Connect screen and it runs on your devnet&apos;s Yaci Store, so you can approve your dApp&apos;s
+              transactions in a real wallet before you ship.
+            </p>
+            <ul className="dk-yw-points">
+              {YW_POINTS.map((p) => (
+                <li key={p}>
+                  <Check /> {p}
+                </li>
+              ))}
+            </ul>
+            <ol className="dk-yw-steps">
+              <li className="start">
+                <span className="n">1</span>
+                <span className="cmd">
+                  <span className="dk-yw-switch" role="group" aria-label="How you installed Yaci DevKit">
+                    {YW_START.map((o, i) => (
+                      <button key={o.id} type="button" aria-pressed={i === startAt} onClick={() => setStartAt(i)}>
+                        {o.label}
+                      </button>
+                    ))}
+                  </span>
+                  <code key={start.id} className="dk-fade-swap">
+                    {start.lines.map(([prompt, line]) => (
+                      <span key={line} className="line">
+                        <span className="p">{prompt} </span>
+                        {line}
+                      </span>
+                    ))}
+                  </code>
+                  <span className="note">
+                    {start.docker ? "start a devnet · Yaci Store and Yaci Viewer are included" : "start a devnet with Yaci Store"}
+                  </span>
+                  {!start.docker && (
+                    <span className="note">
+                      Viewer (optional): <b>npm i -g @bloxbean/yaci-viewer</b>
+                    </span>
+                  )}
+                </span>
+                <button
+                  type="button"
+                  className="dk-copy"
+                  onClick={() => copy(0, start.lines.filter(([prompt]) => prompt === "$").map(([, line]) => line).join("\n"))}
+                  aria-label={`Copy: ${start.lines[0][1]}`}
+                >
+                  {copiedAt === 0 ? <Check /> : <Copy />}
+                </button>
+              </li>
+              {YW_STEPS.map((st, i) => (
+                <li key={st.cmd}>
+                  <span className="n">{i + 2}</span>
+                  <span className="cmd">
+                    <code>
+                      {!st.plain && <span className="p">$ </span>}
+                      {st.cmd}
+                    </code>
+                    <span className="note">{st.note}</span>
+                  </span>
+                  {!st.plain && (
+                    <button type="button" className="dk-copy" onClick={() => copy(i + 1, st.cmd)} aria-label={`Copy: ${st.cmd}`}>
+                      {copiedAt === i + 1 ? <Check /> : <Copy />}
+                    </button>
+                  )}
+                </li>
+              ))}
+            </ol>
+            <div className="dk-yw-cta">
+              <Link href="/yano-wallet" className="dk-btn dk-btn-primary">
+                Set it up <ArrowRight />
+              </Link>
+              <a href={YANO_WALLET_URL} target="_blank" rel="noopener noreferrer" className="dk-btn dk-btn-ghost">
+                <GitHub /> yano-wallet
+              </a>
+            </div>
+            <p className="dk-yw-note">Preview release, for local devnets and test networks only.</p>
+          </div>
+          <YanoWalletArt />
+        </div>
+      </div>
+    </section>
+  );
+}
+
 function Features() {
   return (
     <section id="features" className="dk-section">
@@ -505,8 +646,8 @@ function RunItYourWay() {
             </>
           }
         >
-          Four distributions, one CLI. Pick the one that fits your machine or your pipeline. They all share
-          <code className="dk-inline-code">~/.yaci-cli</code>.
+          Four distributions, one CLI. Pick the one that fits your machine or your pipeline. Homebrew, npm and Zip
+          share <code className="dk-inline-code">~/.yaci-cli</code>; Docker keeps its data in a Docker volume.
         </SectionHead>
 
         <div className="dk-run dk-reveal">
@@ -717,6 +858,7 @@ export default function Landing() {
         <Hero />
         <Stack />
         <HowItWorks />
+        <YanoWallet />
         <Features />
         <RunItYourWay />
         <WhatsNew />
diff --git a/docs/components/landing/YanoWalletArt.jsx b/docs/components/landing/YanoWalletArt.jsx
new file mode 100644
index 00000000..94564da9
--- /dev/null
+++ b/docs/components/landing/YanoWalletArt.jsx
@@ -0,0 +1,155 @@
+import { useEffect, useState } from "react";
+import { Check } from "./icons";
+import { formatNumber, useInView, useInterval, usePrefersReducedMotion } from "./hooks";
+
+/*
+ * A Yano Wallet window connected to a DevKit devnet, modelled on the real app. A dApp asks it to sign a mint, the
+ * wallet shows what the transaction does, the user approves, and it lands in recent activity. One step per tick,
+ * LOOP ticks per cycle.
+ */
+const LOOP = 10;
+const REDUCED_STEP = 3;
+
+const phaseOf = (t) => {
+  if (t < 2) return "idle";
+  if (t < 3) return "request";
+  if (t < 5) return "simulated";
+  if (t < 6) return "signed";
+  if (t < 8) return "pending";
+  return "confirmed";
+};
+
+const NAV = ["Dashboard", "Send", "Receive", "History", "Staking", "Governance"];
+
+export default function YanoWalletArt() {
+  const [ref, inView] = useInView();
+  const reduced = usePrefersReducedMotion();
+  const [t, setT] = useState(0);
+  const [block, setBlock] = useState(4120);
+
+  useEffect(() => {
+    if (reduced) setT(REDUCED_STEP);
+  }, [reduced]);
+  useInterval(
+    () => {
+      setT((x) => (x + 1) % LOOP);
+      setBlock((b) => b + 1);
+    },
+    1000,
+    inView && !reduced,
+  );
+
+  const phase = phaseOf(t);
+  const sheetOpen = ["request", "simulated", "signed"].includes(phase);
+  const landed = phase === "pending" || phase === "confirmed";
+  const balance = landed ? "999.81" : "1,000.00";
+
+  return (
+    <div ref={ref} className="dk-yw-art" aria-hidden="true">
+      <div className="dk-yw-win">
+        <div className="bar">
+          <span className="lights">
+            <i />
+            <i />
+            <i />
+          </span>
+          <span className="name">Yano Wallet</span>
+          <span className="net">
+            <span className="dot" />
+            Yaci DevKit<span className="port"> · :8080</span>
+          </span>
+        </div>
+
+        <div className="body">
+          <nav className="side">
+            {NAV.map((n, i) => (
+              <span key={n} className={i === 0 ? "on" : ""}>
+                {n}
+              </span>
+            ))}
+            <div className="sync">
+              <span className="pill net-pill">Yaci DevKit</span>
+              <span className="pill sync-pill">synced · block {formatNumber(block)}</span>
+            </div>
+          </nav>
+
+          <div className="main">
+            <div className="acct">
+              <span className="who">Account 0 · Test</span>
+              <span className="hw">CIP-30 · window.cardano.yano</span>
+            </div>
+            <div className="bal">
+              <span className="lbl">Total balance</span>
+              <b key={balance} className="dk-fade-swap">
+                {balance} <em>₳</em>
+              </b>
+              <span className="assets">
+                <span>₳</span>
+                <span>TEST ×250</span>
+                {landed && <span className="new dk-fade-swap">YaciTestNFT ×1</span>}
+              </span>
+            </div>
+
+            <div className="act">
+              <div className="act-head">Recent activity</div>
+              {landed && (
+                <div className={`row fresh ${phase}`}>
+                  <span className="kind">Mint · dApp</span>
+                  <span className="hash">8c1f…a7e2 ↗</span>
+                  <span className="amt neg">−0.19 ₳</span>
+                  <span className={`st ${phase}`}>{phase === "pending" ? "pending" : "confirmed"}</span>
+                </div>
+              )}
+              <div className="row">
+                <span className="kind">Top-up · faucet</span>
+                <span className="hash">41d9…0b3c ↗</span>
+                <span className="amt pos">+1,000 ₳</span>
+                <span className="st confirmed">confirmed</span>
+              </div>
+              <div className="row dim">
+                <span className="kind">Receive</span>
+                <span className="hash">e07a…5d11 ↗</span>
+                <span className="amt pos">+250 TEST</span>
+                <span className="st confirmed">confirmed</span>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <div className={`sheet ${sheetOpen ? "open" : ""} ${phase}`}>
+          <div className="sheet-top">
+            <span className="what">Approve transaction</span>
+            <span className="app">localhost:3000 asks you to sign a transaction</span>
+          </div>
+          <div className="sim">
+            <div className="sim-row">
+              <span>Leaves your wallet</span>
+              <b>₳ 0.185565</b>
+            </div>
+            <div className="sim-row">
+              <span>Network fee</span>
+              <b>included</b>
+            </div>
+            <div className="sim-row">
+              <span>Mints</span>
+              <b className="pos">+1 YaciTestNFT</b>
+            </div>
+            <div className={`sim-warn ${phase === "request" ? "" : "on"}`}>Creates new tokens: worth questioning if you didn&apos;t ask to mint.</div>
+          </div>
+          <div className="sheet-actions">
+            {phase === "signed" ? (
+              <span className="sheet-btn ok">
+                <Check /> Signed and submitted
+              </span>
+            ) : (
+              <>
+                <span className="sheet-btn">Approve</span>
+                <span className="sheet-btn ghost">Reject</span>
+              </>
+            )}
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}
diff --git a/docs/components/landing/landing.css b/docs/components/landing/landing.css
index 4d084721..cdb32ab0 100644
--- a/docs/components/landing/landing.css
+++ b/docs/components/landing/landing.css
@@ -2407,6 +2407,655 @@ html[data-dk-theme="light"] .dk {
   color: var(--text);
 }
 
+/* ---------- Yano Wallet spotlight ---------- */
+.dk-yw {
+  position: relative;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) minmax(0, 1.12fr);
+  gap: clamp(28px, 3.5vw, 48px);
+  align-items: center;
+  padding: clamp(24px, 4vw, 52px);
+  border-radius: 28px;
+  border: 1px solid var(--border);
+  background:
+    radial-gradient(120% 90% at 100% 0%, color-mix(in srgb, var(--blue) 14%, transparent), transparent 55%),
+    radial-gradient(90% 80% at 0% 100%, color-mix(in srgb, var(--ember) 12%, transparent), transparent 60%),
+    var(--surface);
+  backdrop-filter: blur(12px);
+  box-shadow: var(--shadow);
+  overflow: hidden;
+}
+
+.dk-yw::before {
+  content: "";
+  position: absolute;
+  inset: 0;
+  border-radius: inherit;
+  padding: 1px;
+  background: linear-gradient(130deg, color-mix(in srgb, var(--ember) 70%, transparent), transparent 35%, transparent 65%, color-mix(in srgb, var(--blue) 70%, transparent));
+  -webkit-mask: linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0);
+  -webkit-mask-composite: xor;
+  mask-composite: exclude;
+  pointer-events: none;
+}
+
+.dk-yw-kicker {
+  display: inline-flex;
+  align-items: center;
+  gap: 10px;
+  margin-bottom: 18px;
+  font-family: var(--font-mono);
+  font-size: 0.76rem;
+  font-weight: 600;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--orange);
+}
+
+.dk-yw-kicker .tag {
+  padding: 3px 8px;
+  border-radius: 6px;
+  background: var(--grad);
+  color: #fff;
+  letter-spacing: 0.08em;
+}
+
+.dk-yw h2.dk-h2 {
+  font-size: clamp(2rem, 3.4vw, 2.6rem);
+}
+
+.dk-yw .dk-sub b {
+  color: var(--text);
+  font-weight: 600;
+}
+
+.dk-yw-copy {
+  min-width: 0;
+}
+
+.dk-yw-points {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  gap: 10px;
+  margin: 22px 0 24px;
+  padding: 0;
+  list-style: none;
+}
+
+.dk-yw-points li {
+  display: flex;
+  align-items: flex-start;
+  gap: 10px;
+  color: var(--text);
+  font-size: 0.95rem;
+  line-height: 1.5;
+}
+
+.dk-yw-points svg {
+  flex: none;
+  width: 18px;
+  height: 18px;
+  margin-top: 2px;
+  padding: 3px;
+  border-radius: 6px;
+  color: var(--mint);
+  background: color-mix(in srgb, var(--mint) 14%, transparent);
+  stroke-width: 2.6;
+}
+
+.dk-yw-steps {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr);
+  gap: 8px;
+  margin: 0 0 26px;
+  padding: 0;
+  list-style: none;
+}
+
+.dk-yw-steps li {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 10px 10px 10px 12px;
+  border-radius: 12px;
+  border: 1px solid var(--border);
+  background: var(--code-bg);
+}
+
+.dk-yw-steps .n {
+  flex: none;
+  display: grid;
+  place-items: center;
+  width: 24px;
+  height: 24px;
+  border-radius: 7px;
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  font-weight: 700;
+  color: var(--orange);
+  background: color-mix(in srgb, var(--orange) 14%, transparent);
+}
+
+.dk-yw-steps .cmd {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  flex: 1;
+  min-width: 0;
+}
+
+.dk-yw-steps code {
+  overflow-x: auto;
+  white-space: nowrap;
+  font-family: var(--font-mono);
+  font-size: 0.82rem;
+  color: var(--code-text);
+  scrollbar-width: none;
+}
+
+.dk-yw-steps code .p {
+  color: var(--orange);
+}
+
+.dk-yw-steps .note {
+  font-size: 0.74rem;
+  color: var(--code-muted);
+}
+
+.dk-yw-steps .note b {
+  font-family: var(--font-mono);
+  font-weight: 500;
+  color: var(--code-text);
+  white-space: nowrap;
+}
+
+.dk-yw-steps code .line {
+  display: block;
+}
+
+/* Step 1: pick the distribution */
+.dk-yw-steps li.start {
+  align-items: flex-start;
+}
+
+.dk-yw-steps li.start .dk-copy {
+  margin-top: 26px;
+}
+
+.dk-yw-switch {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  margin-bottom: 6px;
+}
+
+.dk-yw-switch button {
+  padding: 2px 9px;
+  border-radius: 999px;
+  border: 1px solid color-mix(in srgb, var(--code-text) 18%, transparent);
+  background: transparent;
+  color: var(--code-muted);
+  font: 500 0.7rem/1.6 var(--font-mono);
+  cursor: pointer;
+}
+
+.dk-yw-switch button:hover {
+  color: var(--code-text);
+}
+
+.dk-yw-switch button[aria-pressed="true"] {
+  border-color: var(--orange);
+  background: color-mix(in srgb, var(--orange) 16%, transparent);
+  color: var(--code-text);
+}
+
+.dk-yw-cta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+
+.dk p.dk-yw-note {
+  margin-top: 14px;
+  font-size: 0.8rem;
+  color: var(--faint);
+}
+
+/* The wallet window */
+.dk-yw-art {
+  position: relative;
+  perspective: 1400px;
+}
+
+.dk-yw-win {
+  position: relative;
+  border-radius: 16px;
+  border: 1px solid var(--border-strong);
+  background: var(--surface-solid);
+  box-shadow: 0 40px 90px -40px rgba(0, 0, 0, 0.8), 0 0 0 1px rgba(255, 255, 255, 0.02);
+  overflow: hidden;
+  transform: rotateY(-6deg) rotateX(3deg);
+  transition: transform 0.6s ease;
+  font-size: 0.8rem;
+}
+
+.dk-yw-art:hover .dk-yw-win {
+  transform: none;
+}
+
+.dk-yw-win .bar {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 10px 14px;
+  border-bottom: 1px solid var(--border);
+  background: color-mix(in srgb, var(--text) 3%, transparent);
+}
+
+.dk-yw-win .lights {
+  display: inline-flex;
+  gap: 6px;
+}
+
+.dk-yw-win .lights i {
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  background: #ff5f57;
+}
+
+.dk-yw-win .lights i:nth-child(2) { background: #febc2e; }
+.dk-yw-win .lights i:nth-child(3) { background: #28c840; }
+
+.dk-yw-win .name {
+  white-space: nowrap;
+  font-weight: 600;
+  color: var(--text);
+}
+
+.dk-yw-win .net {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  margin-left: auto;
+  padding: 3px 9px;
+  border-radius: 99px;
+  white-space: nowrap;
+  font-family: var(--font-mono);
+  font-size: 0.7rem;
+  color: var(--mint);
+  border: 1px solid color-mix(in srgb, var(--mint) 35%, transparent);
+  background: color-mix(in srgb, var(--mint) 10%, transparent);
+}
+
+.dk-yw-win .dot {
+  width: 7px;
+  height: 7px;
+  border-radius: 50%;
+  background: var(--mint);
+  box-shadow: 0 0 0 0 color-mix(in srgb, var(--mint) 60%, transparent);
+  animation: dk-yw-pulse 2s ease-out infinite;
+}
+
+@keyframes dk-yw-pulse {
+  to { box-shadow: 0 0 0 7px transparent; }
+}
+
+.dk-yw-win .body {
+  display: grid;
+  grid-template-columns: 136px minmax(0, 1fr);
+  min-height: 400px;
+}
+
+.dk-yw-win .side {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 12px 8px;
+  border-right: 1px solid var(--border);
+  color: var(--muted);
+}
+
+.dk-yw-win .side > span {
+  padding: 6px 10px;
+  border-radius: 8px;
+}
+
+.dk-yw-win .side > span.on {
+  color: var(--text);
+  background: color-mix(in srgb, var(--orange) 14%, transparent);
+  box-shadow: inset 2px 0 0 var(--orange);
+}
+
+.dk-yw-win .sync {
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
+  margin-top: auto;
+}
+
+.dk-yw-win .sync .pill {
+  padding: 4px 6px;
+  border-radius: 8px;
+  text-align: center;
+  white-space: nowrap;
+  font-size: 0.62rem;
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+}
+
+.dk-yw-win .net-pill {
+  color: var(--blue);
+  background: color-mix(in srgb, var(--blue) 18%, transparent);
+}
+
+.dk-yw-win .sync-pill {
+  color: var(--mint);
+  background: color-mix(in srgb, var(--mint) 18%, transparent);
+}
+
+.dk-yw-win .main {
+  display: flex;
+  flex-direction: column;
+  gap: 14px;
+  padding: 16px 18px;
+  min-width: 0;
+}
+
+.dk-yw-win .acct {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  color: var(--muted);
+}
+
+.dk-yw-win .hw {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  padding: 2px 8px;
+  border-radius: 6px;
+  font-family: var(--font-mono);
+  font-size: 0.66rem;
+  color: var(--blue);
+  background: color-mix(in srgb, var(--blue) 12%, transparent);
+}
+
+.dk-yw-win .bal .lbl {
+  display: block;
+  font-size: 0.7rem;
+  color: var(--faint);
+}
+
+.dk-yw-win .bal b {
+  display: block;
+  font-family: var(--font-display);
+  font-size: 2rem;
+  font-weight: 700;
+  letter-spacing: -0.02em;
+  color: var(--text);
+  font-variant-numeric: tabular-nums;
+}
+
+.dk-yw-win .bal em {
+  font-style: normal;
+  color: var(--orange);
+}
+
+.dk-yw-win .assets {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-top: 8px;
+}
+
+.dk-yw-win .assets span {
+  padding: 2px 8px;
+  border-radius: 6px;
+  font-family: var(--font-mono);
+  font-size: 0.68rem;
+  color: var(--muted);
+  border: 1px solid var(--border);
+}
+
+.dk-yw-win .assets span.new {
+  color: var(--violet);
+  border-color: color-mix(in srgb, var(--violet) 45%, transparent);
+  background: color-mix(in srgb, var(--violet) 10%, transparent);
+}
+
+.dk-yw-win .act {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.dk-yw-win .act-head {
+  font-size: 0.68rem;
+  font-weight: 600;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--faint);
+}
+
+.dk-yw-win .row {
+  display: grid;
+  grid-template-columns: minmax(0, 1.2fr) minmax(0, 1fr) auto auto;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 10px;
+  border-radius: 9px;
+  border: 1px solid var(--border);
+  background: color-mix(in srgb, var(--text) 2%, transparent);
+}
+
+.dk-yw-win .row.dim {
+  opacity: 0.6;
+}
+
+.dk-yw-win .row.fresh {
+  animation: dk-yw-row-in 0.5s ease both;
+}
+
+.dk-yw-win .row.fresh.pending {
+  border-color: color-mix(in srgb, var(--amber) 45%, transparent);
+}
+
+@keyframes dk-yw-row-in {
+  from { opacity: 0; transform: translateY(-6px); }
+}
+
+.dk-yw-win .row .kind {
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  color: var(--text);
+}
+
+.dk-yw-win .row .hash {
+  overflow: hidden;
+  white-space: nowrap;
+  font-family: var(--font-mono);
+  font-size: 0.7rem;
+  color: var(--cyan);
+}
+
+.dk-yw-win .row .amt {
+  font-family: var(--font-mono);
+  font-size: 0.72rem;
+  white-space: nowrap;
+}
+
+.dk-yw-win .amt.pos,
+.dk-yw-win .sim b.pos {
+  color: var(--mint);
+}
+
+.dk-yw-win .amt.neg {
+  color: var(--text);
+}
+
+.dk-yw-win .st {
+  padding: 1px 7px;
+  border-radius: 99px;
+  font-size: 0.64rem;
+  color: var(--mint);
+  background: color-mix(in srgb, var(--mint) 12%, transparent);
+}
+
+.dk-yw-win .st.pending {
+  color: var(--amber);
+  background: color-mix(in srgb, var(--amber) 14%, transparent);
+}
+
+/* The signing sheet, sliding in over the window */
+.dk-yw-win .sheet {
+  position: absolute;
+  right: 14px;
+  bottom: 14px;
+  width: min(268px, calc(100% - 28px));
+  padding: 14px;
+  border-radius: 14px;
+  border: 1px solid var(--border-strong);
+  background: var(--surface-solid);
+  box-shadow: 0 24px 60px -20px rgba(0, 0, 0, 0.7);
+  opacity: 0;
+  transform: translateY(16px) scale(0.97);
+  pointer-events: none;
+  transition: opacity 0.4s ease, transform 0.45s cubic-bezier(0.2, 0.8, 0.2, 1);
+}
+
+.dk-yw-win .sheet.open {
+  opacity: 1;
+  transform: none;
+}
+
+.dk-yw-win .sheet-top {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  margin-bottom: 10px;
+}
+
+.dk-yw-win .sheet-top .app {
+  font-size: 0.72rem;
+  color: var(--muted);
+}
+
+.dk-yw-win .sheet-top .what {
+  font-weight: 600;
+  color: var(--text);
+}
+
+.dk-yw-win .sim {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 10px;
+  margin-bottom: 10px;
+  border-radius: 10px;
+  background: color-mix(in srgb, var(--text) 4%, transparent);
+}
+
+.dk-yw-win .sim-row {
+  display: flex;
+  justify-content: space-between;
+  color: var(--muted);
+}
+
+.dk-yw-win .sim-row b {
+  font-family: var(--font-mono);
+  font-size: 0.74rem;
+  color: var(--text);
+}
+
+.dk-yw-win .sim-warn {
+  font-size: 0.68rem;
+  line-height: 1.4;
+  color: var(--amber);
+  opacity: 0;
+  transform: translateY(4px);
+  transition: opacity 0.4s ease, transform 0.4s ease;
+}
+
+.dk-yw-win .sim-warn::before {
+  content: "• ";
+}
+
+.dk-yw-win .sim-warn.on {
+  opacity: 1;
+  transform: none;
+}
+
+.dk-yw-win .sheet-actions {
+  display: flex;
+  gap: 8px;
+}
+
+.dk-yw-win .sheet-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 7px;
+  height: 32px;
+  padding: 0 16px;
+  border-radius: 9px;
+  font-weight: 600;
+  color: #fff;
+  background: linear-gradient(115deg, #2563eb, #0891b2);
+}
+
+.dk-yw-win .sheet-btn.ghost {
+  color: var(--text);
+  background: transparent;
+  border: 1px solid var(--border-strong);
+}
+
+.dk-yw-win .sheet-btn.ok {
+  flex: 1;
+  color: var(--mint);
+  background: color-mix(in srgb, var(--mint) 18%, transparent);
+}
+
+.dk-yw-win .sheet-btn svg {
+  width: 13px;
+  height: 13px;
+  stroke-width: 2.4;
+}
+
+@media (max-width: 1024px) {
+  .dk-yw {
+    grid-template-columns: minmax(0, 1fr);
+  }
+
+  .dk-yw-win {
+    transform: none;
+  }
+}
+
+@media (max-width: 560px) {
+  .dk-yw-win .body {
+    grid-template-columns: minmax(0, 1fr);
+    min-height: 360px;
+  }
+
+  .dk-yw-win .side {
+    display: none;
+  }
+
+  .dk-yw-win .row {
+    grid-template-columns: minmax(0, 1fr) auto auto;
+  }
+
+  .dk-yw-win .row .hash {
+    display: none;
+  }
+
+  .dk-yw-win .net .port {
+    display: none;
+  }
+}
+
 /* ---------- Reveal on scroll ---------- */
 html[data-dk-js] .dk-reveal {
   opacity: 0;
diff --git a/docs/pages/_meta.json b/docs/pages/_meta.json
index 7bff63d6..32508462 100644
--- a/docs/pages/_meta.json
+++ b/docs/pages/_meta.json
@@ -12,6 +12,7 @@
   "services": "Services",
   "yano-node-modes": "Node Modes",
   "cip30-wallet": "CIP-30 Wallet",
+  "yano-wallet": "Yano Wallet (Preview)",
   "mcp-integration": "MCP Integration",
   "commands": "Yaci CLI Commands",
   "node-configuration": "Node Configuration",
diff --git a/docs/pages/cip30-wallet.mdx b/docs/pages/cip30-wallet.mdx
index bfe93bba..047c7f1d 100644
--- a/docs/pages/cip30-wallet.mdx
+++ b/docs/pages/cip30-wallet.mdx
@@ -99,3 +99,8 @@ The packaged `examples/` folder includes browser examples that use CIP-30:
 Both Docker and native CLI zip distributions include these examples.
 
 Run `info` in Yaci CLI to see the active wallet page and SDK URLs for your devnet.
+
+## Testing with a Desktop Wallet
+
+To test with a real wallet and the approval prompts your users will see, connect [Yano Wallet](/yano-wallet) to your
+devnet.
diff --git a/docs/pages/yano-wallet.mdx b/docs/pages/yano-wallet.mdx
new file mode 100644
index 00000000..3b937acc
--- /dev/null
+++ b/docs/pages/yano-wallet.mdx
@@ -0,0 +1,209 @@
+---
+title: Yano Wallet (Preview)
+---
+
+import { Callout, Steps, Tabs } from 'nextra/components'
+
+# Yano Wallet <span className="yw-preview-badge">Preview</span>
+
+[Yano Wallet](https://github.com/bloxbean/yano-wallet) is a desktop Cardano wallet designed for your custom devnet.
+Connect it to a Yaci DevKit devnet to test your dApp with a real wallet: create or restore accounts, send ADA and
+tokens, and approve CIP-30 requests from your dApp in the browser.
+
+<Callout type="warning">
+Yano Wallet is a preview release and should be used only on devnets and test networks.
+</Callout>
+
+![Yano Wallet connected to a Yaci DevKit devnet](/images/yano-wallet/dashboard.png)
+
+## What you get
+
+- Create or restore wallets, with multiple accounts
+- Send and receive ADA and native assets, staking, and governance voting
+- A **CIP-30 dApp connector**: a browser extension that injects `window.cardano.yano` and hands each request to the
+  wallet for approval
+- **Simulate before you sign**: the approval prompt shows what a transaction does to your wallet, such as the ADA that
+  leaves it and the tokens it mints, before you sign
+- Transaction hashes link to Yaci Viewer at `http://localhost:5173`. See [Yaci Viewer](#yaci-viewer-optional) for
+  how to get it
+
+## How it connects
+
+On other networks Yano Wallet runs its own Yano node. With Yaci DevKit it doesn't: it talks to the devnet's
+**Yaci Store** over its Blockfrost-compatible API at `http://localhost:8080/api/v1`. Yaci Store must be running.
+
+| Setting | Value |
+|---|---|
+| Network | `Yaci DevKit` (protocol magic 42) |
+| Backend | External, Yaci Store |
+| Default URL | `http://localhost:8080/api/v1` |
+
+A browser dApp reaches the wallet through two pieces you install once: the **Yano Wallet Connector** extension in the
+browser, and the **Native Messaging** host that the wallet registers with the browser.
+
+```text
+dApp (window.cardano.yano) → Yano Wallet Connector extension → Native Messaging host → Yano Wallet → Yaci Store
+```
+
+## Set up the wallet
+
+<Steps>
+
+### Start a devnet with Yaci Store
+
+The command depends on how you installed Yaci DevKit.
+
+<Tabs items={['Homebrew / npm', 'Zip', 'Docker']}>
+  <Tabs.Tab>
+```bash
+yaci-devkit up --enable-yaci-store
+```
+  </Tabs.Tab>
+  <Tabs.Tab>
+```bash
+./yaci-cli up --enable-yaci-store
+```
+  </Tabs.Tab>
+  <Tabs.Tab>
+```bash
+devkit start
+```
+
+Then, in the Yaci CLI:
+
+```bash
+yaci-cli:> create-node -o --start
+```
+
+Docker starts Yaci Store by default.
+  </Tabs.Tab>
+</Tabs>
+
+### Install Yano Wallet
+
+On an Apple Silicon Mac:
+
+```bash
+brew install --cask bloxbean/tap/yano-wallet
+```
+
+For Linux, Windows and Intel Macs, download the latest build from the
+[releases page](https://github.com/bloxbean/yano-wallet/releases). The
+[Getting Started guide](https://github.com/bloxbean/yano-wallet/blob/main/GETTING-STARTED.md#1-pick-a-download)
+explains which file to pick.
+
+### Connect to the devnet
+
+On the wallet's **Connect** screen, choose the **Yaci DevKit** network. The wallet switches to an external backend and
+fills in `http://localhost:8080/api/v1`. Change the URL if Yaci Store runs on another port, then click **Start**.
+
+When it is connected, the bottom of the sidebar shows **Yaci DevKit** and **synced · block N**.
+
+### Create a wallet and fund it
+
+Create a new wallet, or restore a test wallet. Copy a receiving address from **Receive**, then top it up from the Yaci
+CLI:
+
+```bash
+topup <address> 1000
+```
+
+You can also use the admin API at `http://localhost:10000`. See [Yaci CLI commands](/commands).
+
+</Steps>
+
+The wallet is now ready to send and receive on the devnet. Before it submits a payment, it shows what will leave your
+wallet:
+
+![Reviewing a payment before it is submitted](/images/yano-wallet/send-review.png)
+
+## Connect a dApp (CIP-30)
+
+To let a browser dApp use Yano Wallet, install the connector extension and the Native Messaging host. Both are one-time
+steps. They work in Chrome, Chromium, Edge and Brave.
+
+<Steps>
+
+### Load the connector extension
+
+The extension is not on the Chrome Web Store yet, so load it unpacked in developer mode:
+
+1. Download `yano-connector-<version>.zip` from the
+   [Yano Wallet releases page](https://github.com/bloxbean/yano-wallet/releases), from the same release as your
+   wallet, and unzip it. You get a folder with `manifest.json` directly inside it.
+2. Open `chrome://extensions` (or `edge://extensions`, `brave://extensions`).
+3. Turn on **Developer mode** (top right).
+4. Click **Load unpacked** and select the unzipped folder.
+
+The extension appears as **Yano Wallet Connector**. Keep the folder where it is: the browser loads an unpacked extension
+from that path every time it starts.
+
+### Install the Native Messaging host
+
+The extension doesn't talk to the wallet over the network. The browser starts a small relay that the wallet installs,
+and the relay passes messages to the wallet over a local socket.
+
+1. In Yano Wallet, open **Settings → Browser connector**.
+2. Click **Install browser connector (Native Messaging)**.
+3. **Quit and restart the browser.** Browsers read this registration only at startup.
+
+Run this step again if you move the wallet, upgrade to a build in a different folder, or switch between the native and
+JVM builds, because the registration points at an exact path on disk.
+
+### Connect from your dApp
+
+With the wallet running and unlocked, open your dApp and choose **Yano** in its wallet list (or call
+`window.cardano.yano.enable()`). The wallet asks you to approve the connection:
+
+![Yano Wallet asking to connect a dApp](/images/yano-wallet/connect-dapp.png)
+
+### Approve transactions
+
+Each transaction the dApp asks to sign opens an approval prompt in the wallet. It shows what leaves your wallet, the
+network fee, the tokens minted or received, and warnings such as "Creates new tokens":
+
+![Approving a dApp transaction that mints an NFT](/images/yano-wallet/approve-mint.png)
+
+Click a transaction hash in the wallet's **History** to open it in [Yaci Viewer](#yaci-viewer-optional):
+
+![The transaction in Yaci Viewer](/images/yano-wallet/viewer-transaction.png)
+
+</Steps>
+
+<Callout type="info">
+Every Cardano test network reports CIP-30 `networkId` 0, so a dApp can't tell a devnet from Preprod by the network
+id alone. Make sure your dApp and the wallet point at the same devnet.
+</Callout>
+
+## Yaci Viewer (optional)
+
+The wallet doesn't need Yaci Viewer. It only opens Yaci Viewer when you click a transaction hash.
+
+- **Docker:** Yaci Viewer is included at `http://localhost:5173`.
+- **Homebrew, npm and Zip:** install it separately with npm, and start it on port 5173 while the devnet is
+  running. The npm package listens on port 3000 unless you set `PORT`, and the wallet's links expect 5173.
+
+  ```bash
+  npm install -g @bloxbean/yaci-viewer
+  PORT=5173 yaci-viewer
+  ```
+
+  See [Install Yaci Viewer](/getting-started/npm#step-2-install-yaci-viewer-optional).
+
+## Yano Wallet or the built-in CIP-30 wallet?
+
+Yaci DevKit also ships a [CIP-30 wallet](/cip30-wallet) at `http://localhost:10000/wallet`. Use it for automated tests
+and quick checks: it needs no install and uses the devnet's pre-funded accounts. Use Yano Wallet when you want to test
+with a real wallet and the approval flow your users will see.
+
+## Troubleshooting
+
+- **The wallet can't connect to the devnet.** Check that Yaci Store answers at
+  `http://localhost:8080/api/v1/blocks/latest`.
+- **The dApp doesn't list Yano.** Check that **Yano Wallet Connector** is enabled at `chrome://extensions`, then reload
+  the dApp page.
+- **"Yano wallet is not reachable — is it running and unlocked?"** Unlock the wallet. If it is unlocked, run
+  **Install browser connector (Native Messaging)** again and restart the browser.
+- **Balances look wrong after resetting the devnet.** A reset starts a new chain. Top up the address again.
+
+More help is in the [Yano Wallet Getting Started guide](https://github.com/bloxbean/yano-wallet/blob/main/GETTING-STARTED.md#if-something-goes-wrong).
diff --git a/docs/public/images/yano-wallet/approve-mint.png b/docs/public/images/yano-wallet/approve-mint.png
new file mode 100644
index 00000000..07f0900b
Binary files /dev/null and b/docs/public/images/yano-wallet/approve-mint.png differ
diff --git a/docs/public/images/yano-wallet/connect-dapp.png b/docs/public/images/yano-wallet/connect-dapp.png
new file mode 100644
index 00000000..933a3ad7
Binary files /dev/null and b/docs/public/images/yano-wallet/connect-dapp.png differ
diff --git a/docs/public/images/yano-wallet/dashboard.png b/docs/public/images/yano-wallet/dashboard.png
new file mode 100644
index 00000000..118bc310
Binary files /dev/null and b/docs/public/images/yano-wallet/dashboard.png differ
diff --git a/docs/public/images/yano-wallet/send-review.png b/docs/public/images/yano-wallet/send-review.png
new file mode 100644
index 00000000..29689426
Binary files /dev/null and b/docs/public/images/yano-wallet/send-review.png differ
diff --git a/docs/public/images/yano-wallet/viewer-transaction.png b/docs/public/images/yano-wallet/viewer-transaction.png
new file mode 100644
index 00000000..62411944
Binary files /dev/null and b/docs/public/images/yano-wallet/viewer-transaction.png differ
diff --git a/docs/styles/globals.css b/docs/styles/globals.css
index 7daa8381..f68df811 100644
--- a/docs/styles/globals.css
+++ b/docs/styles/globals.css
@@ -18,3 +18,18 @@ nav a:active {
 body {
   margin: 0;
 }
+
+/* "Preview" tag next to a page title */
+.yw-preview-badge {
+  display: inline-block;
+  margin-left: 0.6rem;
+  padding: 0.2rem 0.55rem;
+  border-radius: 6px;
+  background: linear-gradient(115deg, #e8401c 0%, #f06a1a 100%);
+  color: #fff;
+  font-size: 0.8rem;
+  font-weight: 600;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  vertical-align: middle;
+}