Hello User - Forge App

A Forge-powered Confluence app that greets users by name, shows their current theme, and displays the space name.

Comment

🌟 Inspiration

I was inspired by the idea of making Confluence more personal and interactive. Instead of seeing generic messages, I wanted users to be welcomed by name—something small but meaningful. Atlassian Forge gave me the perfect opportunity to build that with minimal setup and maximum learning.

⚙️ What it does

This Forge app:

  • Greets the current user by name by using their account ID
  • Shows the space key where the app is running
  • Displays the current theme (light or dark mode)

It uses the Confluence Cloud API to fetch and display real-time, personalized data inside the Confluence UI.

🏗️ How we built it

  • Used Forge CLI to scaffold a confluence:spacePage app
  • Retrieved the user’s accountId from view.getContext()
  • Fetched user details with the Confluence REST API (/wiki/api/v2/users-bulk) using @forge/bridge
  • Handled permissions via the manifest.yml file
  • Built UI using React components provided by Forge

🧱 Challenges we ran into

  • Manually adding the read:user:confluence scope when forge lint --fix didn’t catch it
  • Understanding the separation of front-end and back-end responsibilities in Forge
  • Debugging why the account ID was showing instead of the actual user name

🏆 Accomplishments that we're proud of

  • Successfully personalized the app UI with real-time user data
  • Understood and used Atlassian’s new Forge platform for cloud app development
  • Overcame deployment and permission hurdles

đź“š What we learned

  • How to build and deploy an app using Atlassian Forge
  • How to interact with Confluence’s REST API and handle authentication
  • How to render user-specific UI elements in a secure way

🚀 What's next for Hello User - Forge App

  • Add support for user avatars and custom greetings
  • Extend the app for Jira with similar functionality
  • Use Forge storage APIs to let users save preferences like themes or shortcuts
  • Add a configuration panel to customize the greeting message

Built With

Share this project:

Updates