Changelog

New Features

• Visualizer Layout Persistence — Save and restore custom node positions in the visualizer during development. Drag nodes to arrange your visualization, then save layouts to _data/visualizer-layouts/ for sharing with your team. Layouts work across all visualizers including services, events, flows, domains, entity maps, and designs. Available in dev mode only.

New Features

• Build Telemetry — Added resource counting to build telemetry, tracking the number of events, services, domains, and other resources in your catalog. This helps teams monitor catalog growth and understand the scale of their architecture documentation.

Improvements

• Configurable Mermaid Diagram Size — Added configurable maxTextSize parameter for Mermaid diagrams, allowing you to render larger and more complex diagrams without rendering issues.

New Features

• Mermaid Export for NodeGraph — Export NodeGraph visualizations as Mermaid diagrams with view mode switching and shareable URLs. This makes it easier to share and embed your architecture visualizations in documentation or presentations.

Bug Fixes

• Fixed containers collection glob pattern to properly support nested directories, improving organization flexibility for container resources.

Bug Fixes

• Fixed issue with custom documentation pages not rendering correctly on Windows systems, improving cross-platform compatibility.

Bug Fixes

• Fixed TypeScript type errors in data product builder test file by adding proper type casting and missing required fields, improving type safety and developer experience.

New Features

• Data Products Collection — Added support for documenting Data Products as a new collection type in EventCatalog. Teams can now catalog and track data products alongside events, services, and domains, providing a complete view of their data architecture.

Improvements

• Extracted shared specification processing utilities to reduce code duplication and improve maintainability across the codebase.

Improvements

• Enhanced Schema Viewer — Added comprehensive support for oneOf and anyOf JSON Schema keywords, including:

  • Complete handling for anyOf in schema processing
  • Fixed oneOf rendering to show selected variant's properties
  • Added variant selector UI for nested oneOf/anyOf within properties
  • Support for oneOf/anyOf in array items
  • Variant type indicators in property type display

• Updated Astro dependencies to latest versions for improved performance and security.

New Features

• Direct Domain Event Flows — Added sends and receives properties to domains, allowing domains to directly document event flows without requiring services as intermediaries. This simplifies modeling domain-to-domain communication patterns and provides a clearer view of event-driven architecture at the domain level.

Improvements

• Added type check script and fixed type errors in ResourceRef and SearchModal components for improved type safety.
• Directory navigation now defaults to the teams page when no users are defined, providing a better user experience.

New Features

• Inline Resource References — Added wiki-style syntax for creating interactive resource links. Use [[type|ResourceName]] syntax to create links that display resource details on hover, making it easier to reference and explore related resources directly within your documentation.

Improvements

• Updated Hono version for improved performance and security.
• Fixed sidebar favorites removal for deleted nodes and added theme support to plans and custom documentation pages.

New Features

• Discover Page — Added a new Discover page with enhanced table filtering and tabbed navigation for browsing catalog resources. This makes it easier to explore and find services, events, domains, and other resources across your entire catalog.

Improvements

• Reduced build size through optimized sidebar implementation using node references and static JSON API.

Bug Fixes

• Fixed visualizer showing incorrect "subscribed by" edge when a producer references a non-existent channel version, improving accuracy of relationship visualization.

Bug Fixes

• Fixed Avro schema file downloads in context menu by using the actual schema filename from schemaPath instead of a hardcoded 'schema.json' value, ensuring downloaded files have the correct name.

Improvements

• Enhanced Sidebar Search — Improved sidebar search with several enhancements:
  • Fixed duplicate search results by filtering out unversioned node keys
  • Added grouping of search results by type with alphabetical sorting
  • Added missing Channel type to filter mapping
  • Extracted shared badge styling utilities using CSS variables for consistent theming

Bug Fixes

• Fixed search results not respecting base path and trailing slash configuration, ensuring search URLs correctly include configured base path and trailing slash settings.

Bug Fixes

• Fixed React Rules of Hooks violation in NestedSideBar component by moving isFavorited hook before early returns, ensuring proper hook execution order.

New Features

• Interactive Diagram Controls — Added interactive controls to Mermaid and PlantUML diagrams, enabling pan, zoom, and other interactions for better diagram exploration and readability.

New Features

• MCP Server Support — Added Model Context Protocol (MCP) server and shared catalog tools, enabling better integration with AI tools and external systems for querying and interacting with your catalog data.

Bug Fixes

• Fixed schema explorer rendering issue in server-side rendering (SSR) mode on application start, ensuring schemas display correctly on initial page load.

New Features

• Diagrams as Resources — Added support for diagrams as a new resource type, allowing you to document and organize architectural diagrams alongside your other catalog resources for a more complete documentation experience.

Bug Fixes

• Fixed changelog theme styles to ensure proper styling across light and dark themes.

New Features

• IcePanel Diagrams — Added support for embedding IcePanel diagrams in your catalog, enabling teams using IcePanel for C4 model diagrams to integrate them directly into their EventCatalog documentation.

New Features

• Custom AI Assistant Tools — Added the ability to add custom tools to the AI Assistant, enabling teams to extend the assistant's capabilities with domain-specific functionality tailored to their catalog and workflows. Learn more in the EventCatalog Assistant documentation.

New Features

• Dark Mode and Custom Themes — Added full support for dark mode and custom themes, allowing teams to customize the appearance of their catalog to match their brand or preferences. Users can toggle between light and dark modes, and administrators can configure custom color schemes.

Highlights

EventCatalog v3 is a ground-up rebuild, delivering a faster, more intuitive experience for documenting and exploring your event-driven architecture. Whether you're onboarding new engineers or investigating production issues, v3 helps you find what you need, when you need it.

New Features

• EventCatalog Assistant — Bring any AI model to your catalog. Ask questions about your architecture in natural language and get instant answers. Works with OpenAI, Anthropic, or any compatible model.

• Redesigned Homepage — A new landing experience that gives teams an instant overview of their architecture, with quick access to services, events, and domains.

• Customizable Documentation Sidebar — Full control over how your documentation is organized. Create custom sections, reorder content, and build the navigation that works for your team.

• New Search Experience — Faster, smarter search with improved relevance and filtering. Find services, events, and documentation across your entire catalog instantly.

• Channel Support — Added channel support in navigation and search for better organization of messaging channels.

• Visualizer Presentation Mode — Visualizations now include a presentation mode for sharing architecture diagrams in meetings and presentations.

• Admonition Titles — Added support for custom titles on admonition blocks for better documentation clarity.

Performance

• New Caching System — Dramatically faster build times and page loads through intelligent caching of catalog data and visualizations.

• Simplified Sidebars — Streamlined navigation reduces cognitive load and makes exploring your architecture more intuitive.

Architecture Changes

• Updated Domain Hierarchy — Improved structure for organizing domains and subdomains, better reflecting how teams think about bounded contexts.

• Improved Overview Pages — Architecture overview pages now provide richer context with better visualizations and relationship mapping.

Improvements

• Updated architecture overview page designs for better clarity and usability
• Added icons to specification files in the sidebar for easier identification
• Improved Ubiquitous Language styling throughout the catalog
• Enhanced table styles for better readability
• Refactored features into Astro custom integrations for better modularity
• Updated logger for improved debugging and development experience
• Explicit opt-in for authentication features
• llms.txt now enabled by default for better AI integration
• Removed redundant code and files for cleaner codebase

Bug Fixes

• Fixed embedding pages on build to ensure proper page generation
• Fixed issue with nested sidebar state management
• Resolved deployment issues for example catalogs on releases
• Fixed search functionality throughout the application
• Corrected duplicate edge labels in visualizations
• Fixed accessibility issues across the catalog
• Resolved AsyncAPI loading issues in the DOM
• Fixed MDX pages not being added to teams and users sections
• Corrected circular dependency issues in JavaScript

Migration Notes

The following features have been deprecated or replaced:

• EventCatalog Chat → replaced with EventCatalog Assistant
• Chat prompts → removed (use Assistant instead)
• .md files → use .mdx files for all content
• LIST_VIEW and SIDE_VIEW → replaced with new navigation system
• Governance reports → deprecated

See the v3 upgrade guide for complete migration instructions.