Example apps for Bitbucket

Before you begin exploring these example apps, you'll need to set up the Forge CLI first. Learn more about getting started.

Once the Forge CLI is up and running, clone an example app repository to explore and customize it locally. Each repository's README.md file contains quickstart instructions and other details about the app.

For more information, refer to our getting started guides for building Bitbucket, Confluence, Jira, and Jira Service Management apps. Our tutorials and guides also offer useful information for common tasks.

Related pull requests app

This app adds a pull request card that displays pull requests related to the one you're viewing, based on the Jira tickets mentioned in the title of the current pull request.

• Code: Related pull request app
• Products: Bitbucket
• Modules: bitbucket:repoPullRequestCard
• Custom UI: none
• UI Kit:
  • Cell, Code, Head, Link, Row, StatusLozenge, Table, and Text components.
• Other use-cases:
  • Calls the Bitbucket REST API with asApp to retrieve relevant pull requests using BBQL (using route as well as routeFromAbsolute).

Pull request title validator with custom merge checks

This app creates a custom merge check that can block a pull request from being merged if the title does not contain a string configured in the repository settings page.

• Code: Pull request title validator
• Products: Bitbucket
• Modules:: bitbucket:mergeCheck, bitbucket:repoSettingsMenuPage
• Custom UI: none
• UI Kit:
  • Form, Text, and TextField components.
• Other use-cases:
  • Calls the Bitbucket REST API with asApp to retrieve the pull request the check was invoked for.
  • Uses Forge hosted storage to configure the expected prefix.

Pull request secrets scanner with custom merge checks

This app creates a custom merge check that can block a pull request from being merged when there are secrets detected in your repository.

• Code: Pull request secrets scanner
• Products: Bitbucket
• Modules:: bitbucket:mergeCheck
• Custom UI: none
• UI Kit: none
• Other use-cases:
  • Uses Bitbucket Security Secret Scanner pipe to detect secrets in your repository.
  • Utilizes the asApp method to invoke the Bitbucket REST API, retrieving the pull request associated with the initiated check.
  • Utilizes the asApp method to invoke the Bitbucket REST API, aiming to fetch the code insights report produced by the Bitbucket Security Secret Scanner.

Dynamic Pipelines provider tutorial app

This app is a reference implementation of Orchestrate your builds using Dynamic Pipelines tutorial, it adds a step to the default pipeline.

• Code: Dynamic Pipelines provider tutorial app
• Products: Bitbucket
• Modules:: bitbucket:dynamicPipelinesProvider
• Custom UI: none
• UI Kit: none
• Other use-cases:
  • Utilizes the asApp method to invoke the Bitbucket REST API, retrieving the diff stat for a commit the pipeline is requested to run at.