My First Quest

A simple Forge app that displays a personalized welcome message in Confluence using native Forge UI.

Comment

Inspiration

As someone eager to explore Atlassian's Forge platform, I was motivated by the opportunity to build something lightweight yet meaningful directly inside Confluence. Forge Quest provided a structured and hands-on path to begin this journey, making it the perfect entry point for learning and building simultaneously.

What it does

This app displays a personalized greeting message to the logged-in user within a Confluence space. It also reflects the current UI theme (light or dark), demonstrating how Forge can integrate seamlessly with native Confluence environments.

How we built it

The app was built using Atlassian Forge, starting from the hello world template. I used the Forge CLI to create the project, configured the manifest.yml file, and deployed the app to a development environment in Confluence. It uses the @forge/ui module to render content natively within the Confluence UI.

Challenges we ran into

Initially, getting familiar with the Forge CLI and understanding the app structure posed a small learning curve. Managing the development environment and testing changes inside Confluence also required some setup and trial runs. Understanding the difference between the hosted UI and custom UI options was another important learning point.

Accomplishments that we're proud of

Successfully deploying a working Forge app into a live Confluence environment was a great milestone. It confirmed that the development tools, app structure, and deployment process were all properly understood and executed.

What we learned

  • How to use the Forge CLI to build, deploy, and manage apps
  • The structure and purpose of the manifest.yml file
  • How to use @forge/ui components for native Confluence integration
  • How themes and personalization can be handled within Forge apps

What's next for My First Quest

In the future, I aim to enhance this app by pulling dynamic data from Confluence or Jira using REST APIs. I'd also like to explore building custom issue panels for Jira, create automation tools, and potentially publish to the Atlassian Marketplace. This first quest was just the beginning of my journey with Forge.

Share this project:

Updates