Site connection info
Note: To participate in this workshop, you will need to use the dedicated workshop site and login credentials provided on your handout (not your daily work account).
- Open a browser window in Incognito / Private mode (or use a clean browser profile).
- Navigate to the site URL listed on your login sheet.
- Sign in using the assigned username and password.
First-time access to the site
When prompted during onboarding, click on Other on the screen below and you are all set.
If prompted with the following, click on Show all spaces on the screen below and you are all set.
Learning Session Overview
🖐️ Welcome to this learning session. During this workshop, we’ll build a custom Jira dashboard using Studio from start to finish.
This is just one example of what Forge makes possible. Imagine what you could build next.
What you'll build
A Jira dashboard tailored to a specific space, featuring:
- A 2D stacked bar chart showing team workload distribution
- A panel of unassigned work items by priority for quick triage
What you'll learn
By the end of this workshop, you will be able to:
- Define clear app specs for your dashboard, using annotations and an image to show Rovo what you want.
- Build a custom Jira dashboard using Forge, with data visualizations powered by live space data.
- Iterate on your app by refining your specs and dashboard based on what you learn.
- Publish the app to a test site, with the ability to restore a previous version as needed.
- Replicate the end-to-end flow from idea → Forge app → live dashboard.
AI is non-deterministic by nature
Please note that due to the non-deterministic nature of artificial intelligence, the results and generated outputs may vary for everyone throughout the workshop.
Let’s start: app specifications
- Select the app switcher in the top left corner (the one with the four little squares
). - Press Rovo Studio (
). If you don’t see it, click the … more menu first, then select Rovo Studio.
Define the app specs
- In the prompt text area, enter the following prompt and continue by either pressing Enter/Return or clicking the upward-pointing arrow:
I need a Jira dashboard (Jira project page) showing key information for a specific space. The dashboard is available on every space.
Include a 2D stacked vertical bar chart showing team workload distribution by assignee, color-coded by work item status, and a table showing unassigned work items by priority.
While defining the specs, Studio may ask clarifying questions. If prompted, reply by either entering the number of your choice or typing your response in the Tell Rovo what to do prompt box.
Answer: 1, Single project per dashboard
Answer: 1, View-only dashboard
Review the app specs
- Click on the Review app specs button to build and visualize the specs as currently defined.
Build the app
- Press Build app for Rovo Studio to create the app and generate the preview.
- If the Build app button is not available (e.g. because a subsequent prompt has been added), simply type Build app in the text area.
- Click on Select developer space → Select an existing space → pick Team 26 from the drop down → click on Assign to developer space.
Let’s iterate on the app: annotations
- Click on the Annotations button (
) located in the top-right toolbar of the preview area:
- Select the topmost heading in the UI (e.g., Team workload or Workload).
- Enter the following text and continue by either pressing Enter/Return or clicking the or clicking the upward-pointing arrow:
Change the label to “Hello World from Amsterdam”
4. In the chat box, either press Enter/Return or click the upward-pointing arrow to submit the annotation request prompt.
Revert the change
1. In the chat box, hover over the App Built panel and click on the Restore to draft arrow () to restore to a previous checkpoint
2. In the Restore checkpoint? dialog, click Restore.
3. Once done, click on the three dots (…) in the top right corner and select Version history to display the versions of this app.
Let’s iterate on the app: image
1. Download the image below by right-clicking on it and using the Save Image As… on your browser.
2. Drag & drop the locally available image into the chat box.
3. In the chat box, enter the following text:
Reorder the columns to match the picture
4. Either press Enter/Return or click the upward-pointing arrow to submit the image change request.
Publish the app
- Press Publish app for Studio to install the app on the test site
- If the Publish app button is not available (e.g. because a subsequent prompt has been added), simply click on the Publish option in the top right area of the screen
- Select your test site in the Publish to production dropdown → click Publish (do not change any of the other options)
View the app in Jira
- In a new browser tab, go to:
https://<your-site-subdomain>.atlassian.net/browse/SALES - Replace
<your-site-subdomain> with the site name assigned to you on your workshop credential sheet (for example: one-atlas-abc.atlassian.net/browse/SALES). - Find the Team Dashboard board that was created and installed, and click it to open. The dashboard might appear under the More menu.
👏 Great job in defining, creating, iterating and publishing a Forge app!
Caterina
https://www.linkedin.com/in/caterinacurti/
https://x.com/caterinacurti