Skip to content
michellzappaPublic

About

Native macOS PostgreSQL browser. Pick a table, see its rows in a sortable grid. Read-only by design. Part of TinySuite.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

TinySQL

A native macOS PostgreSQL browser. Pick a table, see its rows in a sortable grid. Pure Swift, zero dependencies, read-only by design.

macOS Swift

TinySQL screenshot

Features

  • Connect to PostgreSQL — host, port, database, username, password
  • Table browser — sidebar list of tables from your public schema
  • Sortable grid — click columns to sort ascending or descending
  • NULL styling — null values displayed with dimmed text
  • Pagination — 100 rows per page for large tables
  • Query timing — query time and row count in the status bar
  • Connection persistence — remembers your last connection
  • Multiple connections — switch between saved databases
  • Pure Swift — no PostgreSQL drivers or C libraries required
  • On-device AI — Cmd+K to ask questions about your data (CoreML, fully offline)
  • Light & dark mode — follows system appearance

Requirements

  • macOS 26.0+
  • Xcode 26+ (to build)

Build

xcodegen generate --spec project.yml

xcodebuild clean build \
  -project TinySQL.xcodeproj \
  -scheme TinySQL \
  -configuration Release \
  -derivedDataPath /tmp/tinybuild/tinysql \
  CODE_SIGN_IDENTITY="-"

rm -rf /Applications/TinySQL.app
cp -R /tmp/tinybuild/tinysql/Build/Products/Release/TinySQL.app /Applications/
xattr -cr /Applications/TinySQL.app

Keyboard Shortcuts

Shortcut Action
Cmd+N New connection
Cmd+K AI assistant
Cmd+Control+S Toggle sidebar

Tech

Built with SwiftUI, PostgresNIO, and TinyKit.

Part of TinySuite

Native macOS micro-tools that each do one thing well.

App What it does
TinyMark Markdown editor with live preview
TinyTask Plain-text task manager
TinyJSON JSON viewer with collapsible tree
TinyCSV Lightweight CSV/TSV table viewer
TinyPDF PDF text extractor with OCR
TinyLog Log viewer with level filtering
TinySQL Native PostgreSQL browser

License

MIT

About

Native macOS PostgreSQL browser. Pick a table, see its rows in a sortable grid. Read-only by design. Part of TinySuite.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages