From 8afd952c94dfbf51c1e3fa925fde5a3d66112961 Mon Sep 17 00:00:00 2001
From: alpha <alpha5611331@gmail.com>
Date: Mon, 10 Aug 2026 13:30:36 -0500
Subject: [PATCH 1/2] feat(ui): add shadcn accordion component

Needed for collapsible sections in the documentation dialog (#94).
---
 src/renderer/components/ui/accordion.tsx | 62 ++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 src/renderer/components/ui/accordion.tsx

diff --git a/src/renderer/components/ui/accordion.tsx b/src/renderer/components/ui/accordion.tsx
new file mode 100644
index 0000000..9f25bca
--- /dev/null
+++ b/src/renderer/components/ui/accordion.tsx
@@ -0,0 +1,62 @@
+import { ChevronDownIcon } from 'lucide-react';
+import { Accordion as AccordionPrimitive } from 'radix-ui';
+import * as React from 'react';
+
+import { cn } from '@/lib/utils';
+
+function Accordion({ ...props }: React.ComponentProps<typeof AccordionPrimitive.Root>) {
+  return <AccordionPrimitive.Root data-slot="accordion" {...props} />;
+}
+
+function AccordionItem({
+  className,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Item>) {
+  return (
+    <AccordionPrimitive.Item
+      data-slot="accordion-item"
+      className={cn('border-b last:border-b-0', className)}
+      {...props}
+    />
+  );
+}
+
+function AccordionTrigger({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Trigger>) {
+  return (
+    <AccordionPrimitive.Header className="flex">
+      <AccordionPrimitive.Trigger
+        data-slot="accordion-trigger"
+        className={cn(
+          'flex flex-1 items-start justify-between gap-4 rounded-md py-4 text-left text-sm font-medium transition-all outline-none hover:underline focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 [&[data-state=open]>svg]:rotate-180',
+          className
+        )}
+        {...props}
+      >
+        {children}
+        <ChevronDownIcon className="pointer-events-none size-4 shrink-0 translate-y-0.5 text-muted-foreground transition-transform duration-200" />
+      </AccordionPrimitive.Trigger>
+    </AccordionPrimitive.Header>
+  );
+}
+
+function AccordionContent({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof AccordionPrimitive.Content>) {
+  return (
+    <AccordionPrimitive.Content
+      data-slot="accordion-content"
+      className="overflow-hidden text-sm data-[state=closed]:animate-accordion-up data-[state=open]:animate-accordion-down"
+      {...props}
+    >
+      <div className={cn('pt-0 pb-4', className)}>{children}</div>
+    </AccordionPrimitive.Content>
+  );
+}
+
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger };

From f46908f2928877836af9828b8a88cb74a025cf7b Mon Sep 17 00:00:00 2001
From: alpha <alpha5611331@gmail.com>
Date: Mon, 10 Aug 2026 13:32:18 -0500
Subject: [PATCH 2/2] feat(documentation-dialog): collapsible sections for docs
 content

Replaces always-expanded "Lost the window?" and "Hotkeys" blocks with
an accordion so the dialog reads cleaner and scans faster. Hotkeys
stays open by default since it's the most-referenced section.

Closes #94
---
 .../custom/documentation-dialog.tsx           | 95 +++++++++++--------
 1 file changed, 57 insertions(+), 38 deletions(-)

diff --git a/src/renderer/components/custom/documentation-dialog.tsx b/src/renderer/components/custom/documentation-dialog.tsx
index 98dd5bb..1f2e73c 100644
--- a/src/renderer/components/custom/documentation-dialog.tsx
+++ b/src/renderer/components/custom/documentation-dialog.tsx
@@ -1,5 +1,11 @@
 import React, { useEffect, useState } from 'react';
 
+import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+} from '@/components/ui/accordion';
 import { Button } from '@/components/ui/button';
 import {
   Dialog,
@@ -62,45 +68,58 @@ export default function DocumentationDialog({ open, onOpenChange }: Documentatio
           </DialogDescription>
         </DialogHeader>
 
-        <div className="py-2 overflow-auto flex-1">
-          <h3 className="text-sm font-semibold mb-2">Lost the window?</h3>
-          <p className="text-sm text-muted-foreground mb-4">
-            In stealth mode {APP_NAME} leaves the taskbar and the macOS Dock so it is not visible
-            when you share your screen, which also means a minimized window has no button to click.
-            Just launch {APP_NAME} again: it does not start a second copy, it brings this window
-            back. Outside stealth mode the usual taskbar button and Dock icon are there.
-          </p>
+        <div className="overflow-auto flex-1">
+          <Accordion type="multiple" defaultValue={['hotkeys']} className="w-full">
+            <AccordionItem value="lost-window">
+              <AccordionTrigger className="text-sm font-semibold">
+                Lost the window?
+              </AccordionTrigger>
+              <AccordionContent>
+                <p className="text-sm text-muted-foreground">
+                  In stealth mode {APP_NAME} leaves the taskbar and the macOS Dock so it is not
+                  visible when you share your screen, which also means a minimized window has no
+                  button to click. Just launch {APP_NAME} again: it does not start a second copy, it
+                  brings this window back. Outside stealth mode the usual taskbar button and Dock
+                  icon are there.
+                </p>
+              </AccordionContent>
+            </AccordionItem>
 
-          <h3 className="text-sm font-semibold mb-2">Hotkeys</h3>
-          {HOTKEY_GROUPS.map((group) => (
-            <div key={group.label} className="mb-4">
-              <h4 className="text-xs font-medium mb-1">{group.label}</h4>
-              <div className="grid grid-cols-3 gap-2">
-                {group.keys.map((hk) => {
-                  const info = HOTKEYS[hk];
-                  return (
-                    <React.Fragment key={hk}>
-                      <div className="col-span-1">
-                        <div
-                          className={cn(
-                            'px-2 py-1 rounded text-[11px] font-semibold min-w-22.5',
-                            hk === Hotkey.StopAll
-                              ? 'bg-destructive/80 text-primary-foreground'
-                              : hk === Hotkey.ToggleStealth
-                                ? 'bg-primary/80 text-primary-foreground'
-                                : 'bg-muted'
-                          )}
-                        >
-                          {info.combo}
-                        </div>
-                      </div>
-                      <div className="col-span-2 text-sm">{info.description}</div>
-                    </React.Fragment>
-                  );
-                })}
-              </div>
-            </div>
-          ))}
+            <AccordionItem value="hotkeys">
+              <AccordionTrigger className="text-sm font-semibold">Hotkeys</AccordionTrigger>
+              <AccordionContent>
+                {HOTKEY_GROUPS.map((group) => (
+                  <div key={group.label} className="mb-4 last:mb-0">
+                    <h4 className="text-xs font-medium mb-1">{group.label}</h4>
+                    <div className="grid grid-cols-3 gap-2">
+                      {group.keys.map((hk) => {
+                        const info = HOTKEYS[hk];
+                        return (
+                          <React.Fragment key={hk}>
+                            <div className="col-span-1">
+                              <div
+                                className={cn(
+                                  'px-2 py-1 rounded text-[11px] font-semibold min-w-22.5',
+                                  hk === Hotkey.StopAll
+                                    ? 'bg-destructive/80 text-primary-foreground'
+                                    : hk === Hotkey.ToggleStealth
+                                      ? 'bg-primary/80 text-primary-foreground'
+                                      : 'bg-muted'
+                                )}
+                              >
+                                {info.combo}
+                              </div>
+                            </div>
+                            <div className="col-span-2 text-sm">{info.description}</div>
+                          </React.Fragment>
+                        );
+                      })}
+                    </div>
+                  </div>
+                ))}
+              </AccordionContent>
+            </AccordionItem>
+          </Accordion>
         </div>
 
         <DialogFooter>