Skip to content

PostgresGUI/postgresgui

Repository files navigation

PostgresGUI - A native PostgreSQL client for macOS

PostgresGUI screenshot in dark mode

Version Platform

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

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

Contributors

Languages