Skip to main content

Appearance Settings

Customize how TablePro looks to match your preferences and reduce eye strain. Access appearance settings via Settings > Appearance.
Appearance settings

Theme

TablePro supports three theme modes:
ThemeDescription
SystemAutomatically matches macOS appearance (default)
LightAlways use light theme
DarkAlways use dark theme

System Theme

When set to System, TablePro follows your macOS appearance setting:
  1. Open System Settings > Appearance
  2. Choose Light, Dark, or Auto
  3. TablePro updates automatically
Theme comparison

Light Theme

The light theme features:
  • White/light gray backgrounds
  • Dark text for readability
  • Ideal for well-lit environments
  • Lower contrast for reduced eye strain in bright rooms

Dark Theme

The dark theme features:
  • Dark gray/black backgrounds
  • Light text for contrast
  • Reduces eye strain in low light
  • Popular for extended coding sessions
  • Lower battery usage on OLED displays
Dark theme is often preferred by developers working for extended periods, especially in low-light environments.

Accent Color

Customize the accent color used throughout the app:
OptionDescription
SystemUses your macOS accent color
BlueClassic blue accent
PurplePurple accent
PinkPink accent
RedRed accent
OrangeOrange accent
YellowYellow accent
GreenGreen accent
GraphiteGray/neutral accent

Where Accent Color Appears

The accent color is used for:
  • Selected items and highlights
  • Buttons and interactive elements
  • Progress indicators
  • Focus rings
  • Active tab indicators
Accent colors

Matching macOS

To use your system accent color:
  1. Set TablePro’s accent color to System
  2. Open System Settings > Appearance
  3. Choose your preferred accent color
  4. TablePro updates automatically

Connection Colors

Assign colors to individual connections for visual organization:
ColorSuggested Use
NoneDefault, neutral
RedProduction databases
OrangeStaging environments
YellowTesting databases
GreenDevelopment/local
BlueShared databases
PurpleSpecial purpose
PinkPersonal projects

Setting Connection Color

  1. Open the connection form (edit or create)
  2. In the Appearance section, click Color
  3. Select a color from the palette
  4. Save the connection
Connection colors

Connection Color Display

Connection colors appear in:
  • Sidebar connection list
  • Tab headers
  • Connection status bar
  • Window title (when connected)
Consider using red for production databases as a visual warning to be careful with queries.

Database Type Colors

Each database type has an associated color for quick identification:
DatabaseColor
MySQLOrange
MariaDBCyan
PostgreSQLBlue
SQLiteGreen
These colors appear on:
  • Database type icons
  • Connection type indicators
  • Sidebar icons

Editor Theme

The SQL editor uses syntax highlighting colors:
ElementColor
KeywordsPink
StringsGreen
NumbersBlue
CommentsGray
IdentifiersDefault text color
Editor colors automatically adapt to light/dark theme.

UI Elements

Status Colors

ColorMeaning
GreenSuccess, connected, valid
OrangeWarning, in progress, connecting
RedError, failed, invalid
BlueInformation
GrayNeutral, disconnected

Data Type Colors

In the data grid:
TypeDisplay
NULLGray, italicized
Boolean TrueGreen
Boolean FalseRed
NumbersStandard color
TextStandard color

Best Practices

For Readability

  1. Match environment: Use dark theme in low light, light in bright
  2. Contrast: Ensure sufficient contrast for your lighting
  3. Font size: Increase if text is hard to read

For Organization

  1. Connection colors: Develop a consistent color scheme
  2. Environment coding: Red=prod, green=dev, etc.
  3. Team conventions: Agree on color meanings with your team

For Eye Health

  1. Dark theme at night: Reduces blue light exposure
  2. Take breaks: Look away from screen periodically
  3. Night Shift: Enable macOS Night Shift for warmer colors

Accessibility

Color Blindness

Consider these tips for color blind users:
  1. Don’t rely solely on color for meaning
  2. Connection names provide text identification
  3. Icons supplement color information

High Contrast

For better visibility:
  1. Use either light or dark theme (not auto)
  2. Choose high-contrast accent colors (blue, green)
  3. Increase font sizes in editor settings

Troubleshooting

Theme Not Changing

  1. Restart TablePro after changing settings
  2. Check macOS appearance if using System theme
  3. Verify settings were saved

Colors Look Wrong

  1. Check display color profile in System Settings
  2. Verify monitor calibration
  3. Check True Tone settings on supported displays

Accent Color Not Applying

  1. Restart TablePro
  2. Set to specific color instead of System
  3. Check for conflicting system extensions