Skip to main content

Appearance Settings

Configure how TablePro looks in Settings > Appearance (Cmd+,).
Appearance settings

Appearance settings with theme list and editor

Themes

Four themes ship with the app: Default Light, Default Dark, Dracula (dark), and Nord (dark). A theme controls editor and syntax colors, data grid colors, interface colors, and the editor and data grid fonts. Interface colors default to macOS system colors, so they follow the system appearance and accent color unless a theme overrides them. The tab is a split view:
  • Left: theme list grouped into Built-in, Registry, and Custom. Each row shows a preview thumbnail, name, and source. Selecting a theme activates it.
  • Right: the editor for the selected theme, with Fonts and Colors tabs.
The action bar below the list:

Appearance Mode

Pick Light, Dark, or Auto at the top. Light and Dark each remember their own preferred theme; Auto follows the system and switches between the two. Selecting a dark theme while in Light mode also switches the mode to Dark so you see the change right away.

Fonts

The Fonts tab sets the editor and data grid fonts per theme. Family pickers list the monospaced fonts installed on your Mac, and a preview renders a sample query with the theme’s editor colors. Changing a font on a built-in theme does not modify the original: TablePro creates a copy named “Theme (Custom)” and applies the change there.

Colors

The Colors tab is editable only on custom themes. Built-in and registry themes show a lock and a Duplicate Theme button; the copy (named “Theme (Copy)”) is fully editable. Interface, Sidebar, and Toolbar colors fall back to macOS system colors until you override them. Overridden values show a reset button that restores the system default.

Import, Export & Registry

Export any theme as JSON from the gear menu; import a JSON theme from the + menu. Community themes install from the plugin registry (Settings > Plugins > Browse, Themes category). Colors on registry themes are locked, same as built-ins: duplicate the theme to edit them. Remove a registry theme with the gear menu’s Uninstall.

Connection Colors

Assign a color to a connection in the connection form: Customization pane > Appearance > Color. Nine options: None, Red, Orange, Yellow, Green, Blue, Purple, Pink, Gray. With no color set, the connection uses its database type’s brand color, supplied by the driver plugin. Connection groups take a color the same way, from their right-click menu on the welcome window. The color appears on:
  • The toolbar connection status indicator
  • The connection switcher popover
  • The sidebar connection header
  • The welcome window connection list
Use red for production databases as a visual reminder to be careful with queries.
Connection colors in the toolbar and welcome list

Connection color on the toolbar status indicator and welcome list