Settings: reorganize into Appearance / Behavior / File systems / etc.

- New top-level order in the sidebar: Appearance, Behavior, AI, File systems, Viewer, Keyboard shortcuts, Developer, Updates, License, Advanced. `SettingsSidebar.svelte`'s `TOP_LEVEL_ORDER` is the source of truth; special non-registry sections are interleaved with registry-driven sections.
- Appearance now has 4 subsections:
  - `Colors and formats` (theme mode, app color, size/date colors, date/time format, striped rows)
  - `Zoom and density` (text size, UI density)
  - `File and folder sizes` (size display, human-friendly units, file size format, size mismatch warning)
  - `Listing` (document icons, directory sort, brief column width)
- `Themes` section is gone; `theme.mode` folds into `Appearance > Colors and formats`. "Coming soon" placeholders deleted.
- `Behavior` collects file operations (extension changes only — the noisy `maxConflictsToShow` and `progressUpdateInterval` move into Advanced) and drive indexing.
- `File systems` collects `SMB/Network shares`, `MTP (Android/Kindle/cameras)`, and `Git`.
- `Viewer` and `Updates` get their own top-level entries (no subsections).
- New section components: `AppearanceZoomSection.svelte`, `AppearanceSizesSection.svelte` (+ a11y tests).
- E2E: new `settings.spec.ts` test asserts the exact top-to-bottom sidebar order. Existing settings tests untouched.
- Updated cross-refs: `app-status-store` default section, `openSettingsWindow` deep-link in `VolumeBreadcrumb`, `settings/CLAUDE.md`, `navigation/CLAUDE.md`.

Author: vdavid

apps/desktop/src/lib/app-status-store.ts

@@ -294,7 +294,7 @@ export async function pruneRecentCommands(validIds: ReadonlySet<string>): Promis
 // Settings window section persistence
 // ============================================================================
 
-const DEFAULT_SETTINGS_SECTION = ['General', 'Appearance']
+const DEFAULT_SETTINGS_SECTION = ['Appearance', 'Colors and formats']
 
 /**
  * Loads the last viewed settings section.

apps/desktop/src/lib/file-explorer/navigation/CLAUDE.md

@@ -199,8 +199,8 @@ Pure logic for organizing volumes into display groups. No reactive state.
 5. Network: always includes a synthetic `'network'` entry (`smb://`) plus any mounted SMB shares. The synthetic entry's
    name flips to `"Network (disabled)"` when `options.networkEnabled === false`. `VolumeBreadcrumb` reads
    `getNetworkEnabled()` from reactive settings to set the option, and intercepts clicks on the disabled entry to open
-   Settings → Network → SMB/Network shares (via `openSettingsWindow(['Network', 'SMB/Network shares'])`) instead of
-   navigating.
+   Settings → File systems → SMB/Network shares (via `openSettingsWindow(['File systems', 'SMB/Network shares'])`)
+   instead of navigating.
 
 `getIconForVolume(volume)`: returns the appropriate icon path for a volume based on its category.
 

apps/desktop/src/lib/file-explorer/navigation/VolumeBreadcrumb.svelte

@@ -177,7 +177,7 @@
         // so the user can flip it on. Identified by the synthetic id, not the label, so
         // future label tweaks don't break this branch.
         if (volume.id === 'network' && !getNetworkEnabled()) {
-            void openSettingsWindow(['Network', 'SMB/Network shares'])
+            void openSettingsWindow(['File systems', 'SMB/Network shares'])
             return
         }
 

apps/desktop/src/lib/file-explorer/rename/rename-dialogs.test.ts

@@ -31,11 +31,11 @@ describe('allowFileExtensionChanges setting', () => {
 
   it('should be in the File operations section', () => {
     const def = getSettingDefinition('fileOperations.allowFileExtensionChanges')
-    expect(def?.section).toEqual(['General', 'File operations'])
+    expect(def?.section).toEqual(['Behavior', 'File operations'])
   })
 
   it('should appear in File operations section listing', () => {
-    const settings = getSettingsInSection(['General', 'File operations'])
+    const settings = getSettingsInSection(['Behavior', 'File operations'])
     const ids = settings.map((s) => s.id)
     expect(ids).toContain('fileOperations.allowFileExtensionChanges')
   })

apps/desktop/src/lib/settings/CLAUDE.md

@@ -23,7 +23,7 @@ defined once in `settings-registry.ts` and accessed uniformly by both UI and MCP
 Single source of truth for all settings. Each `SettingDefinition` contains:
 
 - `id`: Unique key (e.g., `appearance.uiDensity`)
-- `section`: Path in settings tree (e.g., `['General', 'Appearance']`)
+- `section`: Path in settings tree (e.g., `['Appearance', 'Colors and formats']`)
 - `type`: boolean, number, string, enum, duration
 - `default`: Default value
 - `constraints`: Type-specific validation (min/max, enum options, etc.)
@@ -91,14 +91,42 @@ applied via `data-size-colors` / `data-date-colors` attributes on `<html>`. Sett
 
 ### Sections (`sections/`)
 
-15 section components rendered inside the settings window. `ListingSection` includes:
-
-- `listing.sizeDisplay`: enum (smart/logical/physical), default smart, toggle-group. Reactive getter:
-  `getSizeDisplayMode()`.
-- `listing.humanFriendlySizeUnits`: boolean, default true, switch. Reactive getter: `getHumanFriendlySizeUnits()`. ON
-  shows "1.02 MB" in size columns and the SelectionInfo primary size readout; OFF shows raw bytes with thin-space triad
-  separators. Volume/disk-space displays, dialogs, and tooltips that already show both formats are unaffected.
-- `listing.sizeMismatchWarning`: boolean, default true, switch. Reactive getter: `getSizeMismatchWarning()`.
+Top-level sidebar order (declared in `SettingsSidebar.svelte`'s `TOP_LEVEL_ORDER`; keep in sync with the E2E test in
+`settings.spec.ts`):
+
+1. **Appearance** — `Colors and formats`, `Zoom and density`, `File and folder sizes`, `Listing`
+2. **Behavior** — `File operations`, `Drive indexing`
+3. **AI** (no subsections)
+4. **File systems** — `SMB/Network shares`, `MTP (Android/Kindle/cameras)`, `Git`
+5. **Viewer** (no subsections)
+6. **Keyboard shortcuts** (special, non-registry)
+7. **Developer** — `MCP server`, `Logging`
+8. **Updates** (no subsections)
+9. **License** (special, non-registry)
+10. **Advanced** (special, auto-generated from `showInAdvanced: true` entries)
+
+Section ↔ component map (`sections/`):
+
+- `AppearanceSection.svelte` → `Appearance > Colors and formats` (theme mode, app color, size/date colors, date/time
+  format, striped rows)
+- `AppearanceZoomSection.svelte` → `Appearance > Zoom and density` (text size, UI density)
+- `AppearanceSizesSection.svelte` → `Appearance > File and folder sizes` (size display, human-friendly units, file size
+  format, size mismatch warning)
+- `ListingSection.svelte` → `Appearance > Listing` (document icons, directory sort, brief column width)
+- `FileOperationsSection.svelte` → `Behavior > File operations` (extension changes only; `maxConflictsToShow` and
+  `progressUpdateInterval` live in Advanced)
+- `DriveIndexingSection.svelte` → `Behavior > Drive indexing` (toggle + clear-index action)
+- `AiSection.svelte` (+ `AiCloudSection.svelte`, `AiLocalSection.svelte`) → `AI`
+- `NetworkSection.svelte` → `File systems > SMB/Network shares`
+- `MtpSection.svelte` → `File systems > MTP (Android/Kindle/cameras)`
+- `GitSection.svelte` → `File systems > Git`
+- `ViewerSection.svelte` → `Viewer`
+- `KeyboardShortcutsSection.svelte` → `Keyboard shortcuts` (special; renders the shortcut table)
+- `McpServerSection.svelte` → `Developer > MCP server`
+- `LoggingSection.svelte` → `Developer > Logging`
+- `UpdatesSection.svelte` → `Updates`
+- `LicenseSection.svelte` → `License` (special; reads `getLicenseInfo`/`getLicenseStatus`)
+- `AdvancedSection.svelte` → `Advanced` (auto-generated UI for every `showInAdvanced: true` entry)
 
 `AdvancedSection` includes `advanced.maxLogStorageMb`: number, default 200, range 0–5000, MB suffix. `0` disables log
 storage entirely (the `Folder` target is dropped from the plugin builder, no error reports possible). Toggling between
@@ -114,10 +142,6 @@ changes take effect on the next keystroke without restart.
 reports when a user-visible error fires). Flow A (the **Help > Send error report…** menu item and the toast button) is
 always available regardless of this setting. Clicking is the consent.
 
-Full list: `AppearanceSection`, `ListingSection`, `FileOperationsSection`, `MtpSection`, `KeyboardShortcutsSection`,
-`NetworkSection`, `LoggingSection`, `McpServerSection`, `UpdatesSection`, `ThemesSection`, `AdvancedSection`,
-`DriveIndexingSection`, `AiSection`, `LicenseSection`, `ViewerSection`.
-
 `NetworkSection` includes `network.enabled`: boolean, default true, switch. The top-of-section toggle. When off, the
 volume picker shows "Network (disabled)" and the backend stops mDNS + clears discovered hosts. Below the switch is a
 non-interactive Local Network access info card with a deep link to System Settings > Privacy & Security > Local Network
@@ -182,7 +206,7 @@ row intentionally spans the full width.
 - **settings-applier.ts**: Listens for setting changes and applies side effects (CSS vars, backend config sync)
 - **network-settings.ts**: Network-specific setting helpers (proxy config, SMB auth defaults)
 - **settings-window.ts**: Logic for opening/focusing/closing the settings window (Tauri window management). Accepts an
-  optional `section` array (e.g. `['Network', 'SMB/Network shares']`) to deep-link a specific section. Two delivery
+  optional `section` array (e.g. `['File systems', 'SMB/Network shares']`) to deep-link a specific section. Two delivery
   paths: (a) new-window: JSON-encoded array on the URL as `?section=...` (JSON because section names can contain `/`,
   e.g. "SMB/Network shares"); (b) already-open window: emits a `navigate-to-section` Tauri event the settings page
   listens for. The settings page also reads the URL param at mount, so reloads or fresh-opens land on the same section.

apps/desktop/src/lib/settings/components/SectionSummary.a11y.test.ts

@@ -16,12 +16,12 @@ vi.mock('$lib/settings/settings-store', () => ({
 }))
 
 describe('SectionSummary a11y', () => {
-  it('General section (multiple subsections) has no a11y violations', async () => {
+  it('Appearance section (multiple subsections) has no a11y violations', async () => {
     const target = document.createElement('div')
     document.body.appendChild(target)
     mount(SectionSummary, {
       target,
-      props: { sectionName: 'General', onNavigate: () => {} },
+      props: { sectionName: 'Appearance', onNavigate: () => {} },
     })
     await tick()
     await expectNoA11yViolations(target)

apps/desktop/src/lib/settings/components/SectionSummary.svelte

@@ -19,13 +19,17 @@
     function getSubsectionDescription(subsection: SettingsSection): string {
         // Return a brief description based on the subsection name
         const descriptions: Record<string, string> = {
-            Appearance: 'Customize fonts, density, and visual display options.',
-            'File operations': 'Configure copy, move, delete, and progress display settings.',
+            'Colors and formats': 'Theme, app color, date and size coloring, and date/time format.',
+            'Zoom and density': 'Text size and UI density for the whole app.',
+            'File and folder sizes': 'How sizes are shown in the file list and warnings about size mismatches.',
+            Listing: 'Document icons, directory sorting, and Brief mode column width.',
+            'File operations': 'Behavior when renaming files (e.g. extension changes).',
             'Drive indexing': 'Background indexing for directory sizes. Manage index storage.',
-            Updates: 'Manage automatic update checks and notifications.',
-            'SMB/Network shares': 'Configure network timeouts and connection settings.',
+            'SMB/Network shares': 'Enable networking, direct SMB connections, share cache, and timeouts.',
+            'MTP (Android/Kindle/cameras)': 'Detect Android, Kindle, and camera devices over USB.',
+            Git: 'Repository chip, per-file status column, and the virtual `.git` portal.',
             'MCP server': 'Configure the Model Context Protocol server for AI integrations.',
-            Logging: 'Debug logging and diagnostic settings.',
+            Logging: 'Verbose console output, log file access, and diagnostic info.',
         }
         return descriptions[subsection.name] ?? `Configure ${subsection.name.toLowerCase()} settings.`
     }

apps/desktop/src/lib/settings/components/SettingsContent.a11y.test.ts

@@ -28,14 +28,14 @@ vi.mock('$lib/tauri-commands', () => ({
 }))
 
 describe('SettingsContent a11y', () => {
-  it('General summary page has no a11y violations', async () => {
+  it('Appearance summary page has no a11y violations', async () => {
     const target = document.createElement('div')
     document.body.appendChild(target)
     mount(SettingsContent, {
       target,
       props: {
         searchQuery: '',
-        selectedSection: ['General'],
+        selectedSection: ['Appearance'],
       },
     })
     await tick()