whatisgithub

What is drawdb-collaborative?

yms2772/drawdb-collaborative — explained in plain English

Analysis updated 2026-05-18

4JavaScriptAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A self hosted, real-time collaborative database diagram editor that lets multiple people edit the same ERD live, forked from the drawDB project.

Mindmap

mindmap
  root((drawDB Collaborative))
    What it does
      Live diagram editing
      Shared cursors
      SQL import export
    Tech stack
      JavaScript
      SQLite
      WebSocket
    Use cases
      Team schema design
      Self-hosted tool
      Docker deployment
    Audience
      Developers
      Teams

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

Design a database schema together with teammates in real time in the browser.

USE CASE 2

Self-host a shared diagram editor instead of relying on a hosted SaaS tool.

USE CASE 3

Import and export SQL alongside visual entity relationship diagrams.

USE CASE 4

Deploy a single Docker container that serves the frontend, API, and live collaboration.

What is it built with?

JavaScriptReactSQLiteWebSocketDocker

How does it compare?

yms2772/drawdb-collaborativeamirmahdavi2023/d1-adminanil-matcha/open-poe-ai
Stars444
LanguageJavaScriptJavaScriptJavaScript
Last pushed2026-06-25
MaintenanceActive
Setup difficultymoderateeasymoderate
Complexity4/52/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Self-hosting requires Docker or Node.js plus SQLite storage, a reverse proxy needs WebSocket headers forwarded.

You must share the source code of any modified version you run as a network service with its users.

So what is it?

drawDB Collaborative is a self hosted, browser based tool for designing database diagrams, sometimes called entity relationship diagrams, together with other people in real time. It is an independently maintained fork of the original drawDB project, meaning it started from that project's code and added new features, but it is not officially connected to or endorsed by the original drawDB maintainers. The main addition in this fork is turning drawDB from a single user, browser only tool into a shared, live collaborative one. Instead of storing diagrams only in the browser, this version stores them centrally in a SQLite database, so multiple people opening the same diagram link automatically join the same live session. Changes such as moving or editing a table appear for everyone in real time over a WebSocket connection, and each participant's cursor and current view are visible to others. To prevent one person's changes from silently overwriting another's, the app checks a version number before saving and gives an outdated client the current version instead of letting it overwrite newer work. The project keeps drawDB's original browser based diagram editing and its ability to import and export SQL. Everything needed to run it, including the web interface, the backend API, the WebSocket server for live updates, and the SQLite storage, is packaged into a single container, which can be started with one Docker command. For development without Docker, it can also be run locally using npm, starting a frontend server and a separate API and WebSocket server. The application exposes a small set of API endpoints for creating, reading, updating, and deleting diagrams, plus a WebSocket endpoint for the live collaboration itself. When deployed behind a reverse proxy, it needs certain headers forwarded so the WebSocket connections work correctly. The project is released under the GNU Affero General Public License version 3, meaning that anyone running a modified version of it as a network service must make that version's source code available to users of that service.

Copy-paste prompts

Prompt 1
Help me run drawdb-collaborative locally with npm install and npm run dev.
Prompt 2
Walk me through deploying this with docker compose up --build.
Prompt 3
Explain how the optimistic version check prevents diagram edits from overwriting each other.
Prompt 4
What headers do I need to forward on my reverse proxy for the WebSocket collaboration to work?

Frequently asked questions

What is drawdb-collaborative?

A self hosted, real-time collaborative database diagram editor that lets multiple people edit the same ERD live, forked from the drawDB project.

What language is drawdb-collaborative written in?

Mainly JavaScript. The stack also includes JavaScript, React, SQLite.

What license does drawdb-collaborative use?

You must share the source code of any modified version you run as a network service with its users.

How hard is drawdb-collaborative to set up?

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

Who is drawdb-collaborative for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.