docs: update macOS preferences whitelist and add tap package type

Sync documentation with current macos-prefs-catalog.ts (23 → 26
preferences, new categories: Trackpad, Desktop, Keyboard, Menu Bar;
removed: Safari, TextEdit, Time Machine). Add `tap` as a documented
package type across config-options, api-reference, and PresetPackage
type definition.

Author: fullstackjam

src/docs/api-reference.md

@@ -163,7 +163,8 @@ POST /api/configs/from-snapshot
     "packages": {
       "formulae": ["node", "go"],
       "casks": ["visual-studio-code"],
-      "npm": ["typescript"]
+      "npm": ["typescript"],
+      "taps": ["homebrew/cask-fonts"]
     },
     "macos_prefs": [...],
     "shell": {...},

src/docs/config-options.md

@@ -1,6 +1,6 @@
 ---
 title: Config Options
-description: Full config schema — packages, custom scripts, dotfiles repo, visibility, aliases, and the 23 macOS preferences whitelist.
+description: Full config schema — packages, custom scripts, dotfiles repo, visibility, aliases, and the 26 macOS preferences whitelist.
 group: Reference
 order: 10
 ---
@@ -22,7 +22,8 @@ Every OpenBoot config — whether created from a preset, a snapshot, or the dash
     { "name": "ripgrep", "type": "formula" },
     { "name": "visual-studio-code", "type": "cask" },
     { "name": "arc", "type": "cask" },
-    { "name": "typescript", "type": "npm" }
+    { "name": "typescript", "type": "npm" },
+    { "name": "homebrew/cask-fonts", "type": "tap" }
   ],
   "custom_script": "mkdir -p ~/projects\ngit clone git@github.com:yourorg/main-repo.git ~/projects/main-repo",
   "dotfiles_repo": "https://github.com/yourorg/team-dotfiles.git",
@@ -66,8 +67,9 @@ The tools and apps to install. Stored as an array of package objects, each with
 - **`formula`** — CLI tools installed via `brew install`
 - **`cask`** — GUI apps installed via `brew install --cask`
 - **`npm`** — Global npm packages installed via `npm install -g`
+- **`tap`** — Third-party Homebrew repositories added via `brew tap`
 
-Each entry is an object: `{ "name": "package-name", "type": "formula" | "cask" | "npm" }`. Names must match Homebrew or npm package names exactly.
+Each entry is an object: `{ "name": "package-name", "type": "formula" | "cask" | "npm" | "tap" }`. Names must match Homebrew or npm package names exactly. Taps are added before formulae and casks are installed.
 
 ### `custom_script`
 
@@ -128,62 +130,65 @@ You can export any config as a JSON file from the dashboard. Click the **Export*
 
 ## macOS Preferences Whitelist
 
-These are the 23 system settings that OpenBoot can configure. Only these are captured by `openboot snapshot` and applied during install.
+These are the 26 system settings that OpenBoot can configure. Only these are captured by `openboot snapshot` and applied during install. In the dashboard, preferences are grouped into collapsible accordion sections by category.
 
-### Global
+### Dock
 
-| Setting | Description | Default Value |
-|---------|-------------|---------------|
-| Show all file extensions | Files show `.txt`, `.js`, etc. in Finder | on |
-| Always show scrollbars | No auto-hiding scrollbars | on |
-| Disable auto-correct | No automatic text correction | on |
-| Disable auto-capitalization | No automatic capitalization | on |
-| Fast key repeat | Faster character repeat when holding a key | on |
-| Short key repeat delay | Shorter delay before repeat starts | on |
+| Setting | Description | Default |
+|---------|-------------|---------|
+| Auto-hide Dock | Automatically hide and show the Dock | on |
+| Auto-hide delay (s) | Delay before Dock appears on hover — 0 for instant | 0 |
+| Icon size | Dock icon size in pixels | 48 |
+| Show recent apps | Show recently used apps in a separate Dock section | off |
+| Position on screen | Which edge the Dock appears on (bottom, left, right) | bottom |
+| Minimize animation | Visual effect when minimizing windows (genie or scale) | genie |
+| Show only active apps | Hide non-running apps from the Dock | off |
+| Animate app launches | Bounce icons when launching an app | on |
 
 ### Finder
 
-| Setting | Description | Default Value |
-|---------|-------------|---------------|
-| Show path bar | Full path shown at bottom of Finder | on |
-| Show status bar | Item count and disk space at bottom | on |
-| Default to list view | Finder opens in list view | on |
-| No extension change warning | No alert when renaming file extensions | on |
-| Show hidden files | Dotfiles and hidden folders visible | on |
+| Setting | Description | Default |
+|---------|-------------|---------|
+| Default view style | How files display in new windows (icon, list, column, gallery) | list |
+| New window opens | Default location for new Finder windows | Home folder |
+| Default search scope | Where Finder searches by default (This Mac, current folder) | Current folder |
+| Show path bar | Full folder path at bottom of windows | on |
+| Show status bar | Item count and disk space at bottom of windows | on |
+| Show hidden files | Show files and folders starting with a dot | off |
+| Always show file extensions | Show extensions for all files | on |
+| Show full path in title bar | Display POSIX path in window title | off |
 
-### Dock
+### Trackpad
 
-| Setting | Description | Default Value |
-|---------|-------------|---------------|
-| Keep Dock visible | Dock does not auto-hide | on |
-| Hide recent applications | No "recent apps" section in Dock | on |
-| Icon size | Dock icon size in pixels | 48 |
-| Scale minimize effect | Use scale animation instead of genie | on |
+| Setting | Description | Default |
+|---------|-------------|---------|
+| Tap to click | Tap the trackpad to click instead of pressing down | on |
+| Natural scrolling | Scroll content in the direction your fingers move | on |
+| Three-finger drag | Drag windows and items using three fingers | off |
 
-### Screenshots
+### Desktop
 
-| Setting | Description | Default Value |
-|---------|-------------|---------------|
-| Save location | Where screenshots are saved | `~/Screenshots` |
-| PNG format | Save as PNG instead of other formats | on |
-| Disable shadow | No drop shadow on window screenshots | on |
+| Setting | Description | Default |
+|---------|-------------|---------|
+| Click desktop to show it | Click wallpaper to hide all windows | off |
 
-### Safari
+### Keyboard
 
-| Setting | Description | Default Value |
-|---------|-------------|---------------|
-| Developer menu | Show Develop menu in menu bar | on |
-| WebKit developer extras | Enable Web Inspector and other dev tools | on |
+| Setting | Description | Default |
+|---------|-------------|---------|
+| Key repeat rate | How fast keys repeat when held — lower = faster | 2 |
+| Delay until key repeat | How long before a held key starts repeating | 15 |
+| Press and hold for accents | Show accent menu when holding a key (disable for faster repeat) | off |
 
-### TextEdit
+### Screenshots
 
-| Setting | Description | Default Value |
-|---------|-------------|---------------|
-| Plain text mode | Default to plain text, not rich text | on |
-| UTF-8 encoding | Use UTF-8 for plain text files | on |
+| Setting | Description | Default |
+|---------|-------------|---------|
+| Screenshot format | File format for screenshots (PNG, JPEG, PDF, TIFF) | PNG |
+| Disable window shadows | Remove drop shadows from window screenshots | on |
 
-### Time Machine
+### Menu Bar
 
-| Setting | Description | Default Value |
-|---------|-------------|---------------|
-| Don't prompt for new disks | No "use this disk for backup?" popups | on |
+| Setting | Description | Default |
+|---------|-------------|---------|
+| Show Sound in menu bar | Always show volume control in the menu bar | on |

src/docs/dotfiles-shell.md

@@ -78,33 +78,19 @@ OpenBoot applies a curated set of developer-friendly macOS settings. These are a
 
 ### What Gets Configured
 
-**Global**
-- Show all file extensions
-- Always show scrollbars
-- Disable auto-correct and auto-capitalization
-- Fast key repeat rate and short repeat delay
-
-**Finder**
-- Show path bar and status bar
-- Default to list view
-- No warning when changing file extensions
-- Show hidden files
-
-**Dock**
-- Keep Dock visible (no autohide by default)
-- Hide recent applications
-- Set icon size
-- Use scale effect for minimize
-
-**Screenshots**
-- Save to `~/Screenshots`
-- PNG format
-- Disable shadow
-
-**Other**
-- Safari developer menu enabled
-- TextEdit defaults to plain text
-- Time Machine won't prompt for new backup disks
+**Dock** — Auto-hide, hide delay, icon size, show recent apps, position, minimize animation, show only active apps, launch animation
+
+**Finder** — Default view style, new window location, search scope, path bar, status bar, hidden files, file extensions, POSIX path in title bar
+
+**Trackpad** — Tap to click, natural scrolling, three-finger drag
+
+**Desktop** — Click wallpaper to show desktop
+
+**Keyboard** — Key repeat rate, delay until repeat, press-and-hold for accents
+
+**Screenshots** — File format (PNG/JPEG/PDF/TIFF), disable window shadows
+
+**Menu Bar** — Show Sound control
 
 ### Skipping macOS Preferences
 

src/docs/snapshot.md

@@ -27,7 +27,7 @@ curl -fsSL https://openboot.dev/install.sh | bash -s -- snapshot
 | **Homebrew Casks** | All installed GUI apps | `brew list --cask` |
 | **Homebrew Taps** | Third-party repositories | `brew tap` |
 | **NPM Global Packages** | Globally installed npm packages | `npm list -g` |
-| **macOS Preferences** | 23 whitelisted developer settings | Curated list |
+| **macOS Preferences** | 26 whitelisted developer settings | Curated list |
 | **Shell Config** | Oh-My-Zsh plugins, theme, aliases | `.zshrc` parsing |
 | **Git Config** | user.name, user.email, editor, default branch | `~/.gitconfig` |
 | **Dev Tools** | Go, Node.js, Python, Rust, Java, Ruby, Docker | Version detection |

src/lib/presets.ts

@@ -2,7 +2,7 @@ import { getPackageDescription } from './package-metadata';
 
 export interface PresetPackage {
 	name: string;
-	type: 'formula' | 'cask' | 'npm';
+	type: 'formula' | 'cask' | 'npm' | 'tap';
 	desc: string;
 }