guide

src/index.css

@@ -1719,3 +1719,70 @@ main {
 
 .qty-input:focus-visible { outline: 2px solid var(--color-brand); outline-offset: 1px; }
 
+
+/* ── Setup: the guidance blocks on a branch user's step ────────────────────
+   A branch user's steps do not collect anything — the work happens on another
+   screen — so what fills the frame is the explanation: why it matters, what
+   they will do there, and what catches people out. Three of the same block,
+   distinguished by tone rather than by three different shapes.
+
+   Built from the tokens already here: brand for the neutral case, the warning
+   ochre for the caveat, success green once a step is finished. No new palette
+   and no card of its own — the frame is already a card, and a card inside a
+   card is how a simple page starts looking busy.                            */
+.ob-guide {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr);
+  gap: 12px;
+  align-items: start;
+  padding: 14px 16px;
+  border: 1px solid var(--color-line);
+  border-radius: 12px;
+  background: var(--color-surface-subtle);
+}
+
+.ob-guide[data-tone='warn'] {
+  border-color: var(--color-warning, #b7860b);
+  background: color-mix(in oklab, var(--color-warning, #b7860b) 7%, transparent);
+}
+
+.ob-guide[data-tone='done'] {
+  border-color: var(--color-success, #1f9d55);
+  background: var(--color-success-tint, #eaf7ef);
+}
+
+.ob-guide-icon {
+  width: 26px;
+  height: 26px;
+  flex: none;
+  border-radius: 999px;
+  display: grid;
+  place-items: center;
+  background: var(--color-brand);
+  color: #fff;
+}
+
+.ob-guide[data-tone='warn'] .ob-guide-icon { background: var(--color-warning, #b7860b); }
+.ob-guide[data-tone='done'] .ob-guide-icon { background: var(--color-success, #1f9d55); }
+
+.ob-guide-list {
+  margin: 2px 0 0;
+  padding-left: 18px;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  font: 400 13.5px/1.6 var(--font-sans);
+  color: var(--color-ink-3);
+}
+
+/* The tick that closes the flow. Same mark the merchant's Done step uses, so
+   both roles finish on the same note. */
+.ob-done-mark {
+  width: 56px;
+  height: 56px;
+  border-radius: 999px;
+  display: grid;
+  place-items: center;
+  background: var(--color-success-tint, #eaf7ef);
+  color: var(--color-success, #1f9d55);
+}