Last updatedNov 18, 2019

About Forge

Forge is an app development platform designed to revolutionize how Atlassian Cloud products are customized, extended, and integrated. Forge is currently in beta.

Forge is under active development and currently supports a limited number of extension points. These include:

  • Editor macros for embedding dynamic content in the Confluence editor.
  • Product triggers for building automations and integrations that respond to Confluence Cloud and Jira Cloud events.
  • Web triggers for integrating Forge with third-party applications.

We plan to release additional extension points for both Jira Cloud and Confluence Cloud in early 2020. If you need extension points we don't support yet, check back soon!

Forge highlights

  • Hosted infrastructure: Build trusted, scalable apps with Atlassian compute and storage, eliminating the need to manage infrastructure or security.
  • Customization: Customize apps using the Forge UI. Forge UI is a declarative language for defining cross-platform user experiences and enabling access from more devices.
  • Streamlined experience: Create, test, and deploy apps using the Forge command line interface (CLI). Forge CLI features a DevOps toolchain powered by Bitbucket Pipelines.

Read on to learn more about Forge, or start building.

Forge beta features

The following features are available in Forge beta.

Forge CLI

Use the Forge command line interface (CLI) to create, develop, install, and manage Forge apps. The Forge CLI works in most command line applications.

Atlassian-hosted FaaS

Forge is built on a Function as as a Service (FaaS) infrastructure hosted by Atlassian. Your functions are written in Node.js and bound to extension modules that declare how the function is invoked. The following modules are available:

  • Macros enable you to embed native UI components in the Confluence editor, using our declarative markup language Forge UI.
  • Triggers are the FaaS equivalent of webhooks. They consume events emitted by Atlassian products.
  • Web triggers expose a function to the internet for third-party invocation.

Also, your functions can interact with any REST API available on the internet.

Forge UI

Forge UI is a markup language exposed as typed JavaScript XML (JSX) (for example, <Text content="Hi" />), and you can write your Editor macro as a composable React-like functional component.

As in React, functional components enable you to simplify your app to a collection of separate modules, which take props as inputs and return UI.

App authentication for Atlassian APIs

To call Jira or Confluence REST APIs from your app, you need to authenticate. We provide mechanisms for this so that you can make a call in a single line of code.

Limitations of the beta

See beta limitations for a list of beta limitations.

Help and feedback

We’re shipping early and often to learn from your experience and shape the future of our platform. During the beta, we’d love to hear any feedback you have so that we can make Forge better. To give feedback, create an issue in the Forge Jira project.

For help, reach out in the #help channel in the Forge Slack workspace. To join the Slack workspace, open the email accepting you into the Forge beta and click Join Slack workspace.

Updates

See changelog for updates to the Forge platform that affect app developers.

Start building with Forge