Name		Name	Last commit message	Last commit date
.github		.github
assets		assets
docker		docker
docs		docs
lib		lib
linux		linux
macos		macos
packaging		packaging
scripts		scripts
test		test
themes/samples		themes/samples
third_party		third_party
windows		windows
.gitignore		.gitignore
.metadata		.metadata
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
analysis_options.yaml		analysis_options.yaml
cleanup.py		cleanup.py
cliff.toml		cliff.toml
patch_theme.py		patch_theme.py
pubspec.yaml		pubspec.yaml
run_linux.sh		run_linux.sh

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.

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/:

Getting started — install and first run.
User guide — connections, preferences, drivers.
Architecture — codebase layout.
Security — local data and secrets.
Theme system · Theme import.
Roadmap · Releases.

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

Modern, open-source, high-performance cross-platform database studio for PostgreSQL, MySQL, SQLite, Redis, and MongoDB with 2D virtualized grid, DML staging buffer, and multi-session workspaces.