Images not always resolvable, am I doing something wrong?

[timothystone]

Given the following directory layout:

project/
├─ .git/
├─ adrs/
│  ├─ 1-adr.md
│  ├─ 2-adr.md
├─ docs/
│  ├─ c4-101.md
│  ├─ README.md
├─ images/
│  ├─ image.png
├─ .gitignore
├─ workspace.dsl
├─ workspace.json

I have an !adrs and !docs in my workspace.dsl referencing each.

Neither the adrs or docs directories can see the images, i.e., ../images/image.png is unresolvable, while the same is fine in GitHub/GitLab rendering.

I could move the images folder to adrs and docs. Doing so creates possible duplication and breaks the markdown in the browser.

Something is amiss. How is this suppose to work across all possible views? It has something to do with how Structurizr is scoping the "Documentation" and "Decisions" view, !docs and !adrs respectively that the images folder at the root is "lost" in the workspace context on launch.

I could not find an answer in a "Closed" query and the FAQ is silent. Seems like it would be a common enough configuration question: Where should my common images lay for consistent rendering in Structurizr and GitHub/GitLab?

[simonbrowndotje]

If you'd like some assistance, please attach a ZIP file with an example.

[timothystone]

I finally had some time to create something that wasn't proprietary...

Demo Project

Zip File

[timothystone]

I've largely solved the problem with the Structurizr CLI and export. This let's me export the diagrams to GitHub pages and I source them to documentation in the repo via IFRAME.

There may be a better way.