my-first-quest-jira

jira app

🌟 Inspiration

While working with Jira, I often found myself digging around to get simple details — like what project I was in or basic info about the current user. I wanted something cleaner and faster.
That’s what sparked the idea: what if I could build a lightweight panel that just tells me what I need to know, right where I need it?

That thought turned into this project — a small but useful Jira panel built with Atlassian Forge.

⚙️ What It Does

This app adds a custom panel inside any Jira project. Here's what it shows:

👋 A friendly “Hello” with the current user's name
🔑 The active project's key
🎨 The selected Jira theme (light or dark)

It’s simple but delivers just the right context without any clicks or searching.

🛠️ How We Built It

Used Atlassian Forge to hook into Jira for both frontend and backend
Leveraged UI Kit 2 (@forge/react) for a responsive interface
Pulled project context using view.getContext()
Retrieved user info from Jira using the /rest/api/3/myself endpoint
Connected the frontend to the backend securely using @forge/bridge

🧩 Challenges We Ran Into

Getting the right scopes and permissions, especially read:jira-user
Ensuring the API returned authenticated user data reliably
Debugging why the username wasn't displaying — which turned out to be a subtle auth-related behavior

🏆 Accomplishments That We're Proud Of

Successfully integrated backend and frontend inside Jira
Built a minimal, functional Forge app from scratch
Understood how to use Forge's tools, resolvers, and permissions effectively
Created a smooth user experience without bloated design

📘 What We Learned

How Forge handles user context and authentication
Real-world use of Atlassian REST APIs
Working with Forge UI Kit 2 to build responsive interfaces
How to debug backend-frontend issues in the Forge ecosystem

🚀 What's Next for my-first-quest-jira

Add more contextual project info like issue count or project lead
Support dark mode customizations
Improve error handling and loading states
Polish UI and possibly publish to the Atlassian Marketplace

Built With

atlassianforge
javascript
jiracloudrestapi
react
uikit

Submitted to

Forge Quest: Bonus Level

Created by

For this project, I built a custom Jira project page using Atlassian Forge. My main goal was to create a simple, helpful panel that shows the user their name, the current project key, and the selected theme — all without needing to dig through menus.

I handled both the frontend and backend — using Forge’s UI Kit 2 (@forge/react) to build the interface and Forge resolvers for the backend logic. I used view.getContext() to pull in the project and theme information, and connected to the Jira REST API to fetch user details. I also set up the proper permissions (read:jira-user) and made sure data was passed securely between backend and frontend using @forge/bridge.

Along the way, I debugged some tricky issues with user authentication and API behavior, especially making sure the app could actually display the current user's name properly. It took some trial and error, but I learned a lot about how Forge works under the hood.

Time Slayer

Updates

Time Slayer started this project — Jun 29, 2025 05:27 PM EDT

Leave feedback in the comments!

Log in or sign up for Devpost to join the conversation.