Appearance Settings
Customize how TablePro looks to match your preferences and reduce eye strain. Access appearance settings via Settings > Appearance.
Theme
TablePro supports three theme modes:
| Theme | Description |
|---|
| System | Automatically matches macOS appearance (default) |
| Light | Always use light theme |
| Dark | Always use dark theme |
System Theme
When set to System, TablePro follows your macOS appearance setting:
- Open System Settings > Appearance
- Choose Light, Dark, or Auto
- TablePro updates automatically
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:
| Option | Description |
|---|
| System | Uses your macOS accent color |
| Blue | Classic blue accent |
| Purple | Purple accent |
| Pink | Pink accent |
| Red | Red accent |
| Orange | Orange accent |
| Yellow | Yellow accent |
| Green | Green accent |
| Graphite | Gray/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
Matching macOS
To use your system accent color:
- Set TablePro’s accent color to System
- Open System Settings > Appearance
- Choose your preferred accent color
- TablePro updates automatically
Connection Colors
Assign colors to individual connections for visual organization:
| 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 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:
| Database | Color |
|---|
| MySQL | Orange |
| MariaDB | Cyan |
| PostgreSQL | Blue |
| SQLite | Green |
These colors appear on:
- Database type icons
- Connection type indicators
- Sidebar icons
Editor Theme
The SQL editor uses syntax highlighting colors:
| Element | Color |
|---|
| Keywords | Pink |
| Strings | Green |
| Numbers | Blue |
| Comments | Gray |
| Identifiers | Default text color |
Editor colors automatically adapt to light/dark theme.
UI Elements
Status Colors
| Color | Meaning |
|---|
| Green | Success, connected, valid |
| Orange | Warning, in progress, connecting |
| Red | Error, failed, invalid |
| Blue | Information |
| Gray | Neutral, disconnected |
Data Type Colors
In the data grid:
| Type | Display |
|---|
| NULL | Gray, italicized |
| Boolean True | Green |
| Boolean False | Red |
| Numbers | Standard color |
| Text | Standard color |
Best Practices
For Readability
- Match environment: Use dark theme in low light, light in bright
- Contrast: Ensure sufficient contrast for your lighting
- Font size: Increase if text is hard to read
For Organization
- Connection colors: Develop a consistent color scheme
- Environment coding: Red=prod, green=dev, etc.
- Team conventions: Agree on color meanings with your team
For Eye Health
- Dark theme at night: Reduces blue light exposure
- Take breaks: Look away from screen periodically
- Night Shift: Enable macOS Night Shift for warmer colors
Accessibility
Color Blindness
Consider these tips for color blind users:
- Don’t rely solely on color for meaning
- Connection names provide text identification
- Icons supplement color information
High Contrast
For better visibility:
- Use either light or dark theme (not auto)
- Choose high-contrast accent colors (blue, green)
- Increase font sizes in editor settings
Troubleshooting
Theme Not Changing
- Restart TablePro after changing settings
- Check macOS appearance if using System theme
- Verify settings were saved
Colors Look Wrong
- Check display color profile in System Settings
- Verify monitor calibration
- Check True Tone settings on supported displays
Accent Color Not Applying
- Restart TablePro
- Set to specific color instead of System
- Check for conflicting system extensions