Update rails-erd 1.7.2 → 2.1.0 (major) by depfu[bot] · Pull Request #1138 · sanger/labwhere

depfu · 2026-07-17T21:05:38Z

Here is everything you need to know about this update. Please take a good look at what changed and the test results before merging this pull request.

What changed?

✳️ rails-erd (1.7.2 → 2.1.0) · Repo · Changelog

Release Notes

2.1.0

What's New

This release brings powerful new ways to organize and filter your ERD diagrams, plus a new output format for tool integration.

🎪 Mermaid Namespace Clustering

Group your entities by Ruby namespace! With cluster: true, your Mermaid classDiagram output now organizes models into visual namespace blocks:
# .erdconfig
cluster: true
mermaid_style: classDiagram
classDiagram
  namespace Admin {
    class User
    class Role
  }
  namespace Billing {
    class Invoice
    class Payment
  }
  User --> Invoice
Loading
Loading
🎯 Glob & Regex Pattern Filtering

Filter entire namespaces with glob patterns or regex:
# Exclude all SolidQueue models
exclude: "SolidQueue::*"
# Exclude multiple patterns

exclude:

"SolidQueue::*"
"ActiveStorage::*"

# Use regex for complex patterns

exclude: "/^(Active|Action)/"
# Focus on specific namespaces

only: "Admin::*"
📊 tbls JSON Format

New tbls generator for integration with Liam ERD and other tbls-compatible visualization tools:
bundle exec erd --generator=tbls --filename=schema
🐛 Bug Fixes

Invalid generator option now falls back to mermaid (the documented default) instead of graphviz

Fix unparseable Mermaid output when polymorphism is enabled and an abstract parent has a tableless child

Fix only/exclude not filtering relationships properly

Process models in stable order for deterministic output (no more git churn!)

Contributors

Thanks to everyone who contributed to this release! 🙏

@arthaud-proust - tbls JSON generator for Liam ERD integration (#474)

@stwr667 - Deterministic relationship ordering (#476) and relationship filtering fix (#473)

@RSeven - Specialization filtering fix (#463), README corrections (#461), and exclude_attributes improvements (#458)

Your contributions make rails-erd better for everyone! 💜

Full Changelog: v2.0.2...v2.1.0

2.0.2

Rails ERD 2.0.2 - Less Is More ✨

Sometimes you just want to keep some things private. Your models have secrets, and now Rails ERD respects that. 🤫

✨ New Features
Hide attributes on a per-model basis (#421, #457)

Ever wanted to show User in your ERD but hide those 47 Devise columns? Now you can! The new exclude_attributes option lets you selectively hide attributes for specific models while keeping everything else visible.
# .erdconfig
exclude_attributes:
  User:
    - encrypted_password
    - reset_password_token
    - confirmation_token
Huge thanks to @RSeven for this contribution! 🙌
🐛 Bug Fixes

Fix crash with polymorphic associations on Rails 8 (#454, #455, #456)

Rails 8 users with polymorphic associations and the exclude option were getting an unwelcome NoMethodError surprise. Not anymore! Thanks to @kennethgeerts for squashing this one. 🪲➡️💀

Full Changelog: v2.0.1...v2.0.2

RubyGems: https://rubygems.org/gems/rails-erd

2.0.1

What's New

A quick patch release to keep your namespaced models happy!

Bug Fixes 🐛

Fix mermaid syntax errors for namespaced class names (#450, #451)

Thanks to @aseroff for reporting that models like Admin::User and Api::V1::Resource were causing Mermaid syntax errors! Turns out Mermaid's erDiagram needs double quotes around entity names containing ::. Now your beautifully organized namespaced Rails models render correctly.

Fix test helper for namespaced models (#451)

While fixing the above, we discovered the test helper create_module_model was creating Admin::Author::Author instead of Admin::Author. Oops! 🙈

Internal 🔧

Use temp directory for test output files (#453)

Tests now write diagram files to the system temp directory instead of polluting the project root. Cleaner repo, happier developers.

Full Changelog: v2.0.0...v2.0.1

Installation
gem 'rails-erd', '~> 2.0.1'

2.0.0

Rails ERD 2.0.0 - The Mermaid Era 🧜‍♀️

It's alive! After years of quiet maintenance, Rails ERD is back with its biggest update ever.

This release fundamentally reimagines how Rails ERD works. No more wrestling with Graphviz installations, no more mysterious dot executable errors, no more platform-specific headaches. Just run bundle exec erd and get a beautiful diagram that renders right in your GitHub README, GitLab wiki, or Notion docs.

🌊 Why Mermaid?

Mermaid diagrams are text-based and render natively in:

GitHub (READMEs, issues, PRs, wikis)

GitLab (everywhere!)

Notion, Obsidian, and countless other tools

Any Markdown renderer with Mermaid support

No more generating PDFs, committing images, or explaining to teammates how to install Graphviz. Your ERD lives in version control as readable text and renders beautifully wherever you need it.

💥 Breaking Changes

Setting Old Default New Default

generator graphviz mermaid

filetype pdf mmd

mermaid_style classdiagram erdiagram

direction RL (right-to-left) TB (top-down)

ruby-graphviz required optional

🚀 Migration Guide

Most users: Just run bundle exec erd and enjoy your new Mermaid diagram!

To continue using Graphviz output:
# Gemfile
gem 'ruby-graphviz'
bundle exec erd generator=graphviz filetype=pdf
To use classDiagram style instead of erDiagram:
bundle exec erd mermaid_style=classdiagram
✨ New Features

Mermaid erDiagram style with crow's foot notation and PK/FK markers (#445)

Full CLI parity - CLI now supports all options that rake task supports (#446, #447)

Orientation support - Mermaid direction respects the orientation option (#448)

🐛 Bug Fixes

Fix --only flag with single model (#441)

Fix nil destination crash (#440)

Fix empty .erdconfig crash (#443)

Fix CLI string-to-symbol option conversion (#447)

Exclude Rails 8 Solid* internal models (SolidQueue, SolidCache, SolidCable) (#437, #438, #439)

Suppress Ruby 3.4 hash key warnings (#436)

📚 Documentation

Completely updated README for Mermaid-first workflow (#444, #448)

Added non-Rails usage example for gems with ActiveRecord models (#444)

🙏 Thanks

This release closes 65+ issues dating back to 2020. Special thanks to everyone who reported bugs, submitted PRs, and kept using Rails ERD over the years. Your patience is appreciated!

📊 Example Output

Running bundle exec erd now produces:
erDiagram
    direction TB
    User {
        integer id PK
        string name
        string email
        integer organization_id FK
    }
    Organization {
        integer id PK
        string name
    }
    Post {
        integer id PK
        string title
        text body
        integer user_id FK
    }
    Organization ||--o{ User : ""
    User ||--o{ Post : ""
Loading
Loading
Full Changelog: v1.7.2...v2.0.0

RubyGems: https://rubygems.org/gems/rails-erd

Does any of this look wrong? Please let us know.

Commits

See the full diff on Github. The new version differs by 35 commits:

🗑️ ruby-graphviz (removed)

Depfu will automatically keep this PR conflict-free, as long as you don't add any commits to this branch yourself. You can also trigger a rebase manually by commenting with @depfu rebase.

All Depfu comment commands

@depfu rebase
Rebases against your default branch and redoes this update

@depfu recreate
Recreates this PR, overwriting any edits that you've made to it

@depfu merge
Merges this PR once your tests are passing and conflicts are resolved

@depfu cancel merge
Cancels automatic merging of this PR

@depfu close
Closes this PR and deletes the branch

@depfu reopen
Restores the branch and reopens this PR (if it's closed)

@depfu pause
Ignores all future updates for this dependency and closes this PR

@depfu pause [minor|major]
Ignores all future minor/major updates for this dependency and closes this PR

@depfu resume
Future versions of this dependency will create PRs again (leaves this PR as is)

depfu Bot added dependencies Pull requests that update a dependency file Technical debt Technical debt labels Jul 17, 2026

depfu Bot mentioned this pull request Jul 17, 2026

Update rails-erd 1.7.2 → 2.0.2 (major) #1127

Closed

Update rails-erd to version 2.1.0

a50e57c

depfu Bot force-pushed the depfu/update/rails-erd-2.1.0 branch from 7d32df4 to a50e57c Compare July 22, 2026 01:45

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Update rails-erd 1.7.2 → 2.1.0 (major) - #1138

Update rails-erd 1.7.2 → 2.1.0 (major)#1138
depfu[bot] wants to merge 1 commit into
developfrom
depfu/update/rails-erd-2.1.0

depfu Bot commented Jul 17, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

Setting	Old Default	New Default
generator	graphviz	mermaid
filetype	pdf	mmd
mermaid_style	classdiagram	erdiagram
direction	RL (right-to-left)	TB (top-down)
ruby-graphviz	required	optional

Uh oh!

Conversation

depfu Bot commented Jul 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What changed?

✳️ rails-erd (1.7.2 → 2.1.0) · Repo · Changelog

2.1.0

What's New

🎪 Mermaid Namespace Clustering

🎯 Glob & Regex Pattern Filtering

📊 tbls JSON Format

🐛 Bug Fixes

Contributors

2.0.2

Rails ERD 2.0.2 - Less Is More ✨

✨ New Features

🐛 Bug Fixes

2.0.1

What's New

Bug Fixes 🐛

Internal 🔧

Installation

2.0.0

Rails ERD 2.0.0 - The Mermaid Era 🧜‍♀️

🌊 Why Mermaid?

💥 Breaking Changes

🚀 Migration Guide

✨ New Features

🐛 Bug Fixes

📚 Documentation

🙏 Thanks

📊 Example Output

🗑️ ruby-graphviz (removed)

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

0 participants

depfu Bot commented Jul 17, 2026 •

edited

Loading