update docs

Author: datlechin

docs/customization/appearance.mdx

@@ -76,107 +76,13 @@ You pick one active theme at a time. There is no separate "light theme" and "dar
 
 ## Customizing Themes
 
-Select a theme in the sidebar, then edit it directly in the right panel.
+Select a theme and edit directly. For built-in themes, you can always edit fonts, and you can modify colors/layout by duplicating first.
 
-### Fonts Tab
+Built-in themes auto-duplicate when you make changes, preserving the original.
 
-Always editable, even on built-in themes. If you change a font on a built-in theme, TablePro auto-duplicates it as a custom theme so the original stays untouched.
+## Import, Export & Registry
 
-Four settings:
-
-- **Editor font family** (used in the SQL editor)
-- **Editor font size**
-- **Data grid font family** (used in result grid cells)
-- **Data grid font size**
-
-A live preview updates as you change values.
-
-<Tip>
-If you only want to change fonts without touching colors, just adjust the font fields. The auto-duplicate handles the rest.
-</Tip>
-
-### Colors Tab
-
-Defines 50+ colors across 5 categories. For built-in themes, the Colors tab shows a "Duplicate to customize" prompt. Duplicate first, then edit freely.
-
-| Category | What It Controls |
-|----------|-----------------|
-| **Editor** | Background, text, cursor, current line highlight, selection, line numbers, invisibles, and 8 syntax colors (keyword, string, number, comment, null, operator, function, type) |
-| **Data Grid** | Background, text, alternate row, null value, boolean true/false, row number, modified/inserted/deleted row highlights, focus border |
-| **Interface** | Window/control/card backgrounds, borders, primary/secondary/tertiary text, accent color, selection, hover, status colors (success/warning/error/info), badge colors |
-| **Sidebar** | Background, text, selected item, hover, section header |
-| **Toolbar** | Secondary text, tertiary text |
-
-Each color is edited via a hex color picker.
-
-### Layout Tab
-
-Defines 30+ layout tokens across 6 sections. Same lock behavior as Colors: built-in themes require duplication before editing.
-
-| Section | Tokens |
-|---------|--------|
-| **Typography** | Font sizes: tiny (9), caption (10), small (11), medium (12), body (13), title3 (15), title2 (17) |
-| **Spacing** | Scale from xxxs (2) to xl (24), plus list row insets |
-| **Icon Sizes** | 9 sizes from tinyDot (6) to massive (64) |
-| **Corner Radius** | Small (4), medium (6), large (8) |
-| **Row Heights** | Compact (24), table (32), comfortable (44) |
-| **Animations** | Durations: fast (0.1s), normal (0.15s), smooth (0.2s), slow (0.3s) |
-
-Values in parentheses are defaults.
-
-## Import and Export
-
-### Exporting a Theme
-
-1. Select the theme in the sidebar
-2. Click the **gear** menu at the bottom of the sidebar
-3. Choose **Export...**
-4. Pick a save location
-
-The exported `.json` file contains all colors, fonts, and layout tokens.
-
-### Importing a Theme
-
-1. Click the **+** menu at the bottom of the sidebar
-2. Choose **Import...**
-3. Select a `.json` theme file
-
-The imported theme appears in the "Custom" section.
-
-<Note>
-Custom themes are stored as JSON files in `~/Library/Application Support/TablePro/Themes/`.
-</Note>
-
-## Registry Themes
-
-Install community-created themes from the plugin registry without leaving the app.
-
-### Installing a Theme
-
-1. Go to **Settings > Plugins > Browse**
-2. Filter by **Themes** category
-3. Click **Install Theme** on the theme you want
-4. The theme appears in the "Registry" section of **Settings > Appearance**
-
-Registry themes are read-only. To customize one, duplicate it first: the copy appears in the "Custom" section and is fully editable.
-
-### Uninstalling a Theme
-
-1. Select the registry theme in **Settings > Appearance**
-2. Click the **gear** menu
-3. Choose **Uninstall**
-
-If the uninstalled theme was active, TablePro falls back to Default Light.
-
-<Note>
-Registry themes are stored in `~/Library/Application Support/TablePro/Themes/Registry/`. They use a `registry.*` ID prefix to avoid conflicts with built-in and custom themes.
-</Note>
-
-### Theme File Format
-
-Theme files are JSON with these top-level keys: `id`, `name`, `version`, `appearance`, `author`, `editor`, `dataGrid`, `ui`, `sidebar`, `toolbar`, `fonts`, `spacing`, `typography`, `iconSizes`, `cornerRadius`, `rowHeights`, `animations`.
-
-All fields are optional on import. Missing fields fall back to Default Light values.
+Export custom themes as JSON. Import themes from files or install from the plugin registry (**Settings > Plugins > Browse**, filter by Themes). Registry themes are read-only — duplicate to customize.
 
 ## Connection Colors
 
@@ -272,19 +178,3 @@ These appear on:
   />
 </Frame>
 
-## Related Settings
-
-<CardGroup cols={2}>
-  <Card title="Editor Settings" icon="code" href="/customization/editor-settings">
-    Font and editor appearance
-  </Card>
-  <Card title="Settings Overview" icon="gear" href="/customization/settings">
-    All settings categories
-  </Card>
-  <Card title="Data Grid" icon="table" href="/features/data-grid">
-    Configure data display
-  </Card>
-  <Card title="Connections" icon="plug" href="/databases/overview">
-    Connection color settings
-  </Card>
-</CardGroup>

docs/customization/editor-settings.mdx

@@ -39,16 +39,6 @@ Available monospace fonts:
 **System Mono** automatically uses the best available system monospace font.
 </Tip>
 
-### Font Availability
-
-| Font | Availability |
-|------|--------------|
-| System Mono | Always available |
-| SF Mono | macOS 10.12+ |
-| Menlo | macOS 10.6+ |
-| Monaco | macOS Classic |
-| Courier New | Standard system font |
-
 If a selected font isn't available, TablePro falls back to System Mono.
 
 {/* Screenshot: Font family selector */}
@@ -128,10 +118,8 @@ Line numbers are useful for:
 
 | Option | Description |
 |--------|-------------|
-| **On** | Subtly highlight the line with cursor (default) |
-| **Off** | No highlight on current line |
-
-Helps track your cursor position in long queries.
+| **On** | Highlight the line with cursor (default) |
+| **Off** | No highlight |
 
 {/* Screenshot: Current line highlight */}
 <Frame caption="Current line highlighting in the editor">
@@ -154,18 +142,6 @@ Helps track your cursor position in long queries.
 | **Off** | Long lines scroll horizontally (default) |
 | **On** | Long lines wrap to next line |
 
-**Enable word wrap when**:
-
-- Working on narrow screens
-- Queries have long lines
-- You want to avoid horizontal scrolling
-
-**Disable word wrap when**:
-
-- You prefer consistent line lengths
-- Working with pre-formatted queries
-- You need to see query structure clearly
-
 {/* Screenshot: Word wrap */}
 <Frame caption="Word wrap: wrapped vs horizontal scrolling">
   <img
@@ -259,94 +235,7 @@ See [Autocomplete](/features/autocomplete) for details.
 
 All changes apply immediately. No restart required.
 
-## Recommended Configurations
-
-### Default (Balanced)
-
-```
-Font Family: System Mono
-Font Size: 13 pt
-Line Numbers: On
-Current Line: On
-Tab Width: 4
-Auto Indent: On
-Word Wrap: Off
-```
-
-### Compact (More Code Visible)
-
-```
-Font Family: SF Mono
-Font Size: 11 pt
-Line Numbers: On
-Current Line: On
-Tab Width: 2
-Auto Indent: On
-Word Wrap: Off
-```
-
-### Comfortable (Easy Reading)
-
-```
-Font Family: Menlo
-Font Size: 15 pt
-Line Numbers: On
-Current Line: On
-Tab Width: 4
-Auto Indent: On
-Word Wrap: On
-```
-
-### Minimal (Clean Interface)
-
-```
-Font Family: Monaco
-Font Size: 13 pt
-Line Numbers: Off
-Current Line: Off
-Tab Width: 4
-Auto Indent: On
-Word Wrap: Off
-```
-
-### Accessibility
-
-```
-Font Family: System Mono
-Font Size: 18 pt
-Line Numbers: On
-Current Line: On
-Tab Width: 4
-Auto Indent: On
-Word Wrap: On
-```
-
-## Syntax Highlighting
-
-SQL syntax is highlighted automatically:
-
-| Element | Color (Dark) | Color (Light) |
-|---------|--------------|---------------|
-| Keywords | Pink | Pink |
-| Strings | Green | Green |
-| Numbers | Blue | Blue |
-| Comments | Gray | Gray |
-| Functions | Default | Default |
-| Identifiers | White | Black |
-
-Colors adapt to the current theme.
-
-### Highlighted Keywords
-
-SQL keywords that are highlighted:
-
-- `SELECT`, `INSERT`, `UPDATE`, `DELETE`, `CREATE`, `ALTER`, `DROP`
-- `FROM`, `WHERE`, `JOIN`, `ON`, `GROUP BY`, `ORDER BY`, `HAVING`
-- `AND`, `OR`, `NOT`, `IN`, `LIKE`, `BETWEEN`, `IS NULL`
-- `INNER`, `LEFT`, `RIGHT`, `OUTER`, `CROSS`, `UNION`
-- And many more SQL standard keywords
-
-## Keyboard Shortcuts in Editor
+## Keyboard Shortcuts
 
 | Action | Shortcut |
 |--------|----------|
@@ -357,45 +246,3 @@ SQL keywords that are highlighted:
 | Replace | `Cmd+Option+F` |
 | Select All | `Cmd+A` |
 | Go to Line | `Cmd+G` |
-
-See [Keyboard Shortcuts](/features/keyboard-shortcuts) for the complete list.
-
-## Troubleshooting
-
-### Font Not Appearing Correctly
-
-1. Verify the font is installed on your system
-2. Try a different font
-3. Restart TablePro
-
-### Settings Not Saving
-
-1. Check disk permissions
-2. Verify preferences file is writable:
-   ```bash
-   ls -la ~/Library/Preferences/com.TablePro.plist
-   ```
-3. Try resetting preferences
-
-### Editor Feels Slow
-
-1. Reduce font size (larger fonts render slower)
-2. Disable word wrap for long queries
-3. Check for very large queries in the editor
-
-## Related Pages
-
-<CardGroup cols={2}>
-  <Card title="SQL Editor" icon="code" href="/features/sql-editor">
-    Editor features and usage
-  </Card>
-  <Card title="Autocomplete" icon="wand-magic-sparkles" href="/features/autocomplete">
-    Autocomplete functionality
-  </Card>
-  <Card title="Appearance" icon="palette" href="/customization/appearance">
-    Theme and colors
-  </Card>
-  <Card title="Keyboard Shortcuts" icon="keyboard" href="/features/keyboard-shortcuts">
-    All keyboard shortcuts
-  </Card>
-</CardGroup>