Skip to content

Latest commit

Β 

History

1,574 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Querya Desktop

The Modern, High-Performance Database Studio for Engineers & Teams

Fast, lightweight, and secure database management environment for PostgreSQL, MySQL, MariaDB, SQLite, Redis, and MongoDB.

CI Status Release Status Latest Release License: MIT Open Source Flutter Desktop Platforms Security: Hardware Encrypted Zero Telemetry

Overview β€’ Key Capabilities β€’ Supported Engines β€’ Feature Matrix β€’ Installation β€’ Architecture β€’ Security & Privacy β€’ Docs


Overview

Querya Desktop is a modern, open-source database management studio engineered from the ground up for speed, safety, and developer ergonomics. Built on Flutter and Dart, Querya provides a native, hardware-accelerated desktop experience across Linux, Windows, and macOS with zero JVM overhead and zero external telemetry.

Whether you are navigating multi-million row datasets, authoring complex analytical SQL, inspecting nested NoSQL documents, or managing distributed key-value caches, Querya provides a unified, cohesive, and distraction-free interface.


Key Capabilities

⚑ Ultra-Fast 2D Virtualized Data Grid

  • $O(1)$ Viewport Rendering: Handle large datasets smoothly at 60/120+ Hz with a strictly bounded memory footprint. Only visible cells are rendered to the screen.
  • Adaptive Content-Aware Column Sizing: Automatically calculates optimal column widths based on sample data rows and header lengths.
  • Header Double-Click Auto-Fit: Double-click column dividers or trigger auto-fit to resize columns instantly to fit their contents.
  • Background Isolate Sorting & Filtering: Multi-type column sorting with Schwartzian transforms executed in dedicated background worker isolates, keeping the UI silky smooth.
  • Streaming Exporter: Stream table data directly to CSV, JSON, or executable SQL INSERT statements.

✍️ Interactive In-Place DML Staging Buffer

  • Safe Transactional Editing: Edit cells directly within the grid with real-time data type validation (integers, floats, booleans, timestamps, UUIDs, and JSON).
  • Atomic DML Generation: Querya tracks modifications (UPDATE, INSERT, DELETE) in a dedicated staging buffer, generating dialect-accurate SQL statements.
  • Review Before Execution: Inspect generated SQL diffs with primary-key safety checks, row counts, and single-click commit or rollback.

πŸ—‚οΈ Multi-Tab SQL Studio & Independent Sessions

  • Isolated Query Sessions: Open multiple SQL workspace tabs simultaneously, each maintaining its own query buffers, transactions, and execution state.
  • Cancellable Async Execution: Run heavy analytical queries without freezing the client, with responsive cancellation and live execution timers.
  • Universal Multi-Dialect Syntax Highlighting: Real-time token highlighting for keywords, operators, strings, comments, and identifiers across all SQL dialects.
  • Searchable Query History: Quickly recall, re-run, or inspect past executions with execution durations and status codes.

πŸ” Deep Schema Explorer & Quick-Search

  • Debounced Instant Object Filter: Rapidly filter schemas, tables, views, columns, indexes, and stored procedures.
  • Favorites & Pinning (⭐): Pin mission-critical tables and collections to the top of your connection tree for instant access.
  • Live Connection Telemetry: View server version, active connections, uptime, memory consumption, and engine statistics.

πŸ”¬ Rich Cell & Payload Inspector

  • Structured Pretty-Printers: Inspect complex cell values in dedicated preview panes with automatic formatting and syntax validation for JSON, XML, and HTML.
  • Raw Hex / Binary Viewer: Inspect BLOBs, binary hashes, and raw payloads with side-by-side hex and ASCII representations.

πŸ”’ Security & Privacy by Design

  • Hardware-Backed Credential Vaults: Connection passwords and keys are never stored in plaintext. Querya integrates directly with native OS credential stores (Freedesktop Secret Service / Keyring on Linux, Apple Keychain on macOS, and Windows DPAPI Credential Manager).
  • In-Memory Secret Scrubbing: Sensitive credentials are cleansed from memory after connection handshakes.
  • Air-Gapped & Zero Telemetry: Absolutely zero telemetry, zero analytics, and zero external calls. Your database credentials and queries never leave your local machine.

πŸ”Œ Native & Pluggable Driver Architecture

  • Pure Native Drivers: High-performance built-in drivers for PostgreSQL, MySQL/MariaDB, SQLite, Redis, and MongoDB with no external runtime dependencies or JDBC configurations.
  • JSON-RPC 2.0 Driver Sandbox: Extend Querya with custom community or proprietary database drivers via sandboxed standard I/O RPC bridges.

🎨 Desktop Ergonomics & Custom Themes

  • OS File Associations: Native file handler integration with .sql, .db, .sqlite, and .sqlite3 files. Double-click any database or SQL script in your file manager to open it immediately.
  • Comprehensive Keymap: Complete keyboard navigation for executing queries, switching tabs, focusing panels, and searching objects.
  • VS Code Theme Importer: Import any .json VS Code theme or choose from bundled dark/light palettes.

Supported Engines

Database Engine Versions Tested Connection Types Security / TLS Status
PostgreSQL 12, 13, 14, 15, 16, 17+ Direct TCP / Unix Socket SSL / TLS (Verify-Full, CA Certs) Production
MySQL / MariaDB MySQL 5.7, 8.0+, MariaDB 10.x+ Direct TCP / Socket SSL / TLS, Custom Ciphers Production
SQLite SQLite 3.x Local File / In-Memory File Permissions / Encryption Production
Redis 6.x, 7.x+ Standalone / Auth TLS / Sentinel Production
MongoDB 5.0, 6.0, 7.0+ Standalone / Replica Set TLS / X.509 / SCRAM-SHA-256 Production
Custom Plugins Any JSON-RPC 2.0 stdio Bridge Host-Managed Sandbox Extensible

Feature Matrix

Feature Area Querya Desktop Legacy Desktop Clients Web-Based Portals
Runtime Overhead Zero JVM (Native Flutter / Dart) Heavy (~1–2 GB JVM/Electron) Browser Tab Memory Limits
Data Grid Architecture 2D Virtualized ($O(1)$ Memory) Paginated or Unbounded Heap DOM Virtualization Limits
In-Place Cell Editing Yes (DML Staging & Preview) Often Direct or Unchecked Read-Only or Manual Forms
Multi-Tab SQL Sessions Yes (Isolated Sessions) Varies Limited by Tab Lifecycles
Local SQLite File Association Native (.db, .sqlite, .sqlite3) Partial Requires Server Upload
Complex Cell Inspector JSON / XML / HTML / Hex-Binary Basic String View Basic Textarea
Credential Storage Hardware OS Vault (Keyring/Keychain/DPAPI) Insecure Plaintext XML/JSON Stored on Remote Server
Telemetry & Privacy Zero Tracking (100% Offline Capable) Opt-out Phone Home Full Cloud Telemetry
Startup Time < 1.0s Instant Cold Start 10–30s JVM Warmup Network Dependent

Installation

Linux

Download the latest .deb, .AppImage, or .tar.gz from Releases:

# Debian / Ubuntu (.deb)
sudo dpkg -i querya-desktop-linux-amd64.deb
sudo apt-get install -f

# AppImage (Standalone executable)
chmod +x querya-desktop-*.AppImage
./querya-desktop-*.AppImage

Note: Linux builds utilize libsecret-1 for OS-level credential protection. Ensure libsecret-1-0 is installed on your system.

Windows

Download the Windows installer (.exe) or portable archive (.zip) from Releases. Run the setup to automatically register .sql and .sqlite file associations.

macOS

Download the universal .dmg from Releases, mount the disk image, and drag Querya into your Applications folder.


Building from Source

Prerequisites

  • Flutter SDK (Version 3.24+ / Dart 3.5+)
  • C/C++ compiler toolchain (GCC / Clang on Linux, MSVC on Windows, Xcode on macOS)
  • Linux development libraries (Debian/Ubuntu):
    sudo apt-get update
    sudo apt-get install -y clang cmake ninja-build pkg-config libgtk-3-dev libsecret-1-dev

Build Steps

# 1. Clone repository
git clone https://github.com/QueryaHub/Querya-Desktop.git
cd Querya-Desktop

# 2. Fetch dependencies
flutter pub get

# 3. Run in development mode
flutter run -d linux       # or: windows / macos

# 4. Build release bundle
flutter build linux --release
# Output: build/linux/x64/release/bundle/

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                           Querya Desktop Shell                          β”‚
β”‚          (bitsdojo_window, Multi-Tab Workspaces, Command Router)        β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚        UI & Presentation          β”‚           State & Sessions          β”‚
β”‚ β€’ 2D Virtual Data Grid            β”‚ β€’ Connection Session Pool           β”‚
β”‚ β€’ Interactive In-Place Editor     β”‚ β€’ Isolated Query Workspaces         β”‚
β”‚ β€’ Rich Cell Inspector (JSON/Hex)  β”‚ β€’ DML Staging Buffer & Safety Guard β”‚
β”‚ β€’ Schema Tree & Quick Search      β”‚ β€’ Query Execution & Audit History   β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚                          Core & Engine Adapters                         β”‚
β”‚ β€’ PostgreSQL (TLS/Pooling)        β”‚ β€’ SQLite FFI (File & Memory)        β”‚
β”‚ β€’ MySQL / MariaDB (Native Wire)   β”‚ β€’ MongoDB BSON Engine               β”‚
β”‚ β€’ Redis (RESP Client)             β”‚ β€’ Extensible JSON-RPC 2.0 Driver    β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚                     Platform Abstraction & Security                     β”‚
β”‚ β€’ OS Hardware Vault (Secret Service / Apple Keychain / Windows DPAPI)   β”‚
β”‚ β€’ Desktop File Handlers (.sql, .db, .sqlite, .sqlite3)                  β”‚
β”‚ β€’ Windowing & High-DPI Scaler Engine                                    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

For detailed component documentation and sequence diagrams, refer to Architecture Guide.


Security & Privacy

Querya is engineered with complete open-source transparency, strict privacy, and air-gapped security by design:

  1. Native OS Credential Stores: Credentials are never written to disk in plain text or reversible base64. They are delegated to:
    • Linux: Freedesktop Secret Service API (libsecret / GNOME Keyring / KWallet).
    • macOS: Apple Keychain Services.
    • Windows: Windows Data Protection API (DPAPI) and Windows Credential Manager.
  2. In-Memory Hygiene: Sensitive strings are dereferenced and purged from memory immediately following authentication handshakes.
  3. Zero Telemetry & Air-Gapped Ready: Querya emits no network telemetry, analytics pings, or telemetry metrics. It can be safely deployed within isolated VPCs, financial infrastructure, and defense networks.
  4. Transport Security: Full support for TLS/SSL certificates, client keys, and certificate authorities across all network-backed drivers.

See Security Architecture Documentation for further details.


Documentation

Comprehensive guides and technical documentation are available in the docs/ directory:

  • Getting Started β€” Installation, dependencies, and connecting to your first database.
  • User Guide β€” Navigation, workspaces, query execution, and preferences.
  • Architecture β€” Codebase structure, data flow, and module boundaries.
  • Theme System & Theme Importer β€” Custom themes and VS Code theme parser.
  • Security Overview β€” Local storage, encryption, and credential lifecycle.
  • Roadmap β€” Product roadmap and upcoming releases.

Contributing

We welcome contributions from the community. Please review our Contributing Guide for:

  • GitFlow branch model (issue/<id>-<slug> βž” dev βž” main)
  • Conventional Commits specification
  • Automated testing and static analysis requirements (flutter analyze, flutter test)

License

Querya Desktop is open-source software licensed under the MIT License. Third-party components and libraries retain their respective 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.

Topics

Resources

Contributing

Security policy

Stars

21 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages