Skip to content

v2.1.0 - Cluster Party 🎪

Latest

Choose a tag to compare

@kerrizor kerrizor released this 10 Jul 20:13

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

🎯 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