View, edit, and visualise Entity Relationship Diagrams (.erd.json) for Microsoft Dataverse and SQL Server right inside VS Code. Click any .erd.json in the Explorer to open the visual editor; mappings between two ERDs (.erdmap.json) are supported via the same custom editor.
Features
- Custom editor for
.erd.json— opens from the Explorer like any other file. Edit visually; saves through the document write back to disk via VS Code's normal save flow. - Mapping containers (
.erdmap.json) — opening one drops you into Split View with both ERDs side by side and column-mapping support. - Imports — Dataverse solution
.zip, dineug/erd-editor JSON, MermaiderDiagram. - Exports — native
.erd.json, mapping.erdmap.json, mapping → Markdown. - Demo data generation with FK-respecting topological sort.
Working with remote repositories
The extension treats .erd.json files as local files in your workspace. Use VS Code's built-in Source Control panel and integrated terminal to clone, commit, and push:
- GitHub / Azure DevOps clone:
Ctrl+Shift+P→Git: Clone. - Commit + push: standard VS Code Source Control workflow.
The extension itself does not implement remote-repository integration — that's VS Code's job, and it does it better.
Requirements
- VS Code 1.85 or newer.
- A workspace folder containing
.erd.json(or runDataverse ERD: New Diagramto create one).
Getting started
- Install the extension.
- Open a folder that contains
.erd.jsonfiles (or runDataverse ERD: New Diagramfrom the command palette). - Click any
.erd.jsonin the Explorer — the visual editor opens automatically. - For two-way column mapping: open an
.erdmap.jsonfile, or runDataverse ERD: Open Split Viewand pick two ERDs.
Commands
Dataverse ERD: New Diagram— create a fresh empty ERD in the workspace folder.Dataverse ERD: Open Split View— open two ERDs side-by-side for column mapping.
Privacy
The extension runs entirely on your machine. The only outbound network calls happen when you explicitly use the Import from Dataverse... feature, which authenticates against your Dataverse environment.
No telemetry, no analytics, no third-party hosts.