Skip to content

docs(customization): document the editor font and the panes a theme colors #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
datlechin merged 1 commit into from
Oct 11, 2026
Merged

docs(customization): document the editor font and the panes a theme colors #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions customization/appearance.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,8 @@ Custom themes get color wells here. A built-in or registry theme shows a lock an

A slot holds either a hex color or the name of a macOS system color. Default Light and Default Dark keep the data grid surrounds on system colors, which is why an untouched theme follows your system accent and its Increase Contrast setting. Right-click a well that a built-in leaves on a system color to put that system color back.

A theme colors the panes that show database content. The sidebar, the toolbar, the tab strip and the window frame stay on the macOS appearance, which is what the **Appearance** control at the top of the tab sets: pick a dark theme and the window frame goes dark with it.

## Theme files

A theme is one JSON file. **Export…** in the gear menu writes every color the selected theme sets, which is the shortest way to start a new one; **Import…** in the **+** menu reads one back into `~/Library/Application Support/TablePro/Themes/`. Themes published to the [plugin registry](/features/plugins#themes) install from **Settings > Plugins > Browse**, Themes category.
Expand Down
23 changes: 21 additions & 2 deletions customization/editor-settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,35 @@ Editor fonts are per-theme. Edit them on the theme's Fonts tab under [Appearance
<img className="hidden dark:block" src="/images/settings-editor-dark.png" alt="Editor settings" />
</Frame>

## SQL editor
## Font

| Setting | Default | Applies to |
|---------|---------|------------|
| Editor Font | System Mono, 13 pt | SQL editor, the JSON viewer's Text mode, and the DDL, trigger and import previews |

The picker lists the monospaced families installed on your Mac, at 10 to 24 pt. `Cmd+=` and `Cmd+-` change the size over the same range.

## Display

| Setting | Default | Notes |
|---------|---------|-------|
| Show line numbers | On | |
| Highlight current line | On | |
| Highlight current statement | On | A faint band behind the statement the cursor is in. See [Statement markers](/features/sql-editor#statement-markers) |
| Show invisible characters | Off | See [Invisible characters](/features/sql-editor#invisible-characters) |
| Word wrap | Off | Off means long lines scroll horizontally |

## Gutter

| Setting | Default | Notes |
|---------|---------|-------|
| Code folding | On | Shows the fold ribbon in the gutter. See [Code Folding](/features/code-folding) |
| Run button beside each statement | On | Gutter run buttons, revealed when the pointer is over the gutter |
| Run button beside each statement | On | Gutter run buttons, revealed when the pointer is over the gutter. Needs line numbers on |

## Editing

| Setting | Default | Notes |
|---------|---------|-------|
| Tab width | 4 spaces | 2, 4, or 8 |
| Keyword case | Match what I type, otherwise UPPERCASE | The case completed keywords and functions take, and the case **Format SQL** produces. `UPPERCASE` and `lowercase` also rewrite keywords as you type them, leaving strings, comments and quoted identifiers untouched. See [Keyword case](/features/autocomplete#keyword-case) |
| Query parameters (`:name` syntax) | On | Detects `:name` placeholders and shows the parameter panel. See [Query Parameters](/features/query-parameters) |
Expand Down
Loading