whatisgithub

What is explain-plan?

tabularisdb/explain-plan — explained in plain English

Analysis updated 2026-07-26

2TypeScriptAudience · developerComplexity · 2/5Setup · moderate

In one sentence

A free, browser-based tool that visualizes database query plans as interactive graphs and tables. It works entirely offline in your browser, keeping sensitive database details private.

Mindmap

mindmap
  root((repo))
    What it does
      Visualizes database plans
      Detects performance issues
      Multiple view formats
    Supported databases
      PostgreSQL
      MySQL and MariaDB
      SQLite
    Tech stack
      Vite and React 19
      TypeScript
      Tailwind CSS
    Privacy
      Runs in browser only
      No server uploads
      Keeps schema private
    Use cases
      Optimize slow queries
      Understand query execution
      Share visual plan diagrams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Paste a PostgreSQL EXPLAIN ANALYZE output to see an interactive graph of the query execution plan.

USE CASE 2

Identify potential performance bottlenecks in a MySQL query by pasting its FORMAT=JSON plan.

USE CASE 3

Visually understand how SQLite executes a complex query without sending data to a server.

What is it built with?

TypeScriptReact 19ViteTailwind CSSpnpmVitest

How does it compare?

tabularisdb/explain-plan4ssh1/mine-sweeperachawla19/intuitcode-extension
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-01-31
MaintenanceMaintained
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 5min

Requires installing the pnpm package manager to install dependencies and run the local development server.

So what is it?

Explain Plan is a free, browser-based tool that helps people understand how databases run their queries. When you write a SQL query, the database creates an internal plan for executing it. This tool lets you paste that plan's output and see it as an interactive graph, diagram, table, and statistics view. It also flags potential performance issues automatically. The tool supports PostgreSQL, MySQL, MariaDB, and SQLite. Everything runs directly in your browser. No query is ever executed, and nothing you paste gets uploaded to a server. This matters because database query plans can contain sensitive information about your schema and data patterns. Running purely on the client side keeps that information private while still giving you the visual analysis you need. The tool accepts several input formats for each database engine. PostgreSQL users can paste JSON-formatted EXPLAIN output or plain text from EXPLAIN and EXPLAIN ANALYZE. MySQL and MariaDB users can provide FORMAT=JSON output or ANALYZE text trees. SQLite supports the shell tree format and raw row output. You can pick the database engine yourself, or the tool can detect it from the text you paste. The project is built with Vite, React 19, and TypeScript. It uses Tailwind CSS for styling with a custom dark theme. The core parsing and analysis engine comes from a separate package called @tabularis/explain, which powers a commercial product called Tabularis. Tests are written with Vitest and Testing Library. Development requires pnpm for installing dependencies and running commands like the local dev server, test suite, and production build. The site is a static single-page application, so deployment to Vercel needs no special configuration. SEO settings live in a JSON file that drives page titles, descriptions, social media cards, and structured data. A build-time plugin injects these tags into the HTML, so adjusting SEO never requires touching the application code itself.

Copy-paste prompts

Prompt 1
I have a PostgreSQL EXPLAIN ANALYZE output that is running slowly. Paste it here and help me identify the performance bottlenecks based on sequential scans or high cost nodes.
Prompt 2
Help me convert this MySQL query plan into a visual diagram so I can understand the join order and table access patterns.
Prompt 3
I pasted my SQLite query plan but I don't understand what the 'SEARCH TABLE' step means. Explain it simply.
Prompt 4
Generate a sample EXPLAIN ANALYZE output for a slow PostgreSQL query joining three tables so I can test a visual plan analyzer tool.

Frequently asked questions

What is explain-plan?

A free, browser-based tool that visualizes database query plans as interactive graphs and tables. It works entirely offline in your browser, keeping sensitive database details private.

What language is explain-plan written in?

Mainly TypeScript. The stack also includes TypeScript, React 19, Vite.

How hard is explain-plan to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is explain-plan for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.