Skip to main content
QueryBox Hero Light

​
What is QueryBox?

QueryBox is a modern desktop database client that brings a fresh approach to database management. Unlike traditional tools that bundle all database drivers into a monolithic application, QueryBox uses a plugin-based architecture where each database protocol is handled by lightweight, standalone executables.
QueryBox is currently in active development and has not been officially released. Features and capabilities are subject to change.

​
Key Features

Plugin-Based Architecture

Each database driver runs as a separate, lightweight executable. Add support for new databases without rebuilding the entire application.

Multi-Database Support

Connect to MySQL, PostgreSQL, SQLite, Redis, ArangoDB, and more. Each plugin provides native support for its specific database features.

Secure Credential Management

3-tier credential storage system with OS keyring integration, encrypted SQLite fallback, and secure in-memory storage as a last resort.

Interactive Query Execution

Execute queries with syntax highlighting, view results in multiple formats, and navigate database objects through an interactive tree browser.

Built with Wails v3

Native desktop performance powered by Wails v3 and Vue 3. Cross-platform support for Windows, macOS, and Linux.

Extensible & Language-Agnostic

Write plugins in any language. The simple stdin/stdout JSON protocol means you can create database drivers in Go, Python, Rust, or anything else.

​
How It Works

QueryBox takes a unique approach to database connectivity:
1

Plugin Discovery

At startup, QueryBox scans the bin/plugins/ directory and discovers all available database drivers. Each plugin registers itself by responding to an info command.
2

Connection Management

When you create a new connection, QueryBox stores metadata in SQLite and delegates credentials to the secure CredManager, which uses your OS keyring when available.
3

Query Execution

When you run a query, QueryBox spawns the appropriate plugin as a subprocess, sends your query via JSON over stdin, and receives structured results via stdout.
4

Process Lifecycle

Each query execution is a fresh process—no persistent connections means better resource management and isolation between queries.

​
Architecture Overview

QueryBox consists of three main components:

​
Core Services (Go)

  • App Service: Window management and application lifecycle
  • ConnectionService: Connection CRUD operations with SQLite persistence
  • CredManager: 3-tier secure credential storage (OS keyring → encrypted SQLite → memory)
  • PluginManager: Plugin discovery, registry, and on-demand execution

​
Plugin System

Plugins are standalone executables that implement a simple command-line interface:
  • info - Returns plugin metadata (name, version, capabilities)
  • exec - Executes a query and returns results
  • authforms - Provides structured authentication forms for the UI
  • connection-tree - Returns a hierarchical database object tree
  • test-connection - Tests connection validity before saving

​
Frontend (Vue 3)

Built with Vue 3, Naive UI, and Tailwind CSS, the frontend provides:
  • Rich query editor with syntax highlighting
  • Interactive database object browser
  • Multiple result view formats (table, JSON, raw)
  • Connection management UI with tabbed auth forms
  • Plugin management and discovery interface

​
Built-in Database Support

QueryBox ships with plugins for the most popular databases:
Full support for MySQL and MariaDB with:
  • TLS/SSL connections
  • Interactive schema browser
  • EXPLAIN query analysis
  • Connection tree navigation (databases → tables → columns)
Complete PostgreSQL driver featuring:
  • Schema and table browsing
  • EXPLAIN query support
  • Full SSL/TLS support
  • Connection pooling
Dual-mode SQLite support:
  • Local file databases using modernc.org/sqlite
  • Turso Cloud remote databases using go-libsql
  • Interactive table and index browsing
Redis support with:
  • Basic authentication (host/port/password/db)
  • URL-based connection strings
  • Key-value result formatting
Multi-model database support:
  • Document store queries
  • Graph database operations
  • Basic authentication

​
Why Choose QueryBox?

Lightweight & Fast

No bloated runtimes or heavy frameworks. Each plugin is a single executable, and queries run in isolated processes with automatic cleanup.

Secure by Design

Credentials never touch disk in plaintext. OS keyring integration means your passwords are protected by the same security as your system passwords.

Developer-Friendly

Simple plugin contract means you can add support for any database in an afternoon. No complex SDKs or frameworks required.

Cross-Platform

Built with Wails v3, QueryBox runs natively on Windows, macOS, and Linux with a consistent experience across all platforms.

​
Next Steps

Installation Guide

Get QueryBox installed on your system

Quick Start

Connect to your first database and run queries