🚀 Features

• Metadata Filtering in View Predicates:
  Filter elements and relations by metadata key existence (where metadata.key) or value (where metadata.key = 'value'). Works with != for negation and supports source.metadata / target.metadata for relation participants. Thanks @galuszkak, #2769

• LeanIX Bridge Integration:
  New @likec4/leanix-bridge package for syncing architecture models with LeanIX. Includes identity manifest, inventory snapshots, reconciliation, drift reports, governance checks, and ADR generation. CLI adds gen leanix-inventory-snapshot, gen leanix-reconcile, and sync leanix commands. Draw.io export gains a --profile leanix option for bridge-managed metadata round-trip. Thanks @sraphaz, #2746, #2768

• Landing Page Configuration:
  New landingPage config option to control landing page behavior: redirect: true to skip the landing page and go directly to the index view, and include / exclude selectors to filter which views appear in the landing page grid. Thanks @purple52, #2733

• Improved likec4 validate Command:
  Fix exit code (now properly exits with 1 on validation failure), add --json flag for structured JSON output, --file flag to filter errors to specific files, --no-layout flag to skip layout drift checks, and --project support for multi-project workspaces. #2790

🐞 Bug Fixes

• Fixed drag behavior for group nodes #2785

• Fixed scroll in walkthrough notes panel, closes #2729

• Fixed web extension failing to start language server, closes #2702

• Restored Markdown syntax highlighting in triple-quoted strings in VSCode #2785

• Added configurable Node.js path for language server runtime in VSCode #2773

• Draw.io: improved person shape inference on re-import for round-trip fidelity. Thanks @sraphaz, #2685

🚀 Features

• likec4 format CLI Command:
  New likec4 format (alias fmt) command for formatting .c4 source files. Supports --check mode for CI, --project and --files filtering. Thanks @m9810223, #2667

• Overview Page Search, Navigation & Theme Toggle:
  Added search bar (also accessible via Cmd+K), sidebar navigation drawer with file/folder/list grouping, and dark/light theme toggle to the overview page. Fixes #1679. Thanks @ckeller42, #2665

• Disable Implicit Views by Default:
  Auto-generated scoped views for elements without explicit views are no longer created unless "implicitViews": true is set in the project config. To restore the previous behavior, add "implicitViews": true to your likec4.json configuration. #2705

• Draw.io Person Shape Round-Trip:
  Draw.io export now correctly renders elements with shape person as person/actor shapes instead of ellipses. Re-import also infers the person shape for round-trip fidelity. Thanks @sraphaz, #2685, fixes #2679

• Improved Zoom Performance:
  Significant performance improvement with zooming and panning diagrams, thanks to the xyflow update. #2694

• Erode tooling:
  Check documentation, thanks to @parse , #2728

🐞 Bug Fixes

• Added --output alias to all likec4 gen subcommands for consistency with build and export commands, fixes #2706

• Removed deprecated ManualLayoutV1 and related migration command #2713

🚀 Features

• likec4 lsp CLI Command:
  Added new likec4 lsp command to start the LikeC4 language server directly from the CLI. The standalone likec4-language-server binary is now deprecated. #2681

• Improved ?theme= URL Parameter:
  Theme preferences specified via the ?theme= URL parameter are no longer persisted to localStorage — the forced color scheme applies only while the parameter is present in the URL. Thanks @m9810223, #2645

🐞 Bug Fixes

• Fixed "View title cannot contain newlines" error when using implicit views with elements that have multi-line titles, closes #2669, #2672

• Fixed LikeC4 tag color being broken, closes #2637

• docs: Fix broken link to vite-plugin/modules.d.ts location in documentation by @galuszkak in #2668

🚀 Features

• Draw.io Export & Round-Trip:
  Extended Draw.io integration with export options, edge waypoints, and view notation round-trip support. CLI now supports likec4 export drawio --roundtrip to preserve layout and styling when re-exporting. Added "Export to Draw.io" button in the app's export menu. Thanks @sraphaz, #2630, #2639

• New MCP Query Tools:
  Added 10 new MCP query tools: query-graph, query-incomers-graph, query-outgoers-graph, query-by-metadata, query-by-tags, query-by-tag-pattern, find-relationship-paths, batch-read-elements, subgraph-summary, and element-diff. Enhanced read-project-summary with serialized project config and optional metadata field. Thanks @ckeller42, #2638

• Implicit Scoped Views:
  Auto-generate scoped views for elements without explicit views, enabling drill-down navigation out of the box. Configurable via implicitViews option in project config (enabled by default). #2648

• Derive Technology from Icon:
  Automatically derive element technology from icon name when not set explicitly. Elements with aws:, azure:, gcp:, or tech: icons will get a human-readable technology label (e.g. tech:apache-flink → "Apache Flink"). Can be disabled via inferTechnologyFromIcon: false in project config. #2642

🐞 Bug Fixes

• Fixed hollow edge markers (odiamond, oarrow, odot) to display as hollow with background fill instead of solid fill, closes #2634

• Improved state management and error handling in VSCode extension preview, closes #2625

New Contributors

• @m9810223 made their first contribution in #2646

Full Changelog: v1.49.0...v1.50.0

🚀 Features

• New component Element Shape:
  Added new component element shape for diagrams. #2616

  

• Enhanced VSCode Hover Tooltips:
  Hover tooltips in the editor now show relationship counts and clickable links to views containing the element. #2624

  

• Extendable JSON Configs:
  JSON configs can now extend other configs and merge styles from them using the extends property, so you can share your theme. Closes #2573

  {
    "name": "project-name",
    "extends": [
      "../shared/base-config.json",
      "../shared/theme-config.json"
    ],
    "styles": {
      "defaults": {
        "relationship": {
          "arrow": "vee"
        }
      }
    }
  }

• Native MCP Support in VSCode:
  LikeC4 Extension registers MCP server definition, enabling native MCP support in VSCode.

• Review Drifts in Compare Panel:
  Added review drifts feature to the compare panel with drifts highlighting and summary panel. Includes reset manual layout button and improved processing state handling.

🐞 Bug Fixes

• Fixed compound nodes not respecting border style from defaults, closes #2501

• Fixed iconColor for custom SVG icons from data URLs by inlining SVG content to enable CSS color inheritance. Thanks @kaigritun, #2591

• Fixed title inheritance from specification, closes #2580

• Fixed MCP server initialization to be stateless

• Fixed "reload" screen in VSCode preview

• Set fixed icon sizes for consistent rendering

🚀 Features

• Icon Customization:
  Added icon options with iconColor, iconSize, and iconPosition properties, allowing you to customize their appearance in diagrams.

• Direct Links to Relationship Views:
  Navigate directly to relationship views with dedicated URLs. Thanks @ckeller42, #2547

• Projects Overview in VSCode:
  Added command "LikeC4: Open Projects Overview" to VSCode Extension. Improved navigation in the preview panel.

🐞 Bug Fixes

• Fixed compound node colors based on element color and depth, improving visual appearance and color contrast for nested elements.

• Fixed export to PNG of sequence diagrams, closes #2532

• Fixed issue where including additional directories in project stopped working, closes #2555

• Fixed regression with centering dynamic views when switching between diagram and sequence modes.

• Improved font loading performance by migrating to variable fonts and enhanced diagram bounds calculation with better edge handling.

• Dynamic view steps now inherit technology and description from model relationships and specification relationship kinds, closes #2541

• Improved cache management in ProjectsManager and ManualLayouts.

• Enhanced export page behavior and enabled D2/DOT/MMD/PUML pages when viewing multiple projects.

🚀 Features

• diagram: Added new shapes: document and bucket
• diagram: Added Projects Overview diagram, that shows all projects and their relationships in a single view

🐞 Bug Fixes

• #2520 5e38c9b Fixed issue with computation of views with groups, that led to missing relations.

  Exclude imported elements from views if have no relationships and not included explicitly

  Export to json format supports multiple projects, plus:

  • Added --pretty option for exporting indented JSON
  • Added --skip-layout option to skip layouts and return only computed models

• #2521 de2b294 Apply border style to element node (previously it was applied to compound nodes and groups), closes #2502

  Generate Mermaid with expanded Node Shapes (v11.3.0+)

  Improve labels in PlantUML

Features

• icons: Added Bootstrap Icons as bundled icon provider. Use bootstrap:icon-name syntax to access over 2,000 icons from Bootstrap Icons. Example: icon bootstrap:house, icon bootstrap:gear-fill, closes #2503

Bug Fixes

• #2506 39dcb77 - Fixed "exclude" option in project configuration (it was working only with "**/" prefix)
• #2509 9b93f25 - Fix generated PlantUML diagrams for unsupported names, fixes #2307

Bug Fixes

• Remove workspace locks in ProjectsManager, as they lead to race conditions during extension activation. Fixes #2466
• Fallback to the first project in vite plugin, if projectId is not found, instead of erroring out. Closes #2472
• Corrected resolution of project's included documents
• Corrected background color of element-details panel in dark mode

Bug Fixes

• #2476 9c5779d - Deployment nodes name is wrong derived from instanceOf, fixes #2387
• Fixed transparent background of the properties window (#2473)