Skip to content

A personal assistant that lives on your desktop, remembers what matters, and can use your Mac for you.

TypeScript

docs(brand): add the Dot, menu bar, and app icon design sheet

Alan Buscaglia9e8cecc97b36
diff --git a/docs/brand/icon-design.html b/docs/brand/icon-design.html
new file mode 100644
index 0000000..ea7842c
--- /dev/null
+++ b/docs/brand/icon-design.html
@@ -0,0 +1,226 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<title>Gentle Dot — Icon design</title>
+<style>
+ :root {
+ --accent: #7c5cff;
+ --accent-hi: #b39dff;
+ --accent-lo: #3f24c4;
+ --amber: #f5a524;
+ --danger: #f0506e;
+ --ok: #3ecf8e;
+ --ink: #ecedef;
+ --muted: #8a8f98;
+ --bg: #0e0f13;
+ font: 14px/20px -apple-system, BlinkMacSystemFont, "SF Pro Text", system-ui, sans-serif;
+ color: var(--ink);
+ -webkit-font-smoothing: antialiased;
+ }
+ * { box-sizing: border-box; }
+ body { margin: 0; background: var(--bg); }
+ .sheet { width: 1200px; margin: 0 auto; padding: 48px 56px 64px; }
+ h1 { font-size: 30px; line-height: 36px; margin: 0 0 6px; letter-spacing: -0.01em; }
+ h2 { font-size: 18px; margin: 48px 0 4px; }
+ .lead, .note { color: var(--muted); margin: 0; }
+ .note { font-size: 12px; line-height: 17px; }
+ .row { display: flex; gap: 20px; align-items: flex-start; margin-top: 22px; flex-wrap: wrap; }
+ .cell { display: flex; flex-direction: column; align-items: center; gap: 10px; min-width: 128px; }
+ .cell > .dot { margin: 6px 0; }
+ .cell b { font-size: 13px; }
+ .cell span { color: var(--muted); font-size: 12px; text-align: center; max-width: 128px; line-height: 16px; }
+
+ /* ---------- The Dot ---------- */
+ .dot { position: relative; width: 56px; height: 56px; border-radius: 50%; flex: none;
+ background: radial-gradient(circle at 34% 28%, var(--accent-hi) 0%, var(--accent) 48%, var(--accent-lo) 100%);
+ box-shadow: 0 10px 24px rgba(60, 30, 200, 0.45), 0 2px 6px rgba(0, 0, 0, 0.35), inset 0 -4px 10px rgba(20, 0, 90, 0.35); }
+ .dot::before { /* glass highlight */
+ content: ""; position: absolute; left: 11px; top: 7px; width: 22px; height: 12px; border-radius: 50%;
+ background: linear-gradient(rgba(255,255,255,0.55), rgba(255,255,255,0)); transform: rotate(-18deg); }
+ .core { position: absolute; inset: 19px; border-radius: 50%; background: #fff;
+ box-shadow: 0 0 12px rgba(255,255,255,0.9); }
+ .ring { position: absolute; inset: -5px; border-radius: 50%; border: 2px solid transparent; }
+ .orbit { position: absolute; inset: 4px; border-radius: 50%; }
+ .orbit::after { content: ""; position: absolute; top: -3px; left: 50%; width: 7px; height: 7px; margin-left: -3.5px;
+ border-radius: 50%; background: #fff; box-shadow: 0 0 8px #fff; }
+ .badge { position: absolute; top: -4px; right: -4px; width: 20px; height: 20px; border-radius: 50%;
+ background: var(--amber); color: #241600; font-weight: 800; font-size: 13px; line-height: 20px; text-align: center;
+ box-shadow: 0 0 0 2px var(--bg); }
+
+ .idle { animation: breathe 3.2s ease-in-out infinite; }
+ .idle .core { animation: core 3.2s ease-in-out infinite; }
+ .thinking .orbit { animation: spin 1.3s linear infinite; }
+ .thinking .core { inset: 21px; }
+ .working { animation: pulse 0.9s ease-in-out infinite; }
+ .working .ring { border-color: rgba(255,255,255,0.35); border-top-color: #fff; animation: spin 0.9s linear infinite; }
+ .needs .ring { border-color: var(--amber); animation: halo 1.6s ease-in-out infinite; }
+ .restarting { filter: grayscale(1) brightness(0.8); }
+ .restarting .ring { border-color: rgba(255,255,255,0.25); border-left-color: rgba(255,255,255,0.9); animation: spin 1.8s linear infinite; }
+ .offline { filter: grayscale(1) brightness(0.65); }
+ .offline .ring { border-color: var(--danger); }
+ .offline .core { background: #c9c9cf; box-shadow: none; }
+ .hover { transform: scale(1.08); }
+ .hover .ring { border-color: rgba(255,255,255,0.5); }
+
+ @keyframes breathe { 50% { box-shadow: 0 10px 24px rgba(60,30,200,0.45), 0 0 0 9px rgba(124,92,255,0.18), inset 0 -4px 10px rgba(20,0,90,0.35); } }
+ @keyframes core { 50% { transform: scale(0.86); } }
+ @keyframes spin { to { transform: rotate(360deg); } }
+ @keyframes pulse { 50% { transform: scale(0.93); } }
+ @keyframes halo { 50% { box-shadow: 0 0 0 6px rgba(245,165,36,0.25); } }
+
+ /* ---------- Desktop scene ---------- */
+ .desk { position: relative; height: 420px; margin-top: 22px; border-radius: 18px; overflow: hidden;
+ background: radial-gradient(1200px 500px at 20% 0%, #3b2f7a 0%, transparent 60%),
+ radial-gradient(900px 500px at 100% 100%, #0f5a6e 0%, transparent 55%), #15161c; }
+ .menubar { height: 28px; display: flex; align-items: center; justify-content: space-between; padding: 0 14px;
+ background: rgba(30,30,36,0.55); backdrop-filter: blur(20px); font-size: 13px; }
+ .menubar .left b { margin-right: 18px; }
+ .menubar .left span { margin-right: 16px; color: #dcdce0; }
+ .menubar .right { display: flex; align-items: center; gap: 14px; color: #dcdce0; }
+ .mb-active { background: rgba(255,255,255,0.18); border-radius: 5px; padding: 2px 5px; display: flex; }
+ .window { position: absolute; left: 70px; top: 70px; width: 640px; height: 300px; border-radius: 12px;
+ background: #1e1f26; box-shadow: 0 20px 50px rgba(0,0,0,0.5); border: 1px solid rgba(255,255,255,0.08); }
+ .window .bar { height: 30px; display: flex; gap: 7px; align-items: center; padding-left: 12px; border-bottom: 1px solid rgba(255,255,255,0.06); }
+ .window .bar i { width: 11px; height: 11px; border-radius: 50%; background: #ff5f57; }
+ .window .bar i:nth-child(2) { background: #febc2e; } .window .bar i:nth-child(3) { background: #28c840; }
+ .window .lines { padding: 18px 22px; }
+ .window .lines div { height: 9px; border-radius: 5px; background: rgba(255,255,255,0.07); margin-bottom: 12px; }
+ .desk .dot { position: absolute; right: 12px; top: 186px; }
+ .snapguide { position: absolute; right: 12px; top: 40px; bottom: 12px; width: 56px; border-radius: 28px;
+ border: 1px dashed rgba(255,255,255,0.18); }
+ .desk .dot.ghost { right: 200px; top: 250px; opacity: 0.4; }
+ .arrow { position: absolute; right: 86px; top: 222px; width: 112px; border-top: 2px dashed rgba(255,255,255,0.35); transform: rotate(-17deg); }
+ .label { position: absolute; font-size: 12px; color: #cfd0d6; background: rgba(0,0,0,0.35); padding: 4px 8px; border-radius: 6px; }
+
+ .panel-scene { position: relative; width: 520px; height: 420px; border-radius: 18px; overflow: hidden;
+ background: radial-gradient(800px 400px at 0% 0%, #3b2f7a 0%, transparent 60%), #15161c; }
+ .panel { position: absolute; right: 84px; top: 20px; width: 300px; height: 380px; border-radius: 20px;
+ background: rgba(28,30,38,0.78); border: 1px solid rgba(255,255,255,0.1); backdrop-filter: blur(20px);
+ box-shadow: 0 24px 60px rgba(0,0,0,0.5); padding: 14px; }
+ .panel header { display: flex; align-items: center; gap: 8px; font-weight: 600; font-size: 13px; padding-bottom: 10px; border-bottom: 1px solid rgba(255,255,255,0.08); }
+ .panel header i { width: 8px; height: 8px; border-radius: 50%; background: var(--accent); }
+ .bubble { margin: 12px 0 0 auto; width: fit-content; max-width: 80%; background: var(--accent); padding: 7px 11px; border-radius: 14px 14px 4px 14px; font-size: 13px; }
+ .reply { margin-top: 10px; font-size: 13px; color: #dfe0e4; }
+ .chip { display: inline-block; margin-top: 10px; font-size: 11px; color: var(--muted); border: 1px solid rgba(255,255,255,0.12); border-radius: 999px; padding: 2px 9px; }
+ .composer { position: absolute; left: 14px; right: 14px; bottom: 14px; height: 40px; border-radius: 14px; background: rgba(255,255,255,0.06); border: 1px solid rgba(255,255,255,0.08); color: var(--muted); font-size: 12px; padding: 11px 12px; }
+ .panel-scene .dot { position: absolute; right: 14px; top: 182px; }
+ .tail { position: absolute; right: 74px; top: 204px; width: 12px; height: 12px; background: rgba(28,30,38,0.78); transform: rotate(45deg); border-right: 1px solid rgba(255,255,255,0.1); border-top: 1px solid rgba(255,255,255,0.1); }
+
+ /* ---------- App icon ---------- */
+ .appicon { width: 180px; height: 180px; border-radius: 40px; position: relative; flex: none;
+ background: radial-gradient(120% 100% at 30% 0%, #2a2350 0%, #12121a 70%);
+ box-shadow: 0 18px 40px rgba(0,0,0,0.55), inset 0 1px 0 rgba(255,255,255,0.12), inset 0 0 0 1px rgba(255,255,255,0.05); }
+ .appicon .dot { position: absolute; left: 40px; top: 40px; width: 100px; height: 100px;
+ box-shadow: 0 0 60px rgba(124,92,255,0.7), 0 14px 30px rgba(20,0,90,0.6), inset 0 -8px 18px rgba(20,0,90,0.35); }
+ .appicon .dot::before { left: 20px; top: 12px; width: 40px; height: 22px; }
+ .appicon .core { inset: 34px; box-shadow: 0 0 24px #fff; }
+ .appicon .orbitline { position: absolute; inset: 22px; border-radius: 50%; border: 1.5px solid rgba(179,157,255,0.35); }
+ .appicon .orbitline::after { content: ""; position: absolute; right: 10px; top: 16px; width: 10px; height: 10px; border-radius: 50%; background: #fff; box-shadow: 0 0 10px #fff; }
+ .small .appicon { width: 64px; height: 64px; border-radius: 15px; }
+ .small .appicon .dot { left: 14px; top: 14px; width: 36px; height: 36px; }
+ .small .appicon .dot::before { left: 7px; top: 4px; width: 14px; height: 8px; }
+ .small .appicon .core { inset: 12px; }
+ .small .appicon .orbitline { inset: 8px; }
+ .small .appicon .orbitline::after { right: 3px; top: 6px; width: 5px; height: 5px; }
+
+ /* ---------- Menu bar ---------- */
+ .mbstrip { display: flex; gap: 34px; padding: 14px 22px; border-radius: 12px; background: #e9e9ed; color: #111; margin-top: 22px; width: fit-content; }
+ .mbstrip.dark { background: #2a2a30; color: #eee; }
+ .mbcell { display: flex; flex-direction: column; align-items: center; gap: 8px; font-size: 11px; }
+ .mbcell svg { width: 18px; height: 18px; }
+ .spec { display: grid; grid-template-columns: 220px 1fr; gap: 8px 24px; margin-top: 18px; font-size: 13px; }
+ .spec dt { color: var(--muted); }
+ .spec dd { margin: 0; }
+ .swatch { display: inline-block; width: 12px; height: 12px; border-radius: 3px; vertical-align: -1px; margin-right: 6px; }
+</style>
+</head>
+<body>
+<div class="sheet">
+ <h1>Gentle Dot · icon design</h1>
+ <p class="lead">One shape everywhere: a glass violet orb with a bright core. The core is the assistant’s attention; the ring around it tells you what it is doing.</p>
+
+ <h2>1 · The floating Dot on the desktop</h2>
+ <p class="lead">It floats above every window and on every desktop, 56 × 56 pt. Drag it anywhere: when you let go, it snaps to the nearest edge so it never covers your work. Click it from anywhere to open the panel.</p>
+ <div class="desk">
+ <div class="menubar">
+ <div class="left"><b></b><span>Finder</span><span>File</span><span>Edit</span><span>View</span></div>
+ <div class="right">
+ <span class="mb-active"><svg width="16" height="16" viewBox="0 0 18 18"><circle cx="9" cy="9" r="7.2" fill="none" stroke="#fff" stroke-width="1.6"/><circle cx="9" cy="9" r="3" fill="#fff"/></svg></span>
+ <span>⌥ Space</span><span>Wed 8 Oct 10:42</span>
+ </div>
+ </div>
+ <div class="window"><div class="bar"><i></i><i></i><i></i></div><div class="lines"><div style="width:70%"></div><div style="width:92%"></div><div style="width:54%"></div><div style="width:81%"></div><div style="width:63%"></div><div style="width:88%"></div></div></div>
+ <div class="snapguide"></div>
+ <div class="dot ghost idle"><span class="core"></span></div>
+ <div class="arrow"></div>
+ <div class="dot thinking"><span class="orbit"></span><span class="core"></span></div>
+ <div class="label" style="right: 196px; top: 312px">drag anywhere</div>
+ <div class="label" style="right: 82px; top: 150px">snaps to the edge · 12 pt margin</div>
+ <div class="label" style="left: 86px; top: 386px">Always on top · every Space · no Dock icon</div>
+ </div>
+
+ <h2>2 · States of the Dot</h2>
+ <p class="lead">Motion and color, never text. Every animation stops when “Reduce motion” is on; the state then shows only through the ring color.</p>
+ <div class="row">
+ <div class="cell"><div class="dot idle"><span class="core"></span></div><b>Ready</b><span>slow breathing glow; the core gently pulses</span></div>
+ <div class="cell"><div class="dot hover"><span class="ring"></span><span class="core"></span></div><b>Hover</b><span>grows 8% with a soft ring: “click me”</span></div>
+ <div class="cell"><div class="dot thinking"><span class="orbit"></span><span class="core"></span></div><b>Thinking</b><span>a spark orbits the core</span></div>
+ <div class="cell"><div class="dot working"><span class="ring"></span><span class="core"></span></div><b>Working</b><span>spinning white arc while it reads, edits, or runs</span></div>
+ <div class="cell"><div class="dot needs"><span class="ring"></span><span class="core"></span><span class="badge">!</span></div><b>Needs you</b><span>amber halo and badge until you answer</span></div>
+ <div class="cell"><div class="dot restarting"><span class="ring"></span><span class="core"></span></div><b>Restarting</b><span>grey with a slow arc; comes back by itself</span></div>
+ <div class="cell"><div class="dot offline"><span class="ring"></span><span class="core"></span></div><b>Unavailable</b><span>grey with a red ring; click to see why</span></div>
+ </div>
+
+ <h2>3 · Click: the panel opens next to it</h2>
+ <p class="lead">The panel opens on the side with more room, with a small tail pointing at the Dot. <code>Esc</code> or another click closes it, and the work keeps going.</p>
+ <div class="row" style="align-items: stretch">
+ <div class="panel-scene">
+ <div class="panel">
+ <header><i></i>Trip to Madrid</header>
+ <div class="bubble">Find me flights for Friday</div>
+ <span class="chip">● Looking things up online</span>
+ <div class="reply">On it. I’ll compare three airlines and show you the best two…</div>
+ <div class="composer">Add to what I’m doing…</div>
+ </div>
+ <div class="tail"></div>
+ <div class="dot working"><span class="ring"></span><span class="core"></span></div>
+ </div>
+ <dl class="spec" style="align-content: start">
+ <dt>Dot</dt><dd>56 × 56 pt, transparent window, shadow drawn by the orb itself</dd>
+ <dt>Panel</dt><dd>420 × 640 pt, 20 pt radius, macOS vibrancy</dd>
+ <dt>Open / close</dt><dd>click the Dot · <b>⌥ Space</b> from any app · menu bar → Open</dd>
+ <dt>Move</dt><dd>drag the Dot; it snaps to the closest edge and remembers its place</dd>
+ <dt>Colors</dt><dd><span class="swatch" style="background:#7c5cff"></span>#7C5CFF accent · <span class="swatch" style="background:#b39dff"></span>#B39DFF highlight · <span class="swatch" style="background:#3f24c4"></span>#3F24C4 depth</dd>
+ <dt>State colors</dt><dd><span class="swatch" style="background:#f5a524"></span>needs you · <span class="swatch" style="background:#f0506e"></span>unavailable · <span class="swatch" style="background:#3ecf8e"></span>ready (panel header)</dd>
+ </dl>
+ </div>
+
+ <h2>4 · Menu bar icon</h2>
+ <p class="lead">A monochrome “template” icon, so macOS tints it for light and dark menu bars: a ring with the core inside. The state shows in the shape, not in color.</p>
+ <div class="row" style="gap: 18px">
+ <div class="mbstrip">
+ <div class="mbcell"><svg viewBox="0 0 18 18"><circle cx="9" cy="9" r="7.2" fill="none" stroke="currentColor" stroke-width="1.6"/><circle cx="9" cy="9" r="3" fill="currentColor"/></svg>Ready</div>
+ <div class="mbcell"><svg viewBox="0 0 18 18"><circle cx="9" cy="9" r="7.2" fill="none" stroke="currentColor" stroke-width="1.6" stroke-dasharray="11 3.5"/><circle cx="9" cy="9" r="3" fill="currentColor"/></svg>Working</div>
+ <div class="mbcell"><svg viewBox="0 0 18 18"><circle cx="9" cy="9" r="7.2" fill="none" stroke="currentColor" stroke-width="1.6"/><circle cx="9" cy="9" r="3" fill="currentColor"/><circle cx="14.6" cy="3.4" r="3.2" fill="currentColor" stroke="#e9e9ed" stroke-width="1.4"/></svg>Needs you</div>
+ <div class="mbcell"><svg viewBox="0 0 18 18" opacity="0.45"><circle cx="9" cy="9" r="7.2" fill="none" stroke="currentColor" stroke-width="1.6"/><circle cx="9" cy="9" r="3" fill="currentColor"/></svg>Unavailable</div>
+ </div>
+ <div class="mbstrip dark">
+ <div class="mbcell"><svg viewBox="0 0 18 18"><circle cx="9" cy="9" r="7.2" fill="none" stroke="currentColor" stroke-width="1.6"/><circle cx="9" cy="9" r="3" fill="currentColor"/></svg>Ready</div>
+ <div class="mbcell"><svg viewBox="0 0 18 18"><circle cx="9" cy="9" r="7.2" fill="none" stroke="currentColor" stroke-width="1.6" stroke-dasharray="11 3.5"/><circle cx="9" cy="9" r="3" fill="currentColor"/></svg>Working</div>
+ <div class="mbcell"><svg viewBox="0 0 18 18"><circle cx="9" cy="9" r="7.2" fill="none" stroke="currentColor" stroke-width="1.6"/><circle cx="9" cy="9" r="3" fill="currentColor"/><circle cx="14.6" cy="3.4" r="3.2" fill="currentColor" stroke="#2a2a30" stroke-width="1.4"/></svg>Needs you</div>
+ <div class="mbcell"><svg viewBox="0 0 18 18" opacity="0.45"><circle cx="9" cy="9" r="7.2" fill="none" stroke="currentColor" stroke-width="1.6"/><circle cx="9" cy="9" r="3" fill="currentColor"/></svg>Unavailable</div>
+ </div>
+ </div>
+ <p class="note" style="margin-top: 10px">18 × 18 pt at 1× and 2×, 1.6 pt stroke, exported as PDF/PNG with “template” rendering. Clicking it opens the menu: Open (⌥ Space), New conversation, Open in browser, Restart assistant, Launch at login, Quit.</p>
+
+ <h2>5 · App icon (Dock, Finder, Launchpad, browser tab)</h2>
+ <p class="lead">The same orb on a dark macOS squircle, with a faint orbit and spark that hint at “always around”.</p>
+ <div class="row">
+ <div class="cell"><div class="appicon"><span class="orbitline"></span><div class="dot"><span class="core"></span></div></div><b>1024 pt master</b><span>macOS squircle, dark glass</span></div>
+ <div class="cell small"><div class="appicon"><span class="orbitline"></span><div class="dot"><span class="core"></span></div></div><b>64 pt</b><span>still reads as one orb</span></div>
+ <div class="cell"><div class="dot idle" style="width:32px;height:32px"><span class="core" style="inset:11px"></span></div><b>Favicon</b><span>the orb alone, no squircle</span></div>
+ </div>
+</div>
+</body>
+</html>
diff --git a/docs/brand/icon-design.png b/docs/brand/icon-design.png
new file mode 100644
index 0000000..530b858
Binary files /dev/null and b/docs/brand/icon-design.png differ