Skip to content

QueryaHub/Querya-Desktop

Repository files navigation

Querya Desktop

A lightweight, cross-platform desktop client for SQL and NoSQL databases.

Connect to PostgreSQL, MySQL/MariaDB, Redis, and MongoDB from a single app with a clean, dark UI inspired by tools like pgAdmin.

CI Release License: MIT Flutter Platforms


Highlights

  • Multi-database — PostgreSQL, MySQL/MariaDB, Redis, and MongoDB, with built-in Dart drivers (no JDBC JARs to download).
  • Cross-platform — Linux, Windows, and macOS from one Flutter codebase.
  • SQL workspace — query editor with syntax highlighting, configurable statement timeouts, query history, and CSV/JSON export.
  • Object browsing — connection tree with databases, tables, views, and server stats.
  • Themeable — dark/light/system, VS Code theme import, custom querya.theme.v1 registry, visual editor, remote install, and bundled themes (0.4.3).
  • Scalable UI — global interface scaling for high-DPI and accessibility.
  • Secure by default — passwords and connection strings live in the OS secure store, never in plaintext.

Screenshots

Add screenshots/GIFs to docs/assets/ and reference them here.

Quick start

# 1. Enable Flutter desktop for your platform
flutter config --enable-linux-desktop      # or --enable-windows-desktop / --enable-macos-desktop

# 2. Fetch dependencies
flutter pub get

# 3. Run
flutter run -d linux                        # or windows / macos

Linux builds also need keyring headers (libsecret-1-dev on Debian/Ubuntu). See Getting started for the full setup, including prerequisites, release builds, and your first connection.

Tech stack

  • Flutter (Dart) with desktop support.
  • shadcn_flutter for UI components and theming.
  • bitsdojo_window for the custom window frame.
  • Built-in Dart drivers: postgres, mysql_client, redis, mongo_dart.

Project structure

Path Description
lib/main.dart App entry, window setup.
lib/app/ App shell and theme wiring.
lib/core/ Database clients, storage, theme, layout, editor helpers.
lib/features/ Feature modules (main screen, connections, per-engine UI, settings).
lib/shared/ Reusable widgets shared across features.
assets/ Database type icons and other bundled assets.
linux/, windows/, macos/ Native runners.
third_party/ Vendored components (e.g. shadcn_flutter), under their own licenses.

For a deeper map of modules and their responsibilities, see Architecture.

Documentation

Full documentation lives in docs/:

Contributing

Contributions are welcome. Please read CONTRIBUTING.md for the workflow, CI expectations, and the pre-PR checklist, and see the Changelog for release history.

License

MIT. Third-party components (e.g. vendored UI under third_party/) retain their own licenses.

About

Querya-Desktop is a lightweight desktop application for working with SQL and NoSQL databases, designed with a clean and focused interface.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors