New forge capabilities for building apps on Bitbucket Cloud

Hello,

We’d like to share an update on several new events, UI modules, and migration path that we’ve added to Forge over the past few weeks to better support building Forge apps for Bitbucket Cloud.

These updates address several “must-have” gaps identified in the RFC feedback and we’re excited to confirm they are now available.

UI modules

Events/Event modifications

  • More data to the “Reviewer status updated” event for pull requests, and including the reviewers

App migration

  • A mechanism for Connect apps to register a Forge app as their replacement

  • A link from Connect app listings to the distribution link of their Forge equivalent

Please review all UI modules with a Connect equivalent, Forge events, and Forge JavaScript APIs we support, and begin migrating your Connect apps to Forge. If you have questions, concerns, or feature requests to help building or migrating to Forge, please share them below or in the community.

3 Likes

Hi, it is good to see growth on the Bitbucket cloud side. We missed the Connect release window with our new app and had to pivot to release it as a pure forge app in October.

It was surprising that the marketplace doesn’t fully support Bitbucket Forge apps yet. We ended up with a partial listing and no “Try it free” button. Instead we had to put a link to the dev console shared install link on our own support web site.

Any timeline when we’ll be able to install Forge apps from the marketplace the same way Connect apps can?

Thanks
Chris

1 Like

Hello team,

What will happen with the existing Connect app listing on the Marketplace when we add the forgeAppLink to the Connect app descriptor? Will Marketplace pages (Atlassian and Bitbucket) automatically replace Connect installation method with the Forge one for new users?

UPD. Will the direct Connect installation link and other Connect-related installation methods be disabled after we add the Forge link? For example, https://bitbucket.org/site/addons/authorize?addon_key=app-key .

2 Likes

We’ve built a couple of apps using this module and it’s worked well.

Building with Custom UI is required in most cases to get access to the DOM and canvas.

So far we have viewers for PDF, Asciidoc, STL, CSV/TSV and mapping files GeoJSON and TopoJSON. If anyone is interesting in taking a look there is an installation link here: File Renderers for Bitbucket Documentation | Eulo Labs | Eulo Labs.

1 Like

Hey @Chris_at_DigitalRose, thank you for sharing this feedback, we really appreciate you taking the time to outline the challenges you’ve run into.

This is an area we’re actively discussing and working on with our dependent teams, and we agree it’s an important gap to address. Right now, we’re in the process of gathering the necessary details and inputs to properly scope and prioritize this work.

I’m not able to share a concrete timeline just yet, but I should have more clarity in the coming weeks and will be happy to follow up once we do.

Hey @aokulovich

Thanks for the questions, this is an area we’re actively working to clarify. Support for Bitbucket Forge apps in the Marketplace, including how they relate to existing Connect listings, is an ongoing discussion with our dependent teams.

At this stage, replacing the Connect installation method with Forge for new users (including Marketplace pages and direct Connect installation links) is something we are exploring in more detail with those teams. We’re currently evaluating what the possible approaches and limitations are before we can confirm any specific behavior or changes.

I’ll sync with the team and follow up once we have clearer guidance on what’s supported and what options may be available. Thank you for your input.

1 Like

It would be nice to have the ability to go directly to a custom file viewer by URI.

eg. something like readme.adoc?viewer=asciidoc-viewer. right now navigation goes directly to the default viewer only including navigating back to a page where the custom viewer was previously selected.

@HamreetKaur - could you please comment on the progress you are making for PvA for Bitbucket forge apps?

3 Likes

In the meantime, how are you handling forge apps, are you releasing them or just holding off with the release until payment part is handled? Thinking if I should release mine now and add a banner that the payment is eventually gonna appear and it will be free until? :thinking:

During the waiting for PvA, I have already had one Connect app released 3+ years waiting for the payment logic so am a bit loosing hope of if this ever will fly. :slight_smile: