Jira-App

Kickstarting Jira customization with Forge — a lightweight project page that displays a friendly greeting using Atlassian's Forge platform.

Comment

Inspiration

As a beginner in Atlassian Forge and Jira app development, I was curious to understand how internal tools are created for real-world teams. The "Hello World" tutorial seemed like a great first step to explore the Forge platform, especially because it connects directly with Jira — a tool widely used in the industry.

What it does

The app displays a simple "Hello, World!" message using Forge's UI Kit, showing how developers can embed custom UIs directly into Jira Cloud projects.

How we built it

  • Followed the official Atlassian Forge "Hello World" tutorial

  • Used the Forge CLI to scaffold and deploy the app

  • Configured manifest.yml to use the jira:projectPage module

  • Deployed the app using forge deploy

  • Installed it to my Jira development site using forge install

  • Created a new Jira project to view the app’s output

Challenges we ran into

  • Initially confused about where the app would appear (solution: created a new Jira project)

  • Unsure about the correct site (used the one ending with .atlassian.net instead of the sandbox version)

  • Spent some time figuring out where in the Jira UI the app would show (under the Apps tab inside a project)

  • Minor confusion around when to take the "purple zone" screenshot

Accomplishments that we're proud of

  • Successfully built and deployed a working Forge app inside a Jira project

  • Understood how Forge apps are structured, including the use of manifest.yml and UI modules

  • Learned how to use Forge CLI commands like forge create, forge deploy, and forge install

  • Navigated through the Jira interface to locate and test the app in a real project

What we learned

  • How to create a Forge app using the CLI and forge create

  • The structure and purpose of the manifest.yml file

  • How to use the jira:projectPage module to show the app inside a Jira project

  • How to deploy and install the app to a development site

  • How apps are rendered in Jira’s UI using UI Kit

  • How to debug and redeploy quickly using forge deploy and forge install

What's next for Jira-App

  • Add dynamic content: Instead of just a static message, I plan to display project-specific data using Jira APIs.

  • Experiment with Custom UI: I want to try out Forge’s Custom UI to build more interactive and visually engaging interfaces.

Built With

Share this project:

Updates