backstage / backstage/community-plugins
๐ ADR: Can not read ADRs from Bitbucket Server
- Dominant language
- TypeScript
- Stars
- 422
- Forks
- 697
- Avg merge
- 2d 6h
- Merged PRs (30d)
- 286
Description
### Workspace
adr
### ๐ Description
Hey there, I'm trying to integrate the ADR plugin in my Backstage instance.
My code is stored in Bitbucket Server, and I suspect there might be some integration issue between the 2.
I can see the ADRs tab under my Component page, however when clicking on a specific ADR I get an error telling me that the ADR could not be fetched.
### ๐ Expected behavior
I would expect to see ADRs details when I click on an element in the list
### ๐ Actual Behavior with Screenshots
When I try to integrate ADRs that are stored in Bitbucket Server, I can not fetch the information of the single ADR. This leads to this error:
### ๐ Reproduction steps
1. Install ADR backend and frontend plugins
2. Configure the `catalog-info` of the Component
```yaml
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
annotations:
backstage.io/adr-location: docs/adrs
```
3. Create an ADR under `docs/adrs`: for example, `docs/adrs/0001-example-adr.md`
4. Navigate to the Component's ADR tab
### ๐ Provide the context for the Bug.
If I inspect logs, I can see this 2 errors:
```
2026-03-09T09:21:30.224Z adr error Unable to fetch ADRs from http:///projects//repos/backstage/docs/adrs: Error: Incorrect URL: http:///projects//repos/backstage/docs/adrs, Error: Invalid Bitbucket Server URL or file path
2026-03-09T09:21:30.226Z adr error Unable to fetch ADRs from http:///projects//repos/backstage/docs/adrs/docs/adrs/0001-example-adr.md: Error: Incorrect URL: http:///projects//repos/backstage/docs/adrs/docs/adrs/0001-example-adr.md, Error: Invalid Bitbucket Server URL or file path
```
If I open the first link, I see a 404 in Bitbucket. However if I modify it as such:
`http:///projects//repos/backstage/browse/docs/adrs`
I can see the directory containing ADRs. I suspect that the lack of _browse_ is causing the issue.
### ๐ Have you spent some time to check if this bug has been raised before?
- [x] I checked and didn't find similar issue
### ๐ข Have you read the Code of Conduct?
- [x] I have read the [Code of Conduct](https://github.com/backstage/community-plugins/blob/main/CODE_OF_CONDUCT.md)
### Are you willing to submit PR?
None
Contributor guide
Assessment
This issue has not been assessed yet.