Build apps with the global:ui module (Preview)

An app that uses the global:ui module delivers its own end-to-end, full-page experience within the Atlassian platform. Instead of extending a surface inside Jira or Confluence, the app controls its own side navigation, gets its own place in the app switcher, and has a complete canvas for your content, while the Atlassian platform provides the surrounding top navigation.

The global:ui module lets your app:

• Deliver a full-screen experience with side navigation that you control and top navigation provided by the Atlassian platform.
• Appear in the Atlassian app switcher, so users reach your app from anywhere in the platform.
• Connect to one or more Atlassian apps through multi-app compatibility, and optionally surface data across them.
• Build on platform capabilities such as Teamwork Graph, Forge Agents, Rovo Search, and Rovo Chat.

Tutorials and examples

Reference

How it works

When you build a Forge app today, it lives inside an Atlassian app. A Jira issue panel, a Confluence macro, or a project page extends the underlying Atlassian app surface, and its navigation, installation, and licensing are all inherited from the host app.

An app that uses the global:ui module works differently. Once installed, the app appears in the Atlassian app switcher alongside core Atlassian apps and can optionally connect to Atlassian apps. Users experience the app as an independent, standalone tool, not as an add-on to an Atlassian app.

Compared to embedded apps

When to use the global:ui module

Consider using the global:ui module when:

• Users think of your app as a primary tool, not an add-on to an Atlassian app.
• Your app needs to work across multiple Atlassian apps, or deliver an independent workflow.
• You want users to navigate to your app directly from the Atlassian app switcher.

If your app's primary purpose is to extend a single Atlassian app (for example, adding a panel to a Jira issue or embedding content in a Confluence page, an embedded app is likely the better fit).

Use cases

Apps that use the global:ui module suit two broad categories of work.

New end-to-end tasks targeting new customer verticals - workflows that sit entirely outside the scope of existing Atlassian apps:

• Technical architecture diagramming tools for software architects.
• Human resourcing and training campaign management.
• Logistics and route planning for field operations teams.

New ways of managing existing tasks across multiple apps - apps that consolidate or provide a unified view of work spanning multiple Atlassian apps:

• Senior management dashboards that surface work across multiple Atlassian apps.
• Enterprise data backup and resilience tools.
• CRM and analytics tools that pull data from Jira and Confluence instances.

The global:ui module compared to the full page module

Forge's full page module also provides a full-screen canvas. The two modules serve different purposes.

Key terms

Next steps

Follow the Getting started tutorial to create your first app with the global:ui module and deploy it to your Atlassian site.

Once you have a working app, see Add custom content using Frame to embed Custom UI in the main content area and wire up sidebar navigation.