PostgresGUI - A native PostgreSQL client for macOS

NOTE 01/30/2026

A fix is being pushed to the App Store to address the inconsistent data display issue reported here: https://github.com/PostgresGUI/postgresgui/issues/20. There are also improvements and features such as the table schema dropdown and saved query caching by NeodymiumPhish. — Ghazi

Getting started

1. Clone the repository:

   git clone https://github.com/PostgresGUI/app.git
   cd app
   

2. Open the project in Xcode:

   open PostgresGUI.xcodeproj
   

3. Configure code signing:

   • Select the PostgresGUI target in the project navigator
   • Go to Signing & Capabilities tab
   • Select your Team from the dropdown (use your Apple ID's "Personal Team" if you don't have a paid developer account)

4. Build and run with Cmd+R

Submitting Pull Requests

When you select your team in step 3, Xcode modifies project.pbxproj with your team ID. Do not include this change in your pull request.

Why Code Signing is Required

This app uses macOS Keychain to securely store database passwords. Keychain access requires a valid code signature, so even local development builds need to be signed with your team ID.

Support

• Visit postgresgui.com/support for help and documentation
• Report bugs on GitHub Issues

Acknowledgments

PostgresGUI is built on the shoulders of giants. Special thanks to:

• The PostgresNIO team for the excellent PostgreSQL client library
• The Swift NIO project for the networking foundation