Dependinator

KO | EN

gitlite — search

#react #ai #typescript #llm #golang #android #deep-learning #docker #windows #awesome #kubernetes #vue #ios #mcp

(★ 8)

Visualizes code structure and dependencies in a map-like interface to make it easier to understand and refactor the architecture.

Dependinator Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Dependinator

[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/michaelreichenauer.dependinator?label=VS%20Code%20Marketplace)](https://marketplace.visualstudio.com/items?itemName=michaelreichenauer.dependinator)
[![Installs](https://img.shields.io/visual-studio-marketplace/i/michaelreichenauer.dependinator)](https://marketplace.visualstudio.com/items?itemName=michaelreichenauer.dependinator)

Dependinator visualizes the structure and dependencies of your C#/.NET
codebase as an interactive, navigable map, making complex architectures easier
to understand, analyze, and refactor. It is published as a
[VS Code extension](https://marketplace.visualstudio.com/items?itemName=michaelreichenauer.dependinator)
on the Visual Studio Marketplace.

> ⚠️ **Beta** — Dependinator is under active development and published as an
> early preview for a small group of testers. Expect rough edges, missing
> features, and breaking changes between versions. It is not yet a finished
> product.

![Dependinator in action: navigating to a node with search and exploring its dependencies in the Dependencies explorer](https://raw.githubusercontent.com/michael-reichenauer/Dependinator/main/src/DependinatorVsCode/resources/demo.gif)

## Features

- **Interactive dependency map** — explore your codebase as a zoomable,
  navigable diagram instead of scrolling through files.
- **Drill down and back up** — open nodes to see their internals
  (namespaces, types, members) and follow dependencies between components.
- **Jump to code** — navigate from a node or dependency straight to the
  corresponding source location.
- **Automatic refresh** — the map updates automatically when source files
  change.
- **Manual editing** — add your own nodes and links (drag from a node to
  create a link), delete manual links, and start from an empty model to
  sketch an architecture by hand.
- **Multiple models** — create, switch between, and delete models from the
  app menu.
- **Icon library** — pick icons for nodes, including curated Azure, AWS,
  and Google cloud-service icons.
- **Export as image** — save the current diagram as an image.
- **Optional device sync** — enable device sync to keep your models updated
  on all devices that have sync enabled, including the web app at
  [dependinator.com](https://dependinator.com).

## Try it

- **VS Code extension** — install
  [Dependinator](https://marketplace.visualstudio.com/items?itemName=michaelreichenauer.dependinator)
  from the Visual Studio Marketplace (search for "Dependinator" in the
  Extensions view) and run **Dependinator: Open** in a workspace with a
  `.sln` file. This is the primary way to use Dependinator: parse your
  code and create, edit, and view models. See
  [src/DependinatorVsCode/README.md](src/DependinatorVsCode/README.md)
  for details.
- **Web app** — [dependinator.com](https://dependinator.com) is the
  companion app for viewing your models outside VS Code (editing works
  too, but viewing is its primary use case). Enable device sync in both
  the extension and the web app to see your models from wherever you
  like — or just try the built-in demo model without signing in.

In the app, the **Help** button in the app bar opens a page with usage
instructions, navigation tips, and keyboard/mouse controls.

---

# Development

This repo contains the shared UI and core logic plus multiple hosts (Blazor
Server, Blazor WebAssembly), an Azure Functions API used for cloud sync, and
the VS Code extension.

## Solution structure

`Dependinator.sln` (targeting `net10.0`, SDK pinned in `global.json`) stays at the repo root; production project folders live under `src/` and test projects under `tests/`. Dependency direction is `Hosts → UI → Core → Shared` (with `Roslyn → Core`), enforced by `tests/Dependinator.Architecture.Tests/`.

**Hosts:**
- `src/Dependinator.Web/`: Blazor Server host for local development.
- `src/Dependinator.Wasm/`: Blazor WebAssembly host (Azure Static Web Apps target) and Web UI for the VS Code extension.
- `src/Dependinator.Lsp/`: LSP server executable.
- `src/Api/`: Azure Functions API for cloud sync.

**Libraries:**
- `src/Dependinator.UI/`: Shared UI (`App/`, `Diagrams/`, `Modeling/`).
- `src/Dependinator.Core/`: Core parsing, domain logic, models, and utilities.
- `src/Dependinator.Roslyn/`: Roslyn-based parsing.
- `src/Shared/`: Shared DTOs/models between client and API.

**Tests:**
- `tests/Dependinator.UI.Tests/`, `tests/Dependinator.Core.Tests/`, `tests/Dependinator.Roslyn.Tests/`, `tests/Dependinator.Lsp.Tests/`, `tests/Api.Tests/`: xUnit unit tests.
- `tests/Dependinator.Architecture.Tests/`: NetArchTest layering guards.
- `tests/Dependinator.E2E.Tests/`: Playwright UI tests (run via `./scripts/e2e`).

**VS Code extension** (not part of `Dependinator.sln`):
- `src/DependinatorVsCode/`: TypeScript extension packaging the web UI + language server.

## Prerequisites

- **.NET SDK 10.0.101** (pinned in `global.json`).
- **Node.js + npm** — for the VS Code extension and SWA CLI.
- **Azurite** (`npm i -g azurite`) — local Azure Storage emulator, needed by `./scripts/watch` and `./scripts/run`.
- **Azure Functions Core Tools** (`func`) — needed by `./scripts/watch` and `./scripts/run`.
- **SWA CLI** (`npm i -g @azure/static-web-apps-cli`) — needed by `./scripts/run`.
- **Playwright browsers** — for `./scripts/e2e`.

The devcontainer (`.devcontainer/`) provisions the .NET SDK, Node, `func`, and Playwright browsers out of the box. **Azurite** and the **SWA CLI** are not preinstalled — add them with the `npm i -g` commands above if you need `./scripts/watch` or `./scripts/run`.

## Quick start
- Build: `./scripts/build`
- Run server (live dev, with cloud sync): `./scripts/watch`
- Run WASM + API + Azurite locally: `./scripts/run`
- Unit tests: `dotnet test Dependinator.sln`
- UI/e2e tests: `./scripts/e2e` (chromium; `-a` for all browsers)
- All tests (unit + e2e): `./scripts/test`

## Cloud sync

Cloud sync uses [Clerk](https://clerk.com) for authentication (magic links / email OTP). The API validates Clerk-issued JWTs via JWKS.

### Azure Static Web Apps deployment

- See `swa-cli.config.json` for the `dependinator-test` configuration.
- Required Static Web App application settings:
  - `CloudSync__ClerkIssuer`
  - `CloudSync__ContainerName`
  - `CloudSync__MaxUserQuotaBytes`
  - `CloudSync__StorageConnectionString`

### VS Code extension

- The `dependinator.cloudSync.baseUrl` setting controls which API endpoint the extension uses.
- The extension serves a local Clerk sign-in page and stores the session JWT in VS Code secrets.

## License

MIT — see [LICENSE](LICENSE).

Dependinator

Dependinator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Dependinator

Dependinator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README