Appearance Settings
Configure how TablePro looks in Settings > Appearance.
Theme Engine
TablePro ships with 9 built-in themes and supports custom themes. Community themes are available from the plugin registry. Each theme controls editor syntax colors, data grid colors, sidebar/toolbar styling, fonts, spacing, and layout tokens.
Theme Editor Layout
The Appearance tab is a split view with two panels:
- Left panel: Sections for “Built-in”, “Registry”, and “Custom”. Each row shows a color thumbnail, theme name, and source label. Select a theme to activate and edit it.
- Right panel: Three tabs: Fonts, Colors, and Layout.
At the bottom of the sidebar, an action bar provides:
| Button | Action |
|---|
| + menu | New Theme, Import… |
| - button | Delete selected theme (disabled for built-in and registry themes) |
| Gear menu | Duplicate, Export…, Uninstall (registry themes only) |
Built-in Themes
| Theme | Appearance | Based On |
|---|
| Default Light | Light | macOS system colors |
| Default Dark | Dark | macOS system colors |
| Dracula | Dark | Dracula color scheme |
| Solarized Light | Light | Ethan Schoonover’s Solarized |
| Solarized Dark | Dark | Ethan Schoonover’s Solarized |
| One Dark | Dark | Atom One Dark |
| GitHub Light | Light | GitHub UI |
| GitHub Dark | Dark | GitHub UI |
| Nord | Dark | Arctic north-bluish palette |
Theme Appearance Mode
Each theme has a fixed appearance property: light, dark, or auto. Activating a theme sets NSApp.appearance to match. One active theme at a time; there is no separate light/dark assignment.
Customizing Themes
Select a theme and edit directly. Built-in themes auto-duplicate when you change colors or layout, preserving the original. Font changes apply without duplication.
Import, Export & Registry
Export custom themes as JSON. Import from files or install from the plugin registry (Settings > Plugins > Browse, filter by Themes). Registry themes are read-only; duplicate to customize.
Connection Colors
Color-code connections for quick identification:
| Color | Suggested Use |
|---|
| None | Default, neutral |
| Red | Production databases |
| Orange | Staging environments |
| Yellow | Testing databases |
| Green | Development/local |
| Blue | Shared databases |
| Purple | Special purpose |
| Pink | Personal projects |
Setting Connection Color
- Open the connection form (edit or create)
- In the Appearance section, click Color
- Select a color from the palette
- Save the connection
Connection Color Display
Connection colors show up in:
- Sidebar connection list
- Tab headers
- Connection status bar
- Window title (when connected)
Use red for production databases as a visual reminder to be careful with queries.
Database Type Colors
Each database type has a fixed color for quick identification:
| Database | Color |
|---|
| MySQL | Orange |
| MariaDB | Cyan |
| PostgreSQL | Blue |
| SQLite | Green |
These appear on:
- Database type icons
- Connection type indicators
- Sidebar icons