This repository demonstrates a bug in Structurizr where refreshing the browser on a documentation page that has navigated to a section header does not work correctly. The URL fragment (anchor) is lost or the page fails to scroll to the expected section after a refresh.
-
Start the containers:
docker compose up -d -
Open the Structurizr UI at http://localhost:8080.
-
Navigate to the Documentation section and open any document (e.g. Solution Architecture).
-
Click on a section header within the document so the URL updates with a fragment/anchor (e.g.
#some-heading). -
Refresh the page (F5 or Ctrl+R).
-
Expected: The page reloads and scrolls to the section header indicated by the URL fragment.
-
Actual: The page does not scroll to the section header; the anchor in the URL is ignored after refresh.
screen_recording.mp4
| Path | Description |
|---|---|
workspace.dsl |
Structurizr DSL workspace defining three example systems, their containers, relationships, and diagram views |
workspace.json |
Compiled workspace JSON |
docker-compose.yml |
Docker Compose file that runs the Structurizr preview server (port 8080) and a Mermaid renderer (port 3000) |
docs/ |
Markdown documentation sections (business context, architecture, requirements, etc.) included via !docs |
adrs/ |
Architecture Decision Records included via !adrs |
- Docker and Docker Compose
- Structurizr image:
structurizr/structurizr:preview - Mermaid image:
ghcr.io/jihchi/mermaid.ink