Download
Visual Citus Workspace

Citus GUI Client for Windows, macOS, and Linux

VisuaLeaf is one visual workspace for Citus, the extension that turns PostgreSQL into a sharded cluster: browse distributed and reference tables as ordinary tables, build SQL against the coordinator, auto-draw ER diagrams from your foreign keys, and chart the results.

Free to start No credit card required Works on Windows, macOS and Linux
VisuaLeaf visual Citus workspace showing distributed tables, an ER diagram from foreign keys, and a JSONB tree side by side

Sharded Postgres Looks Like Postgres Until It Does Not

Citus keeps the coordinator speaking ordinary PostgreSQL while your data is split into shards across worker nodes. VisuaLeaf gives you a workspace over that: browse tables without minding where the shards live, and see the schema, the relationships and the results as pictures rather than catalog rows.

Which tables are distributed is not obvious

A distributed table, a reference table and a plain local table all look identical in a table list, and they behave nothing alike.

The distribution column decides everything

Whether a join stays on one node or crosses the cluster depends on a column choice made once at CREATE time and never shown again.

Shards live on nodes your query never names

The coordinator hides placement, which is the point — and it also means the physical layout is only ever a metadata query away rather than in front of you.

Foreign keys never draw themselves

Co-location is expressed through keys and constraints, so the relationships that make a sharded schema work are the ones nothing draws.

A visual workflow for Citus development

Browse distributed and reference tables, build SQL, map foreign keys into a diagram, and chart results — all in one workspace.

Built Around What Makes Citus Citus

Distributed tables, reference tables, standard PostgreSQL SQL, JSONB, and foreign keys, explored, queried, and visualized instead of parsed from text.

Table Management

Manage tables visually instead of hand-writing DDL. Add, rename, and edit columns with their types, defaults, primary keys, and foreign keys, then work across tabbed panels for indexes, constraints, and storage. Hit Show DDL to read the full CREATE TABLE statement any time.

Table management on a Citus cluster

JSONB Tree & Editor

Citus is PostgreSQL, so jsonb, json and array columns open as a nested tree. Inspect keys and arrays inline, filter with the ->, ->> and @> operators against GIN indexes, and edit nested values without hand-writing jsonb_set.

JSONB tree and editor on Citus

ER Diagrams from Foreign Keys

Auto-draw an interactive ER diagram from your real foreign keys and constraints across schemas, then drill into columns, indexes, constraints and CREATE statements. On a sharded schema this is the fastest way to see which tables are meant to travel together.

ER diagram from Citus foreign keys

A Visual Workflow for Everyday Citus Tasks

VisuaLeaf connects the steps Citus users usually handle separately: connect to the coordinator, explore distributed tables, build SQL, and visualize the results.

Built for Different Citus Users

Whether you build multi-tenant applications, scale a Postgres workload out, analyse data across shards, or learn SQL, VisuaLeaf gives you a clearer way to work with Citus.

Developers

Model tenant tables and their keys, and debug the SQL your app runs against real distributed rows.

Platform and Data Teams

Review schemas across environments, manage indexes and constraints, and keep a sharded schema consistent.

Data Analysts

Write JOINs and window functions across distributed tables, and chart the results without a separate BI pipeline.

Students and Beginners

Learn distributed Postgres visually, see foreign keys as ER diagrams, and read the SQL the builder writes.

Frequently Asked Questions

Is VisuaLeaf a good Citus GUI?
Yes. Citus is a PostgreSQL extension and the coordinator speaks the ordinary Postgres wire protocol, so VisuaLeaf connects with the standard Postgres driver: browse distributed, reference and local tables, expand JSONB in a tree, auto-generate ER diagrams from real foreign keys, build SQL visually, and chart the results.
How do I connect VisuaLeaf to a Citus cluster?
Connect to the coordinator node, not to a worker. The port is 5432 and the database is commonly citus, though managed offerings may name it differently. Use SSL or an SSH tunnel for anything not on your machine, and the whole logical schema is browsable from that single connection.
Can I browse tables that are sharded across worker nodes?
Yes. The coordinator presents the logical schema, so VisuaLeaf shows distributed tables as ordinary tables you browse, filter, page through and edit. Which node holds which shard stays where Citus keeps it, and you work with the table rather than with its placement.
Does the visual query builder support JOINs across distributed tables?
Yes. The visual builder covers SELECT, WHERE, JOIN, GROUP BY, ordering, and limits, and generates standard PostgreSQL that the coordinator plans and distributes. Every query has an export-to-SQL button, so you keep clean, editable SQL you can tune by hand.
Can I use VisuaLeaf with Azure Cosmos DB for PostgreSQL?
Yes. Azure Cosmos DB for PostgreSQL is Citus, and it is reached the same way: connect to the coordinator with the host, port, database and credentials from the portal, over SSL. The database is typically named citus on those clusters.
Does VisuaLeaf generate ER diagrams from a Citus schema?
Yes. VisuaLeaf reads foreign keys, primary keys, and constraints from the information_schema to auto-draw an interactive ER diagram across schemas, which on a sharded schema is the quickest way to see which tables are keyed to travel together.
Which platforms does VisuaLeaf run on?
VisuaLeaf ships native builds for Windows, macOS, and Linux, so your whole team can work with Citus in the same visual tool. It also connects to MongoDB, PostgreSQL, MySQL, MariaDB, SQL Server, and SQLite from a single workspace.

More Than a Citus Client

VisuaLeaf started as a MongoDB workspace and grew into a multi-database visual environment. One app, one workflow, across the databases your team actually uses.

And VisuaLeaf does not leave you staring at a wall of SQL and grids. It visualizes everything — Citus schemas become interactive diagrams, queries become visual builders, and results become charts and dashboards.

MongoDB MySQL MariaDB SQL Server Azure Cosmos DB Amazon DocumentDB SQLite

Built by Developers, For Developers

VisuaLeaf is made by an independent software studio that ships often and listens to the developers who use it every day.

Ready to Work Visually with Citus?

Download VisuaLeaf Community Edition and browse distributed tables, build SQL against the coordinator, draw ER diagrams from your foreign keys, and chart your results in one visual workspace.

Download Free Community Edition
No credit card required
VisuaLeaf Citus charts and dashboards built from query results