docs: update documentation for nested groups feature

Author: datlechin

docs/customization/settings.mdx

@@ -457,7 +457,7 @@ Manage iCloud sync from the **Sync** tab in Settings. This is a Pro feature.
 | Setting | Default | Description |
 |---------|---------|-------------|
 | **Connections** | On | Sync connection details (not passwords) |
-| **Groups & Tags** | On | Sync connection organization |
+| **Groups & Tags** | On | Sync connection organization, including nested group hierarchy |
 | **App Settings** | On | Sync all 8 settings categories |
 | **Query History** | On | Sync query history |
 

docs/databases/overview.mdx

@@ -246,7 +246,16 @@ SSL/TLS is not available for SQLite connections (file-based, no network involved
 
 Colors tint the toolbar when you connect (red for production, green for development). Tags group connections in the sidebar.
 
-Create connection groups by right-clicking in the connection list or using the folder icon. Groups collapse/expand and persist between sessions.
+Create connection groups by right-clicking in the connection list or using the folder icon. Groups collapse/expand with native macOS disclosure triangles and persist between sessions.
+
+### Nested Groups
+
+Groups can contain subgroups, up to 3 levels deep. This lets you organize connections hierarchically: for example, a "Company" group containing "Production" and "Staging" subgroups, each with their own connections.
+
+- **Create a subgroup**: right-click a group and select **New Subgroup**. This option is disabled at the maximum depth (3 levels).
+- **Move a group**: right-click a group and select **Move to...** to reparent it under a different group or back to the top level.
+- **Delete a group**: deleting a parent group removes all its subgroups. Connections inside deleted groups are ungrouped, not deleted.
+- **Group picker**: the connection form shows the full group hierarchy when assigning a connection to a group.
 
 {/* Screenshot: Connection form showing color picker */}
 <Frame caption="Connection color picker and organization">

docs/features/connection-sharing.mdx

@@ -139,12 +139,15 @@ JSON. Required fields: `name`, `host`, `type`.
       "tagName": "production"
     }
   ],
-  "groups": [{ "name": "Backend", "color": "Blue" }],
+  "groups": [
+    { "name": "Backend", "color": "Blue" },
+    { "name": "Staging", "color": "Green", "parentGroupName": "Backend" }
+  ],
   "tags": [{ "name": "production", "color": "Red" }]
 }
 ```
 
-Groups and tags match by name. Missing ones are created. Paths use `~/` for portability.
+Groups and tags match by name. Missing ones are created. Nested groups use `parentGroupName` to preserve hierarchy. Paths use `~/` for portability.
 
 ## Sharing vs iCloud Sync
 

docs/features/icloud-sync.mdx

@@ -13,7 +13,7 @@ TablePro syncs your connections, groups, settings, and query history across all
 |------|--------|-------|
 | **Connections** | Yes | Host, port, username, database type, SSH/SSL config |
 | **Passwords** | Optional | Opt-in via iCloud Keychain (end-to-end encrypted) |
-| **Groups & Tags** | Yes | Full connection organization |
+| **Groups & Tags** | Yes | Full connection organization, including nested group hierarchy (parent-child relationships and sort order) |
 | **App Settings** | Yes | All 8 categories (General, Appearance, Editor, Data Grid, History, Tabs, Keyboard, AI) |
 | **Query History** | Yes | Configurable limit: 100, 500, 1,000, or unlimited |
 

docs/features/keyboard-shortcuts.mdx

@@ -186,8 +186,8 @@ For keyboards without dedicated arrow keys (e.g., HHKB), Ctrl+HJKL works as arro
 |----------|--------|-------|
 | `Ctrl+J` / `Ctrl+N` | Move down / Next item | Data grid, connection list, quick switcher, database switcher |
 | `Ctrl+K` / `Ctrl+P` | Move up / Previous item | Data grid, connection list, quick switcher, database switcher |
-| `Ctrl+H` | Move left / Collapse group | Data grid (column left), welcome panel (collapse group), onboarding (previous page) |
-| `Ctrl+L` | Move right / Expand group | Data grid (column right), welcome panel (expand group), onboarding (next page) |
+| `Ctrl+H` | Move left / Collapse group | Data grid (column left), welcome panel (collapse group at any nesting level), onboarding (previous page) |
+| `Ctrl+L` | Move right / Expand group | Data grid (column right), welcome panel (expand group at any nesting level), onboarding (next page) |
 | `Ctrl+Shift+J` | Extend selection down | Data grid |
 | `Ctrl+Shift+K` | Extend selection up | Data grid |