diff --git a/beta-updates.mdx b/beta-updates.mdx
index 611b0fc..6ab207f 100644
--- a/beta-updates.mdx
+++ b/beta-updates.mdx
@@ -1,8 +1,10 @@
---
-title: Beta updates
-description: "Get each new version before it reaches everyone, and go back to stable releases"
+title: Beta updates on macOS
+description: "Choose the Mac beta channel or return to stable releases"
---
+import PlatformGuides from "/snippets/platform-guides.mdx";
+
Every new minor version ships as one or more betas before its stable release, such as `0.82.0-beta.1` ahead of `0.82.0`. Patch releases skip the beta and go straight to stable.
## Getting betas
@@ -31,3 +33,5 @@ Open an issue on [GitHub](https://github.com/TableProApp/TablePro/issues) with t
## For administrators
The channel is the `com.TablePro.updates.receivesBetaUpdates` key, `true` for Beta, which a configuration profile can pin for a fleet. See [Managed updates](/security/managed-updates).
+
+
diff --git a/databases/index.mdx b/databases/index.mdx
index 85d42a6..70c95f2 100644
--- a/databases/index.mdx
+++ b/databases/index.mdx
@@ -1,15 +1,17 @@
---
title: Supported Databases
-description: All 47 engines TablePro connects to, their default ports, and which ones need a plugin
+description: All 47 engines on macOS, their default ports, and which ones need a plugin
---
import DriverCounts from "/snippets/driver-counts.mdx";
-Forty-seven engines, and every one of them is free to use. What differs between them is where the
+On macOS, every engine in this list is free to use. What differs between them is where the
driver comes from, not what the license covers.
+For other platforms, see [Linux engines](/linux/connect#engines) or [iPhone and iPad engines](/ios#supported-databases).
+
## The full list
| Database | Default port | Driver |
diff --git a/development/overview.mdx b/development/overview.mdx
index 47b01cf..606d902 100644
--- a/development/overview.mdx
+++ b/development/overview.mdx
@@ -3,15 +3,19 @@ title: Contributing
description: Build TablePro from source, contribute a change, or write a database driver plugin
---
-Building and contributing to the app is documented in the app repository, next to the code it describes:
+Choose the source guide for the platform you want to work on:
-- [apple/CONTRIBUTING.md](https://github.com/TableProApp/TablePro/blob/main/apple/CONTRIBUTING.md): setup, building, tests, code style, architecture, pull requests and translation.
-- [AGENTS.md](https://github.com/TableProApp/TablePro/blob/main/AGENTS.md) and [apple/AGENTS.md](https://github.com/TableProApp/TablePro/blob/main/apple/AGENTS.md): the invariants and rules every change has to meet.
-- [apple/RELEASING.md](https://github.com/TableProApp/TablePro/blob/main/apple/RELEASING.md): release builds, notarization and the release tag.
+| Platform | Start here | Covers |
+|---|---|---|
+| macOS and iOS | [Apple contributing guide](https://github.com/TableProApp/TablePro/blob/main/apple/CONTRIBUTING.md) | Setup, builds, tests, code style, and translation |
+| Linux | [Linux contributing guide](https://github.com/TableProApp/TablePro/blob/main/linux/CONTRIBUTING.md) | Development workflow, checks, and pull requests |
+| Windows, in development | [Windows source](https://github.com/TableProApp/TablePro/tree/main/windows) | App, interop library, tests, and build instructions |
+
+Read the repository's [AGENTS.md](https://github.com/TableProApp/TablePro/blob/main/AGENTS.md) and the platform's own rules before making a change. For Mac releases, follow [apple/RELEASING.md](https://github.com/TableProApp/TablePro/blob/main/apple/RELEASING.md).
These pages live in [TableProApp/docs](https://github.com/TableProApp/docs). A docs change that goes with an app change is a pull request there.
-## Plugins
+## macOS plugins
diff --git a/docs.json b/docs.json
index 0dac29f..78185dc 100644
--- a/docs.json
+++ b/docs.json
@@ -2,7 +2,7 @@
"$schema": "https://mintlify.com/docs.json",
"theme": "aspen",
"name": "TablePro",
- "description": "TablePro is a native macOS database client for MySQL, PostgreSQL, SQLite, MongoDB, Redis and more, built on AppKit and SwiftUI with a plugin-based driver system.",
+ "description": "Database guides for TablePro on macOS, iPhone and iPad, and Linux beta. Windows is in development.",
"colors": {
"primary": "#A85A00",
"light": "#FFBB6B",
@@ -196,19 +196,30 @@
"navigation": {
"tabs": [
{
- "tab": "Documentation",
+ "tab": "Overview",
+ "icon": "house",
"groups": [
{
"group": "Start here",
"pages": [
"index",
+ "faq",
+ "changelog"
+ ]
+ }
+ ]
+ },
+ {
+ "tab": "macOS",
+ "groups": [
+ {
+ "group": "Start here",
+ "pages": [
"installation",
"beta-updates",
"quickstart",
"switching",
- "faq",
- "troubleshooting",
- "changelog"
+ "troubleshooting"
]
},
{
@@ -395,13 +406,6 @@
"customization/notifications"
]
},
- {
- "group": "iPhone and iPad",
- "icon": "mobile",
- "pages": [
- "ios/index"
- ]
- },
{
"group": "Security and privacy",
"icon": "shield",
@@ -413,10 +417,24 @@
"features/acknowledgements"
]
}
+ ],
+ "icon": "apple"
+ },
+ {
+ "tab": "iPhone and iPad",
+ "icon": "mobile",
+ "groups": [
+ {
+ "group": "iPhone and iPad",
+ "icon": "mobile",
+ "pages": [
+ "ios/index"
+ ]
+ }
]
},
{
- "tab": "Linux",
+ "tab": "Linux beta",
"icon": "linux",
"groups": [
{
diff --git a/faq.mdx b/faq.mdx
index bbd98fa..59f26bc 100644
--- a/faq.mdx
+++ b/faq.mdx
@@ -5,7 +5,7 @@ description: Short answers on licensing, privacy, offline use, database coverage
import DriverCounts from "/snippets/driver-counts.mdx";
-Short answers only, each linking to the page that carries the detail. Anything not covered is worth an issue on [GitHub](https://github.com/TableProApp/TablePro/issues), where driver requests and support questions are tracked in the open.
+Start with [your platform](/). Unless a question names another platform, these answers describe macOS. For Linux setup and support, use the [Linux guides](/linux/install). Report unanswered questions on [GitHub](https://github.com/TableProApp/TablePro/issues).
## Cost and licensing
@@ -88,11 +88,15 @@ Through iCloud, with a Pro or Team license. Sync is off by default and each cate
-Yes, for iPhone and iPad on iOS 18 or later. It reads the same CloudKit data as the Mac app but carries connections, groups, and tags only. See [iPhone and iPad](/ios).
+Yes. The stable iPhone and iPad app needs no license. See [iPhone and iPad](/ios) for requirements, connections, queries, and sync.
-Yes, in beta: packages for Ubuntu 26.04 and 26.10 and Fedora 44 and later, and a Flatpak bundle for other distributions. It is a separate app with its own [engines](/linux/connect#engines), and none of the [paid features](/features/licensing) yet. See [Install on Linux](/linux/install).
+Yes. The public beta has its own [supported engines](/linux/connect#engines). [Install on Linux](/linux/install) covers the beta PPA, COPR, Flatpak repository, and release packages. [Licensing](/features/licensing) links to Linux account details.
+
+
+
+The Windows app is in development and has no release yet. Follow progress in the [Windows source directory](https://github.com/TableProApp/TablePro/tree/main/windows).
diff --git a/features/licensing.mdx b/features/licensing.mdx
index 4347f43..803f897 100644
--- a/features/licensing.mdx
+++ b/features/licensing.mdx
@@ -22,7 +22,7 @@ There are two tiers, Pro and Team. Team includes everything in Pro. Starter was
| [Team Catalog](/features/connection-sharing) | Team | Menu item hidden |
| [Team Library](/features/team) | Team | Menu item hidden |
-The [Linux beta](/linux/install) follows the same licensing model as the Mac. The paid features listed here are Mac-only for now and come to Linux later.
+The table describes macOS features. The [Linux beta](/linux/install) uses the same plans and accounts; its [account guide](https://github.com/TableProApp/TablePro/blob/main/linux/README.md#tablepro-account) covers device limits and sign-in. The [iPhone and iPad app](/ios) needs no license.
The activation instructions on this page apply to the Mac.
diff --git a/features/overview.mdx b/features/overview.mdx
index b85ab1f..191cf45 100644
--- a/features/overview.mdx
+++ b/features/overview.mdx
@@ -1,6 +1,6 @@
---
-title: Features Overview
-description: Every feature page, grouped the way the sidebar groups them
+title: macOS features
+description: Mac feature guides, grouped by task
---
First time here: [Quick Start](/quickstart) gets you from install to a query without a database server of your own, using the bundled Chinook sample.
@@ -15,7 +15,7 @@ First time here: [Quick Start](/quickstart) gets you from install to a query wit
Connect and run a query, sample database included.
- Import from TablePlus, Sequel Ace, DBeaver, and others.
+ Import connections from another database client.
Licensing, privacy, offline use, coverage.
diff --git a/images/linux-connect-dialog-dark.png b/images/linux-connect-dialog-dark.png
deleted file mode 100644
index 7f3a47b..0000000
Binary files a/images/linux-connect-dialog-dark.png and /dev/null differ
diff --git a/images/linux-connect-dialog.png b/images/linux-connect-dialog.png
index 8e39c67..43f4965 100644
Binary files a/images/linux-connect-dialog.png and b/images/linux-connect-dialog.png differ
diff --git a/images/linux-data-grid-dark.png b/images/linux-data-grid-dark.png
deleted file mode 100644
index 15e8b12..0000000
Binary files a/images/linux-data-grid-dark.png and /dev/null differ
diff --git a/images/linux-data-grid.png b/images/linux-data-grid.png
index 5bf082e..0ed96b4 100644
Binary files a/images/linux-data-grid.png and b/images/linux-data-grid.png differ
diff --git a/images/linux-shortcuts-dialog-dark.png b/images/linux-shortcuts-dialog-dark.png
deleted file mode 100644
index ff4ad8e..0000000
Binary files a/images/linux-shortcuts-dialog-dark.png and /dev/null differ
diff --git a/images/linux-shortcuts-dialog.png b/images/linux-shortcuts-dialog.png
deleted file mode 100644
index 16eb46d..0000000
Binary files a/images/linux-shortcuts-dialog.png and /dev/null differ
diff --git a/images/linux-sql-editor-dark.png b/images/linux-sql-editor-dark.png
deleted file mode 100644
index 1d59a58..0000000
Binary files a/images/linux-sql-editor-dark.png and /dev/null differ
diff --git a/images/linux-sql-editor.png b/images/linux-sql-editor.png
index 31de58c..ab46151 100644
Binary files a/images/linux-sql-editor.png and b/images/linux-sql-editor.png differ
diff --git a/index.mdx b/index.mdx
index 7c6f530..635cd82 100644
--- a/index.mdx
+++ b/index.mdx
@@ -1,41 +1,42 @@
---
title: Introduction
-description: Native database apps for Mac, iPhone, iPad and Linux (beta)
+description: Database guides for macOS, iPhone and iPad, and the Linux beta
---
-import DriverCounts from "/snippets/driver-counts.mdx";
+Choose your platform to install the app, connect to a database, and run your first query. Database support and features differ by platform.
-Every engine, the SQL editor, the data grid, import, export, and the AI assistant cost nothing, and there is no trial countdown. Paid tiers cover iCloud sync, encrypted connection export, environment variables in connection fields, Linked Folders, Query Insights, result charts, and team sharing ([Licensing](/features/licensing)). Use the Mac app, the [iPhone and iPad app](/ios), or the [Linux beta](/linux/install). Paid features are Mac-only for now.
-
-
-
-
-
-
-
-
- Homebrew or the DMG, on macOS 13 and later.
+
+
+ Stable. Install with Homebrew or a DMG, then follow the Mac quickstart.
+
+
+ Stable. Set up connections, browse tables, and run queries. No license required.
-
- A first connection and a first query, or the bundled sample database if you have no server.
+
+ Install from the beta PPA, COPR, or Flatpak repository.
-
- Import connections from TablePlus, Sequel Ace, DBeaver, DataGrip and others.
+
+ In development. No release is available. Follow the source repository for progress.
-## Supported databases
+## Start on macOS
+
+
+
+
+
+
+[Run your first query](/quickstart), [import existing connections](/switching), or find your engine in [Supported databases](/databases). For other platforms, use the [iPhone and iPad guide](/ios) or the [Linux connection guide](/linux/connect).
-
+## Free and paid
-From MySQL and PostgreSQL to DynamoDB, Spanner and Redis, each engine has its own page.
-[Supported Databases](/databases) lists them all with their default ports and says which ones
-arrive as a plugin.
+Connect, query, and edit data without a trial countdown. [Licensing](/features/licensing) covers the Mac's Pro and Team features and links to Linux account details.
## Open source
-The source, plugins included, is under the [GNU Affero General Public License v3.0](https://www.gnu.org/licenses/agpl-3.0.html). A TablePro license key is a separate thing: it activates the paid features, not the app.
+The source, plugins included, is under the [GNU Affero General Public License v3.0 or later](https://www.gnu.org/licenses/agpl-3.0.html). A TablePro license key activates paid features; it is separate from the source license.
-
- View source code, report issues, and contribute to TablePro.
+
+ Read the source, report an issue, or contribute a change.
diff --git a/installation.mdx b/installation.mdx
index cb26a33..78483e0 100644
--- a/installation.mdx
+++ b/installation.mdx
@@ -1,8 +1,10 @@
---
-title: Installation
+title: Install on macOS
description: Install TablePro via Homebrew or DMG on macOS 13.0+
---
+import PlatformGuides from "/snippets/platform-guides.mdx";
+
Homebrew is the short route: `brew install --cask tablepro`. Everyone else takes the DMG.
## System requirements
@@ -51,3 +53,5 @@ rm ~/Library/Preferences/com.TablePro.plist
Connection passwords are in the macOS Keychain and survive both commands. Delete them in Keychain Access by searching for `com.TablePro`. Data already synced through iCloud stays in your iCloud account.
Building from source is in [apple/CONTRIBUTING.md](https://github.com/TableProApp/TablePro/blob/main/apple/CONTRIBUTING.md#setup). A launch that fails or a connection that will not open is in [Troubleshooting](/troubleshooting).
+
+
diff --git a/linux/connect.mdx b/linux/connect.mdx
index d057613..1c3fd63 100644
--- a/linux/connect.mdx
+++ b/linux/connect.mdx
@@ -8,9 +8,8 @@ A window holds several connection sessions and their tabs. The selected tab deci
Opening a connection that is already open brings its window and session forward. **New Window** (`Ctrl+Shift+N`) starts another with the connection list. **Open Database…** on a connection's sidebar row opens another database as a session in the same window.
-
-
-
+
+
## Engines
@@ -36,7 +35,7 @@ Redshift, CockroachDB, TiDB, OceanBase and Databend are untested on Linux. Suppo
## Limits
- Binary, array, spatial, composite and variant cells are read-only. Inspect or copy them in the grid; use a query to change them.
-- Enter time and timestamp values as text, such as `13:45:00` or `2026-11-05 13:45:00`. Include an offset for types that store one. Invalid values stay in the editor with an error; correct them before saving.
+- Duration values, such as MySQL TIME values longer than a day, need text entry. For times of day and timestamps, use the clock in Row Details or enter text. Include an offset for types that store one.
- Redis Cluster and Sentinel are unsupported. Connect to a standalone Redis server instead.
## Add a connection
@@ -84,11 +83,22 @@ Pick **Read-Only** for a production server you only read. Moving to or from it r
| Mode | Connection |
|---|---|
| **Disable** | Plain, no TLS |
+| **Prefer** | PostgreSQL, MySQL and MariaDB only. Encrypted if the server offers TLS; otherwise unencrypted. The server certificate is not checked |
| **Require** | Encrypted. The server certificate is not checked |
-| **Verify full**, the default | Encrypted. The certificate must be valid for the server name |
+| **Verify full** | Encrypted. The certificate must be valid for the server name |
| **Strict** | SQL Server only. TLS before the login, as TDS 8.0 needs. SQL Server 2022 or later on Windows, 2025 or later on Linux |
-Keep **Verify full** unless the server has no certificate this computer can check. For a server signed by your own certificate authority, choose its PEM file in **CA certificate** rather than dropping to **Require**.
+Choose **Verify full** to check the server certificate. For a server signed by your own certificate authority, choose its PEM file in **CA certificate** rather than dropping to **Require**.
+
+New connections start with these defaults:
+
+| Engine | Default encryption | Changes with connection options |
+|---|---|---|
+| PostgreSQL, MySQL, MariaDB | **Prefer** | None |
+| SQL Server | **Verify full** | None |
+| ClickHouse | **Disable** | **Verify full** on ports 443 and 8443 |
+| MongoDB | **Disable** | **Verify full** with **DNS Seed List** on |
+| Cassandra, ScyllaDB, Redis | **Disable** | None |
- **Client certificate** and **Client key** log in with a certificate, on every network engine but SQL Server.
- **TLS server name** checks the certificate against another name than the host. MySQL and MongoDB take it only through an SSH tunnel.
diff --git a/linux/data-grid.mdx b/linux/data-grid.mdx
index 42c2606..049bddb 100644
--- a/linux/data-grid.mdx
+++ b/linux/data-grid.mdx
@@ -6,9 +6,8 @@ tag: "Beta"
A table opened from the sidebar fills a table tab one page at a time, 1,000 rows by default. The bottom bar switches the tab between 100 and 10,000 rows per page, and **Preferences > General > Default page size** sets where new tabs start.
-
-
-
+
+
## Pages and row counts
@@ -32,7 +31,7 @@ A table's filter is kept, and so is each tab's across a restart.
## Edit rows
-Editing works in a table tab on a table with a primary key. Rows a query returns in the SQL editor are read-only, and so are key, generated and auto-increment columns. Check the [cell type limits](/linux/connect#limits) before editing other columns.
+Editing works in a table tab on a table with a primary key. Query results have separate [editing requirements](/linux/sql-editor#edit-query-results). Key, generated and auto-increment columns are read-only. Check the [cell type limits](/linux/connect#limits) before editing other columns.
| To | Press |
|---|---|
diff --git a/linux/install.mdx b/linux/install.mdx
index 2fd3504..59b6cfa 100644
--- a/linux/install.mdx
+++ b/linux/install.mdx
@@ -1,38 +1,51 @@
---
title: Install on Linux
-description: Ubuntu and Fedora packages from the beta and stable repositories, and the .deb, .rpm and Flatpak bundle on GitHub Releases
+description: Install the Linux beta from the PPA, COPR, or Flatpak repository, or download a release package
tag: "Beta"
---
-The Linux app is in beta: only `0.1.0-beta.N` builds exist until 0.1.0 ships. It runs on amd64 and arm64, as an app of its own beside the Mac one, with the engines on [Connect](/linux/connect).
+Use the beta repository for your distribution to receive updates. The Linux beta runs on amd64 and arm64; [Connect](/linux/connect) lists its database engines. There is no stable Linux release yet.
-Use the repository for your distribution: apt or dnf then installs every update, and so do Software Updater and GNOME Software. Take a file from GitHub Releases for another distribution, through the Flatpak bundle, or to try one exact build.
+The .deb and .rpm packages need GNOME 50 libraries. Use the PPA on Ubuntu 26.04 or 26.10, COPR on Fedora 44 or 45, and Flatpak on other distributions, including older Ubuntu releases.
## Install the beta
-Enable both the stable and beta repositories, then install `tablepro`:
+### Ubuntu and Fedora
+
+Add the beta repository, then install `tablepro`:
```bash Ubuntu 26.04 and 26.10
-sudo add-apt-repository ppa:tablepro/tablepro
sudo add-apt-repository ppa:tablepro/tablepro-beta
sudo apt install tablepro
```
-```bash Fedora 44 and later
-sudo dnf copr enable @tablepro/tablepro
+```bash Fedora 44 and 45
sudo dnf copr enable @tablepro/tablepro-beta
sudo dnf install tablepro
```
-apt and dnf install the highest version the two hold, so a release replaces its betas and the next beta replaces that release. Without the stable repository, the last beta stays installed until the next beta.
+apt and dnf install updates, as do Software Updater and GNOME Software.
+
+### Other distributions
+
+Install from the beta Flatpak repository:
+
+```bash
+flatpak install --from https://flatpak.tablepro.app/beta-repo/app.tablepro.TablePro.flatpakref
+flatpak run --branch=beta app.tablepro.TablePro
+```
+
+Opening the [Flatpak install link](https://flatpak.tablepro.app/beta-repo/app.tablepro.TablePro.flatpakref) in a browser starts GNOME Software or KDE Discover. The package uses the GNOME 51 runtime from Flathub. The app itself comes from TablePro's repository, not Flathub.
+
+Run `flatpak update` or use your software center to install updates. If this is your first Flatpak app and the menu does not open it, follow [First Flatpak app](/linux/troubleshooting#first-flatpak-app).
## Install a stable release
-From 0.1.0 on, the stable repository alone gets releases and no betas:
+Once 0.1.0 is released, add the stable repository:
@@ -41,14 +54,14 @@ sudo add-apt-repository ppa:tablepro/tablepro
sudo apt install tablepro
```
-```bash Fedora 44 and later
+```bash Fedora 44 and 45
sudo dnf copr enable @tablepro/tablepro
sudo dnf install tablepro
```
-To stop testing betas, remove the beta repository. The installed beta stays until the stable repository has a newer version.
+With both native repositories enabled, apt and dnf install the highest version: a release replaces its betas, then the next beta replaces that release. To receive only stable releases, disable the beta repository. The installed beta stays until a newer stable version is available.
@@ -62,30 +75,39 @@ sudo dnf copr disable @tablepro/tablepro-beta
+Once a stable Flatpak is published, follow the [Flatpak repository instructions](https://github.com/TableProApp/TablePro/blob/main/linux/README.md#flatpak-repository) to install it.
+
+Flatpak installs the beta and stable branches side by side. They share settings and connections, but Flatpak never switches branches by version. Choose which installed branch the app menu starts:
+
+```bash
+flatpak make-current app.tablepro.TablePro beta
+flatpak make-current app.tablepro.TablePro stable
+```
+
+After making the stable branch current, `flatpak uninstall app.tablepro.TablePro//beta` removes the beta. Before moving to an older version, read [After a downgrade](/linux/troubleshooting#after-a-downgrade).
+
## Packages on GitHub Releases
-Each release and beta on [GitHub Releases](https://github.com/TableProApp/TablePro/releases) carries packages and their `SHA256SUMS`. A beta is a pre-release there. A standalone .deb, .rpm or .flatpak bundle gets no app updates unless you install the next file or enable the PPA or COPR for native packages.
+Download a specific build from [GitHub Releases](https://github.com/TableProApp/TablePro/releases). Linux tags start with `linux-v`, and betas are marked as pre-releases. Subscribe to the [Atom feed](https://github.com/TableProApp/TablePro/releases.atom) for release announcements; it also includes other platforms.
-New Linux betas and their fixes are announced on that releases page. Subscribe to its [Atom feed](https://github.com/TableProApp/TablePro/releases.atom) and filter entries for tags starting with `linux-v`. The feed also includes other platforms. PPA and COPR installs get updates through apt or dnf.
+Standalone .deb and .rpm packages need manual updates unless you enable the PPA or COPR. Flatpak bundles receive updates from the corresponding Flatpak repository.
| File | For |
|---|---|
| `tablepro--ubuntu--.deb` | Ubuntu 26.04 or 26.10, `amd64` or `arm64` |
-| `tablepro--fedora--.rpm` | The Fedora release it names, `x86_64` or `aarch64` |
+| `tablepro--fedora--.rpm` | Fedora 44 or 45, `x86_64` or `aarch64` |
| `tablepro--.flatpak` | Any distribution with Flatpak, `x86_64` or `aarch64` |
-Check the download, then install the file for your system:
+Check the download against the release's `SHA256SUMS`, then install the file for your system:
```bash
sha256sum --check --ignore-missing SHA256SUMS
sudo apt install ./tablepro-0.1.0-beta.3-ubuntu-26.04-amd64.deb
sudo dnf install ./tablepro-0.1.0-beta.3-fedora-44-x86_64.rpm
-flatpak install --user ./tablepro-0.1.0-beta.3-x86_64.flatpak
+flatpak install ./tablepro-0.1.0-beta.3-x86_64.flatpak
```
-The Flatpak bundle fetches the GNOME 51 runtime from Flathub, and the next bundle installs over it. Flathub does not carry TablePro itself. The bundle keeps its files under `~/.var/app/app.tablepro.TablePro/`; [Troubleshooting](/linux/troubleshooting#where-the-files-are) lists them.
-
-Other distributions build from source with the [Quickstart](https://github.com/TableProApp/TablePro/blob/main/linux/README.md#quickstart) in the app repository.
+Flatpak keeps its files under `~/.var/app/app.tablepro.TablePro/`; [Troubleshooting](/linux/troubleshooting#where-the-files-are) lists them. To build from source, follow the app repository's [Quickstart](https://github.com/TableProApp/TablePro/blob/main/linux/README.md#quickstart).
## Move between native packages and Flatpak
@@ -121,12 +143,12 @@ sudo dnf remove tablepro
```
```bash Flatpak
-flatpak uninstall --user app.tablepro.TablePro
+flatpak uninstall app.tablepro.TablePro
```
-The Flatpak commands here assume the `--user` installation in this guide. Use `--system` for a system-wide installation. For a full reset, follow the optional steps next while the app is still installed.
+For a per-user Flatpak installation, add `--user` to the commands. For a full reset, follow the optional steps next while the app is still installed.
## Optional full reset
@@ -160,7 +182,7 @@ Resetting deletes saved work and credentials. [Back up saved work](/linux/troubl
For Flatpak, use this instead of the keep-data uninstall command:
```bash
- flatpak uninstall --user --delete-data app.tablepro.TablePro
+ flatpak uninstall --delete-data app.tablepro.TablePro
```
[The delete-data option](https://docs.flatpak.org/en/latest/flatpak-command-reference.html#flatpak-uninstall) removes the sandbox's data and permissions, including its encrypted secret file. If the desktop keyring still lists a Secret portal item for this app, remove that item too. Native-installation keyring entries remain separate.
@@ -179,6 +201,6 @@ Resetting deletes saved work and credentials. [Back up saved work](/linux/troubl
```
- For Flatpak, run `flatpak remotes --user`. Remove an unused bundle-origin remote with `flatpak remote-delete --user REPOSITORY`, replacing `REPOSITORY` with its listed name. Keep Flathub if other apps or runtimes use it.
+ For Flatpak, run `flatpak remotes`. Remove an unused TablePro remote with `flatpak remote-delete REPOSITORY`, replacing `REPOSITORY` with its listed name. Keep Flathub if other apps or runtimes use it.
diff --git a/linux/keyboard-shortcuts.mdx b/linux/keyboard-shortcuts.mdx
index cefae4a..ded9745 100644
--- a/linux/keyboard-shortcuts.mdx
+++ b/linux/keyboard-shortcuts.mdx
@@ -8,11 +8,6 @@ tag: "Beta"
Focus decides what some keys do. `Ctrl+F` searches the connection list, filters a table tab, finds in query results or finds in the editor, by where the focus is. `Escape` closes a dialog, stops a running query, or drops a selection or extra cursors.
-
-
-
-
-
## General
| Action | Shortcut |
@@ -21,6 +16,7 @@ Focus decides what some keys do. `Ctrl+F` searches the connection list, filters
| Preferences | `Ctrl+,` |
| Search connections | `Ctrl+F` |
| Query history | `Ctrl+Shift+H` |
+| Export the active tab's results or rows | `Ctrl+Shift+E` |
| Show or hide the sidebar | `F9` |
| Show or hide the assistant | `Ctrl+Alt+A` |
| Keyboard shortcuts | `Ctrl+?` |
diff --git a/linux/sql-editor.mdx b/linux/sql-editor.mdx
index f6da3ab..56ff536 100644
--- a/linux/sql-editor.mdx
+++ b/linux/sql-editor.mdx
@@ -6,9 +6,8 @@ tag: "Beta"
`Ctrl+T` opens an editor tab on the window's connection. In a window with no tab open, **Open SQL Editor** does the same.
-
-
-
+
+
## Run
@@ -31,6 +30,10 @@ Each result set, row count, notice and error of a run is its own entry in the re
A statement that opens a transaction leaves **Commit** and **Roll Back** in the results pane until you pick one. Closing the window asks first while the transaction is open.
+## Edit query results
+
+Editing requires a single SELECT from one base table, its whole primary key in the result, and columns the driver can trace to that table. Joins and grouped results stay read-only. Open the table from the sidebar when its query result cannot be edited. Review pending edits, then click **Save** in the results pane to write them or **Discard** to drop them.
+
## Completion and snippets
Completion offers tables, views, columns, schemas, functions and keywords, and resolves aliases. Type a snippet's trigger, pick it in the list, then press `Tab` to move between its stops and `Shift+Tab` to go back.
diff --git a/linux/troubleshooting.mdx b/linux/troubleshooting.mdx
index 3d0187e..dfc60d0 100644
--- a/linux/troubleshooting.mdx
+++ b/linux/troubleshooting.mdx
@@ -6,6 +6,16 @@ tag: "Beta"
Paths here are for the .deb and .rpm packages. The Flatpak bundle keeps the same files under `~/.var/app/app.tablepro.TablePro/`, mapped in [Where the files are](#where-the-files-are).
+## First Flatpak app
+
+If choosing the app in the desktop menu does nothing after your first Flatpak installation, log out and log in again. Until then, start the beta from a terminal:
+
+```bash
+flatpak run --branch=beta app.tablepro.TablePro
+```
+
+Later Flatpak installs and updates do not need another login.
+
## Passwords
Native packages keep saved passwords, the MCP server access token and cloud AI API keys in the Secret Service. GNOME Keyring, KWallet and KeePassXC provide this desktop service.
diff --git a/quickstart.mdx b/quickstart.mdx
index b3bd20d..87121c6 100644
--- a/quickstart.mdx
+++ b/quickstart.mdx
@@ -1,8 +1,10 @@
---
-title: Quick Start
-description: Connect to your first database and run a query in a few minutes
+title: Quickstart on macOS
+description: Connect to your first database and run a query on macOS
---
+import PlatformGuides from "/snippets/platform-guides.mdx";
+
With no connections saved, the welcome window offers **Open Sample Database**, a bundled Chinook SQLite file that needs no server and drops you at step 4. Reset it any time from **Help > Reset Sample Database…**.
@@ -94,3 +96,5 @@ With no connections saved, the welcome window offers **Open Sample Database**, a
## What's next
[Managing connections](/connections), [SSH tunneling](/connections/ssh-tunneling), [keyboard shortcuts](/features/keyboard-shortcuts), and [AI features](/features/ai-assistant). Anything that goes wrong is worth an [issue](https://github.com/TableProApp/TablePro/issues).
+
+
diff --git a/snippets/platform-guides.mdx b/snippets/platform-guides.mdx
new file mode 100644
index 0000000..5aa2266
--- /dev/null
+++ b/snippets/platform-guides.mdx
@@ -0,0 +1 @@
+For another platform, follow the [iPhone and iPad guide](/ios) or the [Linux guide](/linux/install). [All platforms](/) lists availability.
diff --git a/troubleshooting.mdx b/troubleshooting.mdx
index 59cf93b..05358c1 100644
--- a/troubleshooting.mdx
+++ b/troubleshooting.mdx
@@ -1,5 +1,5 @@
---
-title: Troubleshooting
+title: Troubleshooting on macOS
description: Symptom-first checks for launch, connection, plugin, tunnel and save failures
---