Rate this page:
As an app developer, you can use the following Jira full-page modules to create full-page experiences in your Forge app:
Use the Jira global page module for larger apps that span multiple projects and entities. The module provides a full-page experience for all app users who use the instance.
You can access the global pages created by the app via Apps in the header. If an app has multiple
global pages, clicking the app in the Apps menu navigates to the path
From the header, select Apps, then select the app.
Apps with a single global page don’t display a sidebar.
Clicking an app in the Apps menu navigates to the path
/. The sidebar displays the name of the app, as well as the app’s global pages.
Most users do their work in the project context, whether it’s on the board, queue, or issue view. Use the Jira project page module to bring your app closer to where users do their work. Project pages are most suitable for the full-page apps in a single project.
Project pages can be accessed via the project sidebar. For Jira Work Management, you can access this from the project view navigation (horizontal navigation above your project’s view) under the Apps dropdown. For all other products, apps that create a project page have a menu item in the project sidebar, in the Apps section. The Apps section is displayed below the native sections in the project.
Clicking the app in the project sidebar opens up the project page.
Clicking the app in the project sidebar displays a contextual sidebar, which then displays the app name and its multiple project pages below. App users can navigate to these project pages.
Use the Jira project settings page module to build a settings page that only project admins can access.
You can access project settings pages from the project settings sidebar. Apps that create a project settings page have a menu item in the project settings sidebar, in the Apps section. The Apps section is displayed below the native sections of the project settings.
Clicking the app in the project settings sidebar opens up the project page.
Clicking the app in the project sidebar displays a contextual sidebar, which then displays the app name and its multiple project pages below. Project admins can navigate to these project settings pages.
The Jira admin page module works best for the following use cases:
You can access the admin page of an app from the Apps administration sidebar, below the native sections.
The building blocks of full-page experiences in Forge apps are:
Forge has two options for building the user interface of your apps: UI kit and custom UI. The user interface essentially becomes the page content of your app.
The UI kit lets you quickly and easily build a user interface for your app. It's made up of three main concepts: components, hooks, and event handlers.
We have three layout types:
Custom UI apps support:
UI kit apps support:
A contextual sidebar is available when your app has multiple pages of the same kind. From the contextual sidebar you can:
You can use the name and icon of an app as branding for your app. We recommend using a colored icon for your app icon.
Menu labels and their corresponding icons are key for users to find their way when using an app. A menu label and its icon should clearly describe the functionality of a particular page, as well as reflect your branding.
Sections provide the ability to group two or more pages in the contextual sidebar. This helps users find relevant items when navigating the sidebar. We discourage using sections for a single page.
Rate this page: