My First Forge App

• 

  Hello World app rendered inside Jira Admin using Forge UI Kit

Inspiration

I’ve always been curious about building apps within platforms I already use, like Jira and Confluence. When I discovered Forge Quest, it felt like the perfect opportunity to take that first step into Atlassian’s cloud app development ecosystem. The guided format gave me the confidence to explore Forge hands-on.

What it does

This app adds a custom admin page in Jira using Forge’s jira-admin-page module. When accessed, it renders a simple “Hello World” message, proving that the Forge deployment, module system, and UI Kit integration work correctly.

How we built it

• I used the Forge CLI to scaffold the project with the jira-admin-page template. • I deployed the app with forge deploy and installed it to my Jira site using forge install. • The UI was edited in src/frontend/index.jsx to display a welcome message. • Finally, I navigated to the Jira admin section to view the app and captured the required screenshot.

Challenges we ran into

• macOS permissions errors while installing @forge/resolver and using npm (EACCES, mkdir errors). • The app initially failed to deploy due to missing dependencies. • Locating the correct place in Jira to view the admin page took a bit of trial and error.

Accomplishments that we're proud of

• Successfully set up and deployed a Forge app from scratch. • Resolved CLI and permissions issues on macOS. • Understood how Forge apps are structured and rendered within Jira. • Completed the Novice level challenge and got my first working app live!

What we learned

• How to use the Forge CLI (forge create, deploy, install) • How the manifest.yml defines app structure and modules • The difference between UI Kit, Custom UI, and functions • Handling dependency and permission errors in Node.js/npm on macOS • How to test and verify a Forge app within Jira Cloud

What's next for My First Forge App

I’m excited to move on to the Apprentice level challenges next: • Building a Jira Weather Gadget that displays live API data • Creating a Jira Issue Panel that integrates with team metrics or external services • Exploring Forge Triggers, Resolvers, and Custom UI to make smarter and more useful Jira tools

Built With

• atlassian
• atlassian-forge-?-cloud-app-development-platform-for-jira-and-confluence-?-forge-cli-?-for-scaffolding
• cli
• deploying
• forge
• javascript
• jira
• macos
• node.js
• npm
• ui-kit
• vs
• vs-code
• yaml