## File: README.md

<h1 align="center">TablePro</h1>











---



## 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](https://github.com/TableProApp/plugins).

## 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](https://github.com/TableProApp/TablePro/releases).

## How to Build

Building TablePro requires macOS 14 or later, Xcode 26 or later, and
[XcodeGen](https://github.com/yonaskolb/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](CONTRIBUTING.md#building-with-a-personal-apple-team).

## Documentation

Full docs at [docs.tablepro.app](https://docs.tablepro.app).

## Support development

The app is free under AGPLv3. If you use TablePro at work, please buy a [license](https://tablepro.app). 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](https://getapps.cafe/?ref=SJO7-TgA)** · **[SimpleLocalize](https://simplelocalize.io?ref=tablepro)** · **[CodeRabbit](https://coderabbit.ai?ref=tablepro)** · **[Nimbus](https://getnimbus.io?ref=tablepro)** · **[Visnalize](https://visnalize.com?ref=tablepro)** · **[Dwarves Foundation](https://dwarves.foundation/?ref=tablepro)** · **[Huy TQ](https://github.com/imhuytq)** · **[Xermius](https://xermius.com?ref=tablepro)** · **[Unikorn](https://unikorn.vn?ref=tablepro)**

## Star History

<a href="https://www.star-history.com/?repos=TableProApp%2FTablePro&type=date&legend=top-left">
 
   
   
   
 
</a>

## License

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

---

## File: docs/README.md

# TablePro Documentation

Source files for the [TablePro documentation site](https://docs.tablepro.app), powered by [Mintlify](https://mintlify.com).

## Structure

```
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](https://www.npmjs.com/package/mint) 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](https://dashboard.mintlify.com/settings/organization/github-app).