<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Ryan Huff</title>
    <description>The latest articles on DEV Community by Ryan Huff (@networknerd1337).</description>
    <link>https://dev.to/networknerd1337</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4247611%2F54daadf9-317c-4f1d-9854-dfaba023fbd3.jpg</url>
      <title>DEV Community: Ryan Huff</title>
      <link>https://dev.to/networknerd1337</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/networknerd1337"/>
    <language>en</language>
    <item>
      <title>NerdGram1337 v1.4.2: Compare, Baselines, and Find and Replace for Mermaid Diagrams</title>
      <dc:creator>Ryan Huff</dc:creator>
      <pubDate>Mon, 16 Nov 2026 11:29:29 +0000</pubDate>
      <link>https://dev.to/networknerd1337/nerdgram1337-v142-compare-baselines-and-find-and-replace-for-mermaid-diagrams-188m</link>
      <guid>https://dev.to/networknerd1337/nerdgram1337-v142-compare-baselines-and-find-and-replace-for-mermaid-diagrams-188m</guid>
      <description>&lt;p&gt;NerdGram1337 is a Mermaid diagramming app I build and maintain, and it runs on your own machine. You write diagrams in Mermaid, you get a live preview, and what you save is a real &lt;code&gt;.mmd&lt;/code&gt; file on disk. It's free and MIT-licensed. You don't need an account, and there's no hosted service or AI generation (no concerns about it hallucinating in a diagram).&lt;/p&gt;

&lt;p&gt;v1.4.2 came out on November 15, 2026. (Atlas is the code name for the whole 1.x line, not just this release.) This post digs into two of the bigger pieces in it: a read-only compare against named baselines and a find and replace that works across the whole workspace. Both first showed up back in v1.2.0. If you're new to the app, the &lt;a href="https://ryanthomashuff.com/nerdgram1337-mermaid-diagramming-app/" rel="noopener noreferrer"&gt;original walkthrough&lt;/a&gt; covers the basics.&lt;/p&gt;

&lt;p&gt;The commands below use v1.4.2. A few other things are in this release too. Clicking an object in the preview now jumps the editor to the line that drew it. &lt;strong&gt;From data&lt;/strong&gt; builds a diagram from a CSV, JSON, or network JSON file (or from pasted Cisco CDP or LLDP neighbor output) and can refresh it from that file later. There's a token-based REST API at &lt;code&gt;/api/v1&lt;/code&gt; for scripts and CI, and there's optional GitHub sync that copies your diagrams to a private repo in your own GitHub account.&lt;/p&gt;

&lt;h2&gt;
  
  
  Compare and baselines
&lt;/h2&gt;

&lt;p&gt;If you've ever had to answer "what changed in this diagram since last month?", this is the feature I built for that.&lt;/p&gt;

&lt;p&gt;You can keep any revision as a named baseline. Named baselines sit outside the usual 20-revision prune, and each diagram can hold up to 20 of them (you can change that cap with &lt;code&gt;NERDGRAM_BASELINE_CAP&lt;/code&gt;).&lt;/p&gt;

&lt;p&gt;Compare is read-only and never touches the diagram file. It draws one merged picture, colored like this.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;added items in green&lt;/li&gt;
&lt;li&gt;removed items in red and dashed&lt;/li&gt;
&lt;li&gt;changed items in amber&lt;/li&gt;
&lt;li&gt;unchanged items dimmed&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Labels stay high-contrast on the colored nodes, so you can still read the text. You also get side-by-side and text views, a legend, and a change summary.&lt;/p&gt;

&lt;p&gt;Every diagram type gets a text diff, front matter included. Flowcharts go a step further with a node-and-edge diff that picks up added and removed nodes, relabels, arrow and style changes, and subgraph moves. The compare picture exports as SVG, PNG, JPG, or PDF, and the change summary exports as Markdown, which is handy for dropping into a change ticket or a pull request.&lt;/p&gt;

&lt;h2&gt;
  
  
  Workspace find and replace
&lt;/h2&gt;

&lt;p&gt;The editor's find bar still only works on the diagram you have open. Workspace find and replace is its own dialog, and you can open it from the dashboard, the command palette, or the editor find bar.&lt;/p&gt;

&lt;p&gt;It shows you a preview first, and you can leave out a whole file or just a single match. Any file that's open in an editor gets skipped, same as any file that changed since the preview, and it tells you what it skipped. It also saves a revision before each change. So if a batch goes sideways, you can undo it.&lt;/p&gt;

&lt;h2&gt;
  
  
  API and CLI
&lt;/h2&gt;

&lt;p&gt;The new features are on the REST API too, and the &lt;code&gt;nerdgram&lt;/code&gt; command-line client can call them with &lt;code&gt;nerdgram diff&lt;/code&gt;, &lt;code&gt;nerdgram baseline&lt;/code&gt; and &lt;code&gt;nerdgram replace&lt;/code&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Running it
&lt;/h2&gt;

&lt;p&gt;Docker is the simplest way to run the app. In the example below, I publish the port on loopback only.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;docker pull ghcr.io/networknerd1337/nerdgram1337:v1.4.2

docker run -d \
  --name nerdgram1337 \
  --restart unless-stopped \
  -p 127.0.0.1:8787:8787 \
  -e &lt;span class="nv"&gt;NERDGRAM_DATA_DIR&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;/data \
  -e &lt;span class="nv"&gt;NERDGRAM_INSTALL&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;docker \
  -v nerdgram-data:/data \
  ghcr.io/networknerd1337/nerdgram1337:v1.4.2
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then open &lt;a href="http://127.0.0.1:8787" rel="noopener noreferrer"&gt;http://127.0.0.1:8787&lt;/a&gt;. If you'd rather not pin a version, the &lt;code&gt;:latest&lt;/code&gt; tag points at the newest full release.&lt;/p&gt;

&lt;p&gt;You can also run it from source with Node.js 20 or newer and npm 10 or newer.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/NetworkNerd1337/NerdGram1337.git
&lt;span class="nb"&gt;cd&lt;/span&gt; NerdGram1337
npm run install:all
npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;That starts the development server at &lt;a href="http://localhost:5173" rel="noopener noreferrer"&gt;http://localhost:5173&lt;/a&gt;. For a production build on port 8787, run &lt;code&gt;npm run build&lt;/code&gt;, and then &lt;code&gt;npm start&lt;/code&gt; instead of &lt;code&gt;npm run dev&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;To be clear, the npm package isn't the app. &lt;code&gt;npm install -g nerdgram1337&lt;/code&gt; only installs the &lt;code&gt;nerdgram&lt;/code&gt; command-line client, which talks to a running app at &lt;code&gt;NERDGRAM_URL&lt;/code&gt; (default &lt;code&gt;http://127.0.0.1:8787&lt;/code&gt;) and can't start the app by itself. Get the app running first, then install it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Still local-first
&lt;/h2&gt;

&lt;p&gt;A Node.js install listens on loopback (127.0.0.1 and ::1) by default, and the Docker example above only publishes the port on 127.0.0.1. Your diagrams stay plain files, and you still don't need an account. It's a code-first editor, so you write Mermaid instead of dragging boxes around a canvas.&lt;/p&gt;

&lt;p&gt;The code is on GitHub at &lt;a href="https://github.com/NetworkNerd1337/NerdGram1337" rel="noopener noreferrer"&gt;NetworkNerd1337/NerdGram1337&lt;/a&gt;. What changed in the latest release is in the &lt;a href="https://github.com/NetworkNerd1337/NerdGram1337/releases/tag/v1.4.2" rel="noopener noreferrer"&gt;v1.4.2 release notes&lt;/a&gt;. Compare and find and replace are covered in the &lt;a href="https://github.com/NetworkNerd1337/NerdGram1337/releases/tag/v1.2.0" rel="noopener noreferrer"&gt;v1.2.0 release notes&lt;/a&gt;, and every release is on the &lt;a href="https://github.com/NetworkNerd1337/NerdGram1337/releases" rel="noopener noreferrer"&gt;Releases page&lt;/a&gt;. If something breaks or you'd like to see a feature, open an issue. And if it's useful to you, a star on the repo helps.&lt;/p&gt;

&lt;p&gt;There's more on my site at &lt;a href="https://ryanthomashuff.com" rel="noopener noreferrer"&gt;ryanthomashuff.com&lt;/a&gt;.&lt;/p&gt;

</description>
      <category>mermaid</category>
      <category>opensource</category>
      <category>selfhosted</category>
      <category>networking</category>
    </item>
  </channel>
</rss>
