Skip to content

Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.

fix(sidebar): the rail's hover label paints over the IDE's pane chat, not under it

rubenluetke10-beep258fb1bd9a67
diff --git a/docs/BUGS.md b/docs/BUGS.md
index 2aad109df8..f506e5d301 100644
--- a/docs/BUGS.md
+++ b/docs/BUGS.md
@@ -13738,3 +13738,32 @@ none of them. Memory that stands in for a computation must record WHEN it was
computed, or a fact that arrives later loses to a stale one. And the durable
source was on disk the whole time: the CLI's own transcript names every
session, restart or not.
+
+## BUG-195: the collapsed sidebar's hover label is cut to "Lo" at the rail's edge in the Agentic IDE — the pane chat's `z-20` tied with the nav column's `z-20` and won on DOM order (LOW, FIXED 2026-08-27)
+
+**Symptom.** With the sidebar collapsed to its icon rail and the Agentic IDE
+open in chat mode, hovering an icon showed the first two letters of its name
+("Lo" for Local models) and nothing past the sidebar's right edge (maintainer
+screenshot 2026-08-27 11:46). Every other section drew the label whole.
+
+**Root cause.** The rail's label was an `absolute` child of the sidebar
+column, which paints at `z-20`. The stage column beside it deliberately
+carries NO stacking context (App.tsx, `overlay-stacking.test.ts`) so a
+section's full-screen overlays can reach the app's dialog levels — which also
+means every z-index a section uses lands in the SAME root context as the
+sidebar's. `PaneChat` covers its pane with `absolute inset-0 z-20`; equal
+z-index, later in the DOM, so it painted over the part of the label that
+reached past the column. Raising the column's z-index would only move the tie
+to the next section overlay (the IDE has `z-30` drag targets and dropdowns).
+
+**Fix.** `DockRail` renders the label through `createPortal` on `<body>`,
+`position: fixed` at the app's tooltip level (`z-[70]`, the same as
+`QuickTooltip`), and offsets its rail-relative `top` by the rail's measured
+viewport position, re-measured whenever the hovered slot changes — the only
+moment the label moves. Regression: `DockRail.test.tsx` ("the label leaves
+the rail's stacking context").
+
+**Lesson.** An open stage column is a two-way door: it lets a section's
+overlays out, and it lets a section's z-indexes in. Anything in the chrome that
+reaches past its own column must not rely on the column's z-index; a portal at
+the tooltip level is the one placement no section can tie with.
diff --git a/jarvis/ui/web/frontend/src/components/layout/DockRail.test.tsx b/jarvis/ui/web/frontend/src/components/layout/DockRail.test.tsx
index 77cea0df47..1927cb0e34 100644
--- a/jarvis/ui/web/frontend/src/components/layout/DockRail.test.tsx
+++ b/jarvis/ui/web/frontend/src/components/layout/DockRail.test.tsx
@@ -98,6 +98,22 @@ describe("DockRail", () => {
);
});
+ test("the label leaves the rail's stacking context — a portal on <body>, fixed to the viewport", () => {
+ // The sidebar column paints at z-20 in the same stacking context as the
+ // section stage, so a section's own z-20 layer (the IDE's pane chat) ties
+ // with it and wins on DOM order: "Local models" was cut to "Lo" at the
+ // rail's edge (report 2026-08-27). The label therefore rides outside the
+ // column entirely, at the tooltip level.
+ renderRail();
+ const rail = screen.getByTestId("dock-rail");
+ moveTo(rail, centreOf(2));
+ const label = screen.getByTestId("dock-label");
+ expect(label.parentElement).toBe(document.body);
+ expect(rail.contains(label)).toBe(false);
+ expect(label.classList).toContain("fixed");
+ expect(label.classList).toContain("z-[70]");
+ });
+
test("hovering does not grow or move an icon — the rail holds its size and place", () => {
// The magnification was taken back by the maintainer (2026-08-18): the
// hovered icon gets its surface and its label, nothing else changes.
diff --git a/jarvis/ui/web/frontend/src/components/layout/DockRail.tsx b/jarvis/ui/web/frontend/src/components/layout/DockRail.tsx
index e611ad669d..c2f34f423c 100644
--- a/jarvis/ui/web/frontend/src/components/layout/DockRail.tsx
+++ b/jarvis/ui/web/frontend/src/components/layout/DockRail.tsx
@@ -1,4 +1,5 @@
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { createPortal } from "react-dom";
import {
AnimatePresence,
motion,
@@ -131,11 +132,36 @@ export function DockRail({ className }: { className?: string }) {
const labelTopSmooth = useSpring(labelTopRaw, GLIDE_SPRING);
const labelTop = reduced ? labelTopRaw : labelTopSmooth;
+ // The label is rendered in a portal on <body>, fixed to the viewport, and
+ // its rail-relative `top` is offset by where the rail sits on screen. The
+ // offset is measured whenever the hovered slot changes — the only moment
+ // the label's own position changes too, so the derived value is never stale
+ // for a label that is moving. The rail itself does not move mid-hover.
+ //
+ // Why a portal: the sidebar column paints at z-20 with no stacking context
+ // around the section stage (App.tsx), so a section's own `z-20` layer — the
+ // IDE's pane chat is one — meets the column's z-20 in the SAME context and
+ // wins on DOM order, covering a label that reaches past the rail's edge.
+ // A higher z-index on the column would only move the tie to the next
+ // section overlay; leaving the column's context entirely settles it, the
+ // same way `QuickTooltip` does.
+ const navRef = useRef<HTMLElement | null>(null);
+ const navTop = useRef(0);
+ const labelLeft = useMotionValue(LABEL_LEFT);
+ const labelViewportTop = useTransform(labelTop, (top: number) => top + navTop.current);
+ const measureOrigin = useCallback(() => {
+ const rect = navRef.current?.getBoundingClientRect();
+ if (!rect) return;
+ navTop.current = rect.top;
+ labelLeft.set(rect.left + LABEL_LEFT);
+ }, [labelLeft]);
+
const setHoveredSlot = useCallback(
(slot: number) => {
const prev = hoveredRef.current;
if (slot === prev) return;
hoveredRef.current = slot;
+ if (slot >= 0) measureOrigin();
hoveredMV.set(slot);
setHovered(slot);
if (slot < 0) return;
@@ -198,6 +224,7 @@ export function DockRail({ className }: { className?: string }) {
return (
<nav
+ ref={navRef}
aria-label={t("deck.sections")}
className={cn("relative z-10 flex min-h-0 w-16 shrink-0 flex-col", className)}
>
@@ -243,37 +270,42 @@ export function DockRail({ className }: { className?: string }) {
</div>
</div>
- {/* The label rides beside the hovered icon, outside the scroller so the
- scroller's clipping cannot cut it off. Decorative: every button
- already carries its name as aria-label. */}
- <AnimatePresence>
- {hoveredItem && (
- <motion.div
- key="label"
- aria-hidden
- data-testid="dock-label"
- initial={{ opacity: 0, x: -6 }}
- animate={{ opacity: 1, x: 0 }}
- exit={{ opacity: 0, x: -4 }}
- transition={reduced ? { duration: 0 } : { duration: 0.12, ease: "easeOut" }}
- style={{ top: labelTop, left: LABEL_LEFT, y: "-50%" }}
- className="pointer-events-none absolute flex items-center gap-1.5 whitespace-nowrap rounded-md border border-border bg-background/95 px-2 py-1 text-xs text-foreground shadow-md backdrop-blur"
- >
- {resolveNavLabel(t, hoveredItem)}
- {hoveredItem.beta && (
- <span className="rounded-full border border-primary/30 bg-primary/10 px-1.5 py-0.5 text-[9px] font-medium uppercase tracking-wide text-primary">
- {t("nav.agentic_ide_beta")}
- </span>
- )}
- {hoveredCount > 0 && (
- <span className="font-mono text-[10px] text-primary">{hoveredCount}</span>
- )}
- {hoveredHint && (
- <span className="max-w-[28ch] truncate text-muted-foreground">— {hoveredHint}</span>
- )}
- </motion.div>
- )}
- </AnimatePresence>
+ {/* The label rides beside the hovered icon. It lives in a portal on
+ <body>, fixed to the viewport, so neither the scroller's clipping nor
+ a section's own z-20 layer (see `measureOrigin`) can cut it off.
+ z-[70] is the app's tooltip level (`QuickTooltip`). Decorative: every
+ button already carries its name as aria-label. */}
+ {createPortal(
+ <AnimatePresence>
+ {hoveredItem && (
+ <motion.div
+ key="label"
+ aria-hidden
+ data-testid="dock-label"
+ initial={{ opacity: 0, x: -6 }}
+ animate={{ opacity: 1, x: 0 }}
+ exit={{ opacity: 0, x: -4 }}
+ transition={reduced ? { duration: 0 } : { duration: 0.12, ease: "easeOut" }}
+ style={{ top: labelViewportTop, left: labelLeft, y: "-50%" }}
+ className="pointer-events-none fixed z-[70] flex items-center gap-1.5 whitespace-nowrap rounded-md border border-border bg-background/95 px-2 py-1 text-xs text-foreground shadow-md backdrop-blur"
+ >
+ {resolveNavLabel(t, hoveredItem)}
+ {hoveredItem.beta && (
+ <span className="rounded-full border border-primary/30 bg-primary/10 px-1.5 py-0.5 text-[9px] font-medium uppercase tracking-wide text-primary">
+ {t("nav.agentic_ide_beta")}
+ </span>
+ )}
+ {hoveredCount > 0 && (
+ <span className="font-mono text-[10px] text-primary">{hoveredCount}</span>
+ )}
+ {hoveredHint && (
+ <span className="max-w-[28ch] truncate text-muted-foreground">— {hoveredHint}</span>
+ )}
+ </motion.div>
+ )}
+ </AnimatePresence>,
+ document.body,
+ )}
</nav>
);
}