TablePro Documentation

Free and open source database client built natively for developers

RAW Doc

File: README.md

TablePro


About

TablePro is what I wanted TablePlus to be: native, fast, open source.

Built with native frameworks on every platform. No Electron, no JDBC, no JavaScript runtime. Cold start under 1 second, idle around 80 MB RAM. Connects to all major SQL and NoSQL databases through native drivers.

AI is built in: chat, inline suggestions, and an MCP server that lets Cursor, Raycast, or Claude Desktop talk to your databases. Bring your own API key, pick your own provider, or run local with Ollama.

Why TablePro

Native macOS database clients today fall into three groups:

  • Single-database, open source: Sequel Ace (MySQL only), Postico (PostgreSQL only). Great if you live in one engine.
  • Multi-database, closed source: TablePlus. Polished and native, but proprietary.
  • Multi-database, not native: DBeaver (JVM), Beekeeper Studio and DBGate (Electron). Cross-platform, but slow to start and heavy on memory.

TablePro is the missing fourth: native, multi-database, and open source.

Platforms

Platform Status
macOS 14+ Stable
iOS / iPadOS 18+ Stable
Linux Prototype, nothing to install yet
Windows No

Supported Databases

Database Distribution
MySQL Built-in
MariaDB Built-in
PostgreSQL Built-in
Amazon Redshift Built-in
CockroachDB Built-in
SQLite Built-in
ClickHouse Built-in
Redis Built-in
Microsoft SQL Server Plugin
MongoDB Plugin
Oracle Database Plugin
Dameng DM8 Plugin
DuckDB Plugin
Beancount Plugin
Cassandra / ScyllaDB Plugin
Etcd Plugin
Cloudflare D1 Plugin
DynamoDB Plugin
BigQuery Plugin
libSQL / Turso Plugin

Built-in drivers ship with the app. Plugin drivers install on demand from the plugin registry.

What's inside

  • SQL editor with autocomplete, multi-cursor, Vim mode, syntax themes
  • Data grid with inline editing, sort, filter, undo/redo
  • Native window tabs, multi-window, split panes
  • SSH tunnels with password and key authentication, SSL/TLS
  • Query history with full-text search
  • iCloud sync for connections, groups, tags, settings, and SSH profiles
  • AI chat, inline suggestions, and Explain/Optimize
  • MCP server and URL scheme for Raycast, Cursor, Claude Desktop
  • Plugin system, write your own database driver in Swift

Install

bash
brew install --cask tablepro

Or download from GitHub Releases.

How to Build

Building TablePro requires macOS 14 or later, Xcode 26 or later, and
XcodeGen.

Run the first-time setup from the repository root:

bash
brew install xcodegen
scripts/download-libs.sh
scripts/generate-project.sh

TablePro.xcodeproj is generated from project.yml and is not in git. Re-run
scripts/generate-project.sh after changing project.yml or Configs/, or after adding a
source file.

Build a Debug app without code signing:

bash
xcodebuild \
  -project TablePro.xcodeproj \
  -scheme TablePro \
  -configuration Debug \
  -skipPackagePluginValidation \
  CODE_SIGNING_ALLOWED=NO \
  build

The app is written to ~/Library/Developer/Xcode/DerivedData/TablePro-*/Build/Products/Debug/TablePro.app.

To build and run a signed app, put your Apple team and a unique bundle identifier in Configs/Secrets.xcconfig. See Building with a personal Apple team.

Documentation

Full docs at docs.tablepro.app.

Support development

The app is free under AGPLv3. If you use TablePro at work, please buy a license. Every purchase funds the next release. If you can't afford one, just use the free version. That's why it's free.

Sponsors

Thanks to these amazing people for supporting TablePro:

getapps.cafe ยท SimpleLocalize ยท CodeRabbit ยท Nimbus ยท Visnalize ยท Dwarves Foundation ยท Huy TQ ยท Xermius ยท Unikorn

Star History

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPLv3).


File: docs/README.md

TablePro Documentation

Source files for the TablePro documentation site, powered by Mintlify.

Structure

text
docs/
โ”œโ”€โ”€ index.mdx                # Introduction
โ”œโ”€โ”€ quickstart.mdx           # Getting started guide
โ”œโ”€โ”€ installation.mdx         # Installation instructions
โ”œโ”€โ”€ changelog.mdx            # Release changelog
โ”œโ”€โ”€ databases/               # Database connection guides
โ”œโ”€โ”€ features/                # Feature documentation
โ”œโ”€โ”€ customization/           # Settings and customization
โ”œโ”€โ”€ external-api/            # URL scheme, MCP, pairing
โ””โ”€โ”€ development/             # Developer documentation

Local Development

Install the Mintlify CLI and start the dev server:

bash
npm i mint
mint dev

Preview at http://localhost:3000.

Deployment

Changes pushed to the default branch are deployed automatically via the Mintlify GitHub app.