From a02cc5aec4eb5f81173ef7c59027a5592acd7c9f Mon Sep 17 00:00:00 2001 From: Ngo Quoc Dat Date: Mon, 12 Oct 2026 01:37:14 +0700 Subject: [PATCH] docs(customization): document the rebuilt theme engine --- customization/data-settings.mdx | 12 ++++++++++-- customization/editor-settings.mdx | 6 +++--- customization/settings.mdx | 5 ++--- development/plugin-registry.mdx | 4 ++-- features/overview.mdx | 2 +- features/sql-editor.mdx | 4 ++-- 6 files changed, 20 insertions(+), 13 deletions(-) diff --git a/customization/data-settings.mdx b/customization/data-settings.mdx index 0a22b62a..73bb7590 100644 --- a/customization/data-settings.mdx +++ b/customization/data-settings.mdx @@ -1,17 +1,25 @@ --- title: Data Settings -description: Data grid, pagination, query result cap, JSON viewer, and query history +description: Data grid font, pagination, query result cap, JSON viewer, and query history --- Browsing a table pages 1,000 rows at a time, and a query that returns more than 10,000 rows stops there. Both numbers, and the rest of what the grid does before you touch anything, are on **Settings > Data**. -The tab is app-wide, so these values apply to every connection you open; filters, column widths, and the sort you clicked are remembered per table instead. Grid fonts are per-theme, on the theme's Fonts tab under [Appearance](/customization/appearance). +The tab is app-wide, so these values apply to every connection you open; filters, column widths, and the sort you clicked are remembered per table instead. The font here is set per Mac, not per theme, and is not synced. Data settings tab Data settings tab +## Font + +| Setting | Default | Applies to | +|---------|---------|------------| +| Data Grid Font | System Mono, 13 pt | Grid cells, the inspector, the cell popovers and the Compare row diff | + +The picker lists the monospaced families installed on your Mac, at 10 to 24 pt. + ## Data Grid | Setting | Default | Notes | diff --git a/customization/editor-settings.mdx b/customization/editor-settings.mdx index 22c49ab1..7106806d 100644 --- a/customization/editor-settings.mdx +++ b/customization/editor-settings.mdx @@ -1,11 +1,11 @@ --- title: Editor Settings -description: SQL editor, Vim mode, line numbers, indentation, and query parameter settings +description: SQL editor font, Vim mode, line numbers, indentation, and query parameter settings --- **Settings > Editor** covers typing and how SQL is displayed. Grid, pagination, result cap and JSON viewer settings are on the [Data](/customization/data-settings) tab instead. -Editor fonts are per-theme. Edit them on the theme's Fonts tab under [Appearance](/customization/appearance). +The font here is set per Mac, not per theme, and is not synced. Editor settings @@ -24,7 +24,7 @@ The picker lists the monospaced families installed on your Mac, at 10 to 24 pt. | Setting | Default | Notes | |---------|---------|-------| -| Show line numbers | On | | +| Show line numbers | On | Turning this off also hides the per-statement run button | | 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) | diff --git a/customization/settings.mdx b/customization/settings.mdx index 528eacf1..d0c4a653 100644 --- a/customization/settings.mdx +++ b/customization/settings.mdx @@ -12,7 +12,7 @@ The settings window is app-wide: a value on any of these twelve tabs holds for e Language, startup, tabs, sidebar, connections, query timeout, updates, reset. - Appearance mode, themes, per-theme fonts and colors. + Appearance mode, themes and theme colors. SQL editor, Vim mode, line numbers, query parameters. Data grid, pagination, result cap, JSON viewer, and query history. Custom shortcuts. @@ -51,8 +51,7 @@ What a fresh install ships with, so one glance down this column says what you ch | Appearance | Appearance | Auto | | Appearance | Light theme | Default Light | | Appearance | Dark theme | Default Dark | -| Appearance | Editor font | System Mono, 13 pt | -| Appearance | Data grid font | System Mono, 13 pt | +| Editor | Editor font | System Mono, 13 pt | | Editor | Show line numbers | On | | Editor | Highlight current line | On | | Editor | Highlight current statement | On | diff --git a/development/plugin-registry.mdx b/development/plugin-registry.mdx index 4c0ab70a..ebc3ef71 100644 --- a/development/plugin-registry.mdx +++ b/development/plugin-registry.mdx @@ -151,9 +151,9 @@ The app fetches the manifest from `raw.githubusercontent.com/TableProApp/plugins Themes use the same manifest with `category: "theme"`. Four things differ from a driver: - Pure JSON data. No executable code, no code signing, no `.tableplugin` bundle -- The ZIP holds `.json` files, each a valid `ThemeDefinition`. Packs with several themes work +- The ZIP holds `.json` files, each a theme file in format `schema: 2`. Packs with several themes work - They install to `~/Library/Application Support/TablePro/Themes/Registry/` -- No `pluginKitVersion` is needed, and the flat v1 fields still decode +- No `pluginKitVersion` is needed. Set `minAppVersion` to the release that reads the format the theme is written in, because that is the only check an older TablePro runs before installing it ```json { diff --git a/features/overview.mdx b/features/overview.mdx index 1b483965..d8fa8814 100644 --- a/features/overview.mdx +++ b/features/overview.mdx @@ -215,7 +215,7 @@ First time here: [Quick Start](/quickstart) gets you from install to a query wit Every tab, its controls, and their defaults. - Themes, fonts, colors, connection colors. + Themes, theme colors, connection colors. Editor toggles, Vim mode, indentation. diff --git a/features/sql-editor.mdx b/features/sql-editor.mdx index b44bbdba..ddd66835 100644 --- a/features/sql-editor.mdx +++ b/features/sql-editor.mdx @@ -241,6 +241,6 @@ For the execution plan rather than an opinion, press `Cmd+Option+E` and see [Exp ## Editor settings -**Settings > Editor** holds line numbers, current-line and current-statement highlighting, word wrap, [code folding](/features/code-folding), the per-statement run button, [invisible characters](#invisible-characters), tab width, [keyword case](/features/autocomplete#keyword-case), [query parameters](/features/query-parameters), and [vim mode](/features/vim-mode). Editor font family and size are per theme, in **Settings > Appearance**. +**Settings > Editor** holds line numbers, current-line and current-statement highlighting, word wrap, [code folding](/features/code-folding), the per-statement run button, [invisible characters](#invisible-characters), tab width, [keyword case](/features/autocomplete#keyword-case), [query parameters](/features/query-parameters), and [vim mode](/features/vim-mode). Editor font family and size are on that same tab. -Editor windows remember their size, position and font zoom between launches. See [Query Tabs](/features/tabs#switching-tabs). +The font size set by `Cmd+=` and `Cmd+-` is the Editor Font setting, so it is kept between launches. See [Query Tabs](/features/tabs#switching-tabs).