backstage / backstage/community-plugins

๐Ÿ› ADR: Can not read ADRs from Bitbucket Server

Open
#8,022 8 comments 0 reactions 1 assignee Claimed by @aryalsushant View on GitHub
bug good first issue help wanted workspace/adr
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:

Image

### ๐Ÿ‘Ÿ 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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.