@agent-native/core 0.132.1 → 0.133.0

package/corpus/templates/clips/changelog/2026-07-30-meeting-microphone-transcription-works-reliably-from-the-fir.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-30
+---
+
+Meeting microphone transcription works reliably from the first start.

package/corpus/templates/clips/changelog/2026-07-31-the-agent-native-logo-stays-visible-when-the-sidebar-is-coll.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-31
+---
+
+The Agent Native logo stays visible when the sidebar is collapsed and toggles the sidebar when clicked.

package/corpus/templates/clips/desktop/src/hooks/useMediaDevices.ts

@@ -13,7 +13,7 @@ import {
   isPseudoMediaDeviceId,
   isSelectableAudioInputDevice,
   normalizedMediaDeviceId,
-} from "../lib/media-device-selection";
+} from "../../../shared/media-device-selection";
 import {
   isHardCapturePermissionError,
   MACOS_CAPTURE_PERMISSION_MESSAGE,

package/corpus/templates/clips/desktop/src/lib/media-capture-constraints.ts

@@ -3,7 +3,7 @@ import {
   enumerateAudioInputDevices,
   isLikelyPhoneMicLabel,
   type AudioInputFallback,
-} from "./media-device-selection";
+} from "../../../shared/media-device-selection";
 
 export const VOICE_FOCUSED_AUDIO_CONSTRAINTS: MediaTrackConstraints = {
   echoCancellation: { ideal: true },

package/corpus/templates/clips/desktop/src-tauri/src/native_screen/custom_capture.rs

@@ -2743,6 +2743,19 @@ fn extract_interleaved_stereo(
     Some((out, pts_seconds))
 }
 
+pub(crate) fn extract_mono_audio(
+    sample: &screencapturekit::cm::CMSampleBuffer,
+    label: &str,
+) -> Option<Vec<f32>> {
+    let (interleaved, _) = extract_interleaved_stereo(sample, label)?;
+    Some(
+        interleaved
+            .chunks_exact(2)
+            .map(|channels| (channels[0] + channels[1]) * 0.5)
+            .collect(),
+    )
+}
+
 /// Record whether decoded source PCM contains a real signal before it reaches
 /// the timeline mixer. This distinguishes capture/format failures from mixer
 /// or writer failures without persisting any audio content.

package/corpus/templates/clips/desktop/src-tauri/src/native_screen.rs

@@ -128,6 +128,8 @@ const NATIVE_CAPTURE_FPS: u32 = 24;
 #[cfg(target_os = "macos")]
 mod custom_capture;
 #[cfg(target_os = "macos")]
+pub(crate) use custom_capture::extract_mono_audio;
+#[cfg(target_os = "macos")]
 use custom_capture::{
     prepare_clip_sink, start_custom_screencapturekit_backend_at, ClosedSegmentFile,
     CustomCaptureResume, CustomScreenCaptureWriter, PreparedClipSink, SegmentFence,

package/corpus/templates/clips/desktop/src-tauri/src/system_audio.rs

@@ -11,8 +11,8 @@
 //! renderer's `LiveTranscript` tagged `source: "system"`.
 //!
 //! Uses the safe `screencapturekit` Rust crate. Its `SCStreamOutputTrait`
-//! callback hands us a `CMSampleBuffer` per audio frame; SCK delivers stereo
-//! 48 kHz float, which we mono-mix on the way out.
+//! callback hands us a `CMSampleBuffer` per audio frame; each source is decoded
+//! from its advertised format, normalized to 48 kHz, and mono-mixed.
 //!
 //! ## Tauri commands
 //!
@@ -163,9 +163,6 @@ pub(crate) mod macos {
     use std::sync::Arc;
     use std::time::Duration;
 
-    use objc2::rc::Retained;
-    use objc2::AnyThread;
-    use objc2_avf_audio::{AVAudioFormat, AVAudioPCMBuffer};
     use objc2_foundation::NSProcessInfo;
     use serde::Serialize;
     use tauri::{AppHandle, Emitter};
@@ -260,7 +257,6 @@ pub(crate) mod macos {
     // ----------------------------------------------------------------------
     struct RawAudioForwarder {
         on_samples: Arc<dyn Fn(&[f32]) + Send + Sync>,
-        speech_format: Retained<AVAudioFormat>,
         app: AppHandle,
         cancelled: Arc<AtomicBool>,
         level_tick: Arc<AtomicU32>,
@@ -268,10 +264,8 @@ pub(crate) mod macos {
         source: &'static str,
     }
 
-    // SAFETY: `Retained<SFSpeech*>` and `Retained<AVAudioFormat>` wrap
-    // refcounted ObjC objects that Apple documents as message-thread-safe.
-    // SCK calls our handler from its own dispatch queue; we never alias
-    // these via `&` across threads.
+    // SAFETY: SCK calls this handler from its dispatch queue; all shared
+    // fields are immutable handles or atomics.
     unsafe impl Send for RawAudioForwarder {}
     unsafe impl Sync for RawAudioForwarder {}
 
@@ -287,30 +281,30 @@ pub(crate) mod macos {
             if self.cancelled.load(Ordering::SeqCst) {
                 return;
             }
-            let Some(buf) = build_pcm_buffer_from_sample(&sample_buffer, &self.speech_format)
+            let Some(samples) =
+                crate::native_screen::extract_mono_audio(&sample_buffer, self.source)
             else {
                 return;
             };
-            // Hand channel 0 (mono mix) to the callback continuously — no level
-            // gate, so the Whisper buffer stays a contiguous stream.
-            let frames = unsafe { buf.frameLength() } as usize;
-            if frames > 0 {
-                let ch_ptr = unsafe { buf.floatChannelData() };
-                if !ch_ptr.is_null() {
-                    let slice = unsafe { std::slice::from_raw_parts((*ch_ptr).as_ptr(), frames) };
-                    (self.on_samples)(slice);
-                }
-                let n = self.level_tick.fetch_add(1, Ordering::Relaxed);
-                if n % 3 == 0 {
-                    let level = crate::native_speech::macos::peak_level_for_pcm(&buf);
-                    let _ = self.app.emit(
-                        "voice:audio-level",
-                        AudioLevelPayload {
-                            level,
-                            source: self.source,
-                        },
-                    );
-                }
+            if samples.is_empty() {
+                return;
+            }
+            (self.on_samples)(&samples);
+            let n = self.level_tick.fetch_add(1, Ordering::Relaxed);
+            if n % 3 == 0 {
+                let level = samples
+                    .iter()
+                    .copied()
+                    .map(f32::abs)
+                    .fold(0.0_f32, f32::max)
+                    .min(1.0);
+                let _ = self.app.emit(
+                    "voice:audio-level",
+                    AudioLevelPayload {
+                        level,
+                        source: self.source,
+                    },
+                );
             }
         }
     }
@@ -448,19 +442,11 @@ pub(crate) mod macos {
             );
         }
 
-        // Mono float32 @ 48 kHz destination format for the mono-mix.
-        let speech_format = unsafe {
-            let allocated = AVAudioFormat::alloc();
-            AVAudioFormat::initStandardFormatWithSampleRate_channels(allocated, 48000.0, 1)
-        }
-        .ok_or_else(|| "AVAudioFormat init failed for raw system capture".to_string())?;
-
         let cancelled = Arc::new(AtomicBool::new(false));
         let mut stream = SCStream::new(&filter, &config);
         if let Some(on_samples) = on_system_samples {
             let forwarder = RawAudioForwarder {
                 on_samples,
-                speech_format: speech_format.clone(),
                 app: app.clone(),
                 cancelled: cancelled.clone(),
                 level_tick: Arc::new(AtomicU32::new(0)),
@@ -472,7 +458,6 @@ pub(crate) mod macos {
         if let Some(on_samples) = on_mic_samples {
             let forwarder = RawAudioForwarder {
                 on_samples,
-                speech_format,
                 app: app.clone(),
                 cancelled: cancelled.clone(),
                 level_tick: Arc::new(AtomicU32::new(0)),
@@ -495,96 +480,4 @@ pub(crate) mod macos {
         level: f32,
         source: &'static str,
     }
-
-    /// Pull the PCM bytes out of a SCK CMSampleBuffer and copy them into a
-    /// freshly-allocated AVAudioPCMBuffer matching `speech_format`
-    /// (single-channel float32 at the SCK sample rate). SCK delivers stereo
-    /// non-interleaved float32 by default — we mono-mix by averaging the
-    /// two channels. Returns `None` if the sample buffer's audio layout
-    /// can't be interpreted (rare; only happens if SCK changes its output
-    /// shape mid-stream).
-    fn build_pcm_buffer_from_sample(
-        sample: &CMSampleBuffer,
-        speech_format: &AVAudioFormat,
-    ) -> Option<Retained<AVAudioPCMBuffer>> {
-        let num_samples = sample.num_samples();
-        if num_samples == 0 {
-            return None;
-        }
-        let abl = sample.audio_buffer_list()?;
-        let n_buffers = abl.num_buffers();
-        if n_buffers == 0 {
-            return None;
-        }
-
-        // Allocate the destination buffer.
-        // SAFETY: standard AVAudioPCMBuffer init; we control the format and
-        // capacity.
-        #[allow(clippy::cast_possible_truncation)]
-        let frame_capacity = num_samples as u32;
-        let allocated = AVAudioPCMBuffer::alloc();
-        let dest = unsafe {
-            AVAudioPCMBuffer::initWithPCMFormat_frameCapacity(
-                allocated,
-                speech_format,
-                frame_capacity,
-            )
-        }?;
-        unsafe { dest.setFrameLength(frame_capacity) };
-
-        // SAFETY: the format is the one we constructed below — float, mono,
-        // non-interleaved — so `floatChannelData` is non-null and points at
-        // `channelCount=1` pointers, each to `frame_capacity` floats.
-        let dest_ch_ptr = unsafe { dest.floatChannelData() };
-        if dest_ch_ptr.is_null() {
-            return None;
-        }
-        let dest_slice =
-            unsafe { std::slice::from_raw_parts_mut((*dest_ch_ptr).as_ptr(), num_samples) };
-
-        if n_buffers >= 2 {
-            // Stereo non-interleaved — average the two channels.
-            let l = abl.get(0)?;
-            let r = abl.get(1)?;
-            let l_bytes = l.data();
-            let r_bytes = r.data();
-            // Treat as f32 little-endian (host byte order on every Apple
-            // platform we ship).
-            let l_floats = bytes_as_f32(l_bytes);
-            let r_floats = bytes_as_f32(r_bytes);
-            let n = num_samples.min(l_floats.len()).min(r_floats.len());
-            for i in 0..n {
-                dest_slice[i] = 0.5 * (l_floats[i] + r_floats[i]);
-            }
-            for v in dest_slice.iter_mut().take(num_samples).skip(n) {
-                *v = 0.0;
-            }
-        } else {
-            // Mono — just copy.
-            let only = abl.get(0)?;
-            let src = bytes_as_f32(only.data());
-            let n = num_samples.min(src.len());
-            dest_slice[..n].copy_from_slice(&src[..n]);
-            for v in dest_slice.iter_mut().take(num_samples).skip(n) {
-                *v = 0.0;
-            }
-        }
-
-        Some(dest)
-    }
-
-    /// Reinterpret a `&[u8]` as `&[f32]`. Length is rounded down to the
-    /// nearest multiple of 4. Safe because `f32` has no invalid
-    /// bit-patterns and the caller only uses the elements they're
-    /// indexing into.
-    fn bytes_as_f32(b: &[u8]) -> &[f32] {
-        let n = b.len() / 4;
-        if n == 0 {
-            return &[];
-        }
-        // SAFETY: `f32` is plain old data with alignment 4; CoreAudio's
-        // AudioBuffer pointers are 16-byte aligned in practice. We cap the
-        // length at `n` so we never read past the end.
-        unsafe { std::slice::from_raw_parts(b.as_ptr().cast::<f32>(), n) }
-    }
 }

package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx

@@ -1617,6 +1617,38 @@ export function DocumentSidebar({
       className={collapsed ? "size-8" : "h-8 min-w-0"}
     />
   );
+  const brandButton = (isCollapsed: boolean) => (
+    <button
+      type="button"
+      onClick={onToggleCollapsed}
+      aria-label={isCollapsed ? t("sidebar.expand") : t("sidebar.collapse")}
+      className={cn(
+        "flex items-center gap-2 rounded outline-none text-foreground transition-colors hover:bg-accent/50 focus-visible:ring-2 focus-visible:ring-ring",
+        isCollapsed ? "size-8 justify-center" : "min-w-0 text-start",
+      )}
+      data-sidebar-brand-toggle
+    >
+      <img
+        src={appPath("/agent-native-icon-light.svg")}
+        alt=""
+        aria-hidden="true"
+        width={28}
+        height={16}
+        className="block h-4 w-7 shrink-0 object-contain object-center dark:hidden"
+      />
+      <img
+        src={appPath("/agent-native-icon-dark.svg")}
+        alt=""
+        aria-hidden="true"
+        width={28}
+        height={16}
+        className="hidden h-4 w-7 shrink-0 object-contain object-center dark:block"
+      />
+      {!isCollapsed && (
+        <span className="text-base font-semibold tracking-tight">Content</span>
+      )}
+    </button>
+  );
 
   const toggleSection = (id: SidebarSectionId) => {
     setStoredCollapsedSections((current) => {
@@ -2118,6 +2150,7 @@ export function DocumentSidebar({
   if (collapsed) {
     return (
       <div className="agent-layout-left-drawer flex h-full w-12 flex-col items-center gap-1 border-e border-border bg-sidebar py-3 transition-[width] duration-200 ease-out">
+        {brandButton(true)}
         {renderCollapsedNewButton()}
         <Tooltip>
           <TooltipTrigger asChild>
@@ -2156,23 +2189,7 @@ export function DocumentSidebar({
     >
       {/* Header */}
       <div className="flex h-12 shrink-0 items-center justify-between border-b border-border px-3">
-        <div className="flex items-center gap-2 min-w-0">
-          <img
-            src={appPath("/agent-native-icon-light.svg")}
-            alt=""
-            aria-hidden="true"
-            className="block h-4 w-auto shrink-0 dark:hidden"
-          />
-          <img
-            src={appPath("/agent-native-icon-dark.svg")}
-            alt=""
-            aria-hidden="true"
-            className="hidden h-4 w-auto shrink-0 dark:block"
-          />
-          <span className="text-base font-semibold tracking-tight text-foreground">
-            Content
-          </span>
-        </div>
+        {brandButton(false)}
       </div>
 
       {/* Search */}

package/corpus/templates/content/changelog/2026-07-31-the-agent-native-logo-stays-visible-when-the-sidebar-is-coll.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-31
+---
+
+The Agent Native logo stays visible when the sidebar is collapsed and toggles the sidebar when clicked.

package/corpus/templates/design/.agents/skills/design-systems/SKILL.md

@@ -30,6 +30,7 @@ Design systems are stored in the `design_systems` SQL table. Each has:
 - `is_default` — boolean, whether this is the user's default design system
 - `owner_email` — auto-set from session
 - `org_id` — organization scope
+- `visibility` — defaults to `org` inside an organization, otherwise `private`
 
 ### DesignSystemData Schema
 
@@ -125,7 +126,9 @@ brand's actual extracted fonts) rather than defaulting to Space Grotesk/DM
 Sans every time; that pairing is this skill's own most common convergence
 fingerprint.
 
-If this is the user's first design system, it is automatically set as the default.
+If this is the user's first design system in the active organization, it is
+automatically set as the default. Organization-scoped systems are shared with
+that organization by default.
 
 ### Starting from an established public system
 
@@ -175,7 +178,8 @@ Only provided fields are updated. You can also update `--title`, `--description`
 pnpm action set-default-design-system --id <id>
 ```
 
-Unsets any previously-default design system for this user.
+Pass `--isDefault false` to clear the current default. Setting a system as the
+default unsets the previous default in the same user and organization scope.
 
 ## Multi-Source Import Flow
 

package/corpus/templates/design/.generated/bridge/editor-chrome.generated.ts

@@ -3808,7 +3808,12 @@ export const editorChromeBridgeScript: string = `"use strict";
         'input, textarea, select, [contenteditable], [role="textbox"], [data-agent-native-text-editing]'
       );
     }
+    function isShowShortcutsChord(e) {
+      if (!(e.metaKey || e.ctrlKey) || !e.shiftKey || e.altKey) return false;
+      return e.key === "?" || e.key === "/";
+    }
     function shouldForwardDesignHotkey(e) {
+      if (isShowShortcutsChord(e)) return true;
       if (readOnly) return false;
       if (activeTextEditEl || isEditorTypingTarget(e.target) || e.isComposing)
         return false;

package/corpus/templates/design/actions/create-design-system.ts

@@ -166,6 +166,7 @@ export default defineAction({
       isDefault,
       ownerEmail,
       orgId,
+      visibility: orgId ? "org" : "private",
       createdAt: now,
       updatedAt: now,
     });

package/corpus/templates/design/actions/set-default-design-system.ts

@@ -11,11 +11,16 @@ import { getDb, schema } from "../server/db/index.js";
 
 export default defineAction({
   description:
-    "Set a design system as the default. Unsets any previously-default design system for this user.",
+    "Set or unset a design system as the default for the current user and organization.",
   schema: z.object({
     id: z.string().describe("Design system ID to set as default"),
+    isDefault: z
+      .boolean()
+      .optional()
+      .default(true)
+      .describe("Whether this design system should be the default"),
   }),
-  run: async ({ id }) => {
+  run: async ({ id, isDefault = true }) => {
     await assertAccess("design-system", id, "editor");
 
     const db = getDb();
@@ -26,42 +31,45 @@ export default defineAction({
     const orgId = getRequestOrgId();
 
     const [target] = await db
-      .select({ ownerEmail: schema.designSystems.ownerEmail })
+      .select({
+        ownerEmail: schema.designSystems.ownerEmail,
+        orgId: schema.designSystems.orgId,
+      })
       .from(schema.designSystems)
       .where(eq(schema.designSystems.id, id))
       .limit(1);
 
-    if (target?.ownerEmail !== userEmail) {
+    if (
+      target?.ownerEmail !== userEmail ||
+      (target.orgId ?? null) !== (orgId ?? null)
+    ) {
       throw new Error("Only the owner can set a design system as default");
     }
 
     await db.transaction(async (tx) => {
-      await tx
-        .update(schema.designSystems)
-        .set({ isDefault: false, updatedAt: now })
-        .where(
-          orgId
-            ? and(
-                eq(schema.designSystems.ownerEmail, userEmail),
-                eq(schema.designSystems.orgId, orgId),
-              )
-            : and(
-                eq(schema.designSystems.ownerEmail, userEmail),
-                isNull(schema.designSystems.orgId),
-              ),
-        );
+      const targetScope = orgId
+        ? and(
+            eq(schema.designSystems.ownerEmail, userEmail),
+            eq(schema.designSystems.orgId, orgId),
+          )
+        : and(
+            eq(schema.designSystems.ownerEmail, userEmail),
+            isNull(schema.designSystems.orgId),
+          );
+
+      if (isDefault) {
+        await tx
+          .update(schema.designSystems)
+          .set({ isDefault: false, updatedAt: now })
+          .where(targetScope);
+      }
 
       await tx
         .update(schema.designSystems)
-        .set({ isDefault: true, updatedAt: now })
-        .where(
-          and(
-            eq(schema.designSystems.id, id),
-            eq(schema.designSystems.ownerEmail, userEmail),
-          ),
-        );
+        .set({ isDefault, updatedAt: now })
+        .where(and(eq(schema.designSystems.id, id), targetScope));
     });
 
-    return { id, isDefault: true };
+    return { id, isDefault };
   },
 });

package/corpus/templates/design/app/components/design/KeyboardShortcutsPanel.tsx

@@ -25,6 +25,7 @@ import {
 } from "@/components/design/keyboard-shortcuts";
 import { Button } from "@/components/ui/button";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
+import { isApplePlatform } from "@/hooks/useDesignHotkeys";
 
 interface KeyboardShortcutsPanelProps {
   onClose: () => void;
@@ -113,9 +114,10 @@ function KeycapGroup({
 
 function ShortcutBindings({ bindings }: { bindings: readonly string[] }) {
   const t = useT();
-  const applePlatform =
-    typeof navigator !== "undefined" &&
-    /Mac|iPhone|iPad/.test(navigator.platform);
+  // Shared with the hotkey matcher: navigator.platform alone is deprecated and
+  // blank in some browsers, which labelled Ctrl on Macs that the hotkey layer
+  // already treated as Apple.
+  const applePlatform = isApplePlatform();
   const accessibleBindings = bindings.map((binding) =>
     binding
       .split("+")

package/corpus/templates/design/app/components/design/bridge/editor-chrome.bridge.ts

@@ -5101,7 +5101,23 @@ declare var __SELECTED_LAYER_DRAG_PRIORITY__: boolean;
     );
   }
 
+  function isShowShortcutsChord(e) {
+    if (!(e.metaKey || e.ctrlKey) || !e.shiftKey || e.altKey) return false;
+    // macOS delivers Control+Shift+/ as "/" — Control suppresses the shifted
+    // character — while Windows sends "?". Match both; see
+    // isShowKeyboardShortcutsHotkey in useDesignHotkeys.ts.
+    return e.key === "?" || e.key === "/";
+  }
+
   function shouldForwardDesignHotkey(e) {
+    // Shortcut help is not an editing affordance, so it forwards ahead of the
+    // read-only and typing guards below — the host matcher is deliberately
+    // global for the same reason. Without this the chord never escapes the
+    // canvas iframe, which is where focus lands the moment you click a frame.
+    // Not reached during a live text-edit session: that block returns before
+    // this function runs, deliberately — see the activeTextEditEl guard in
+    // the keydown listener.
+    if (isShowShortcutsChord(e)) return true;
     // Read-only surfaces (e.g. background/inactive board screens) must never
     // forward edit hotkeys or preventDefault() native browser shortcuts —
     // Escape/Enter/Tab/Delete/arrow-key/undo-redo forwarding is an editing
@@ -11092,6 +11108,13 @@ declare var __SELECTED_LAYER_DRAG_PRIORITY__: boolean;
         }
         // While a live session exists, never forward hotkeys to the host
         // (matches shouldForwardDesignHotkey's activeTextEditEl guard).
+        // The shortcut-help chord is deliberately included in that exclusion:
+        // the panel lives in the parent document, so opening it moves focus
+        // out of the iframe, blurs the editable and commits the in-progress
+        // edit. Ending someone's text entry to show help is a worse trade
+        // than help being unavailable for the duration of a typing session;
+        // it stays available everywhere else, including while a text layer is
+        // merely selected.
         return;
       }
       if (!shouldForwardDesignHotkey(e)) return;

package/corpus/templates/design/app/components/design/keyboard-shortcuts.ts

@@ -49,6 +49,9 @@ export const DESIGN_SHORTCUTS: readonly DesignShortcutDefinition[] = [
   shortcut({
     id: "show-shortcuts",
     category: "essential",
+    // Literal ctrl, not $mod: on macOS ⌘⇧? is the system Help-menu shortcut and
+    // the browser consumes it before the page sees it, so ⌃⇧? is the only
+    // pressable binding there. Do not "fix" this to $mod.
     bindings: ["ctrl+shift+?"],
     labelKey: "designEditor.keyboardShortcuts.commands.showShortcuts",
     handler: "onShowKeyboardShortcuts",

package/corpus/templates/design/app/components/layout/Sidebar.tsx

@@ -124,25 +124,42 @@ export function Sidebar() {
           collapsed ? "justify-center px-2" : "justify-between px-4",
         )}
       >
-        <div className="flex items-center gap-2">
+        <button
+          type="button"
+          onClick={() => setCollapsed((value) => !value)}
+          aria-label={
+            collapsed
+              ? t("navigation.expandSidebar")
+              : t("navigation.collapseSidebar")
+          }
+          className={cn(
+            "flex items-center gap-2 rounded outline-none focus-visible:ring-2 focus-visible:ring-ring",
+            collapsed ? "size-8 justify-center" : "text-start",
+          )}
+          data-sidebar-brand-toggle
+        >
           <img
             src={appPath("/agent-native-icon-light.svg")}
             alt=""
             aria-hidden="true"
-            className="block h-4 w-auto dark:hidden"
+            width={28}
+            height={16}
+            className="block h-4 w-7 shrink-0 object-contain object-center dark:hidden"
           />
           <img
             src={appPath("/agent-native-icon-dark.svg")}
             alt=""
             aria-hidden="true"
-            className="hidden h-4 w-auto dark:block"
+            width={28}
+            height={16}
+            className="hidden h-4 w-7 shrink-0 object-contain object-center dark:block"
           />
           {!collapsed && (
             <span className="text-sm font-semibold tracking-tight">
               {t("navigation.brand")}
             </span>
           )}
-        </div>
+        </button>
       </div>
 
       <div className="flex min-h-0 flex-1 flex-col overflow-y-auto">

package/corpus/templates/design/app/hooks/useDesignHotkeys.ts

@@ -278,12 +278,16 @@ export function isDesignHotkeyEditableTarget(target: EventTarget | null) {
 }
 
 export function isShowKeyboardShortcutsHotkey(event: KeyboardEvent) {
-  return (
-    (event.ctrlKey || event.metaKey) &&
-    event.shiftKey &&
-    !event.altKey &&
-    normalizedKey(event) === "?"
-  );
+  if (!(event.ctrlKey || event.metaKey) || !event.shiftKey || event.altKey) {
+    return false;
+  }
+  // macOS never sends "?" for this chord: holding Control suppresses the
+  // shifted character, so Control+Shift+/ arrives as key "/" while Windows
+  // sends "?". Matching only "?" left Macs with no pressable combination —
+  // the obvious ⌘⇧? alternative is the system Help-menu shortcut and the
+  // browser consumes it before the page ever sees it.
+  const key = normalizedKey(event);
+  return key === "?" || key === "/";
 }
 
 function isFocusableChromeTarget(target: EventTarget | null) {
@@ -779,7 +783,7 @@ const ALT_CODE_KEYS: Record<string, string> = {
   BracketLeft: "[",
 };
 
-function isApplePlatform() {
+export function isApplePlatform() {
   if (typeof navigator === "undefined") return false;
   const userAgentDataPlatform = (
     navigator as Navigator & {