Forge Hello World deprecation error

Forge Forge Rookies
,
1

Hi,
I’m trying to start learning how to develop Forge Apps, and I’m having issues in the Hello World.

I followed the tutorial from https://developer.atlassian.com/platform/forge/getting-started/

It’s deployed and installed successfully, but when I open a task, instead of the Hello message, I see:

HELLO APP version is outdated due to a deprecated platform component. The app developer needs to update it to a compatible version. Please ask your admin to check for updates or contact the app developer.

I tried to decrease the node version, from 22 to 20, because I read somewhere that v22 could have conflicts, and also to force updating all dependencies. However the problem persists.

The manifest is as follows:

modules:
  jira:issuePanel:
    - key: paco-hello-world-issue-panel
      resource: main
      resolver:
        function: resolver
      render: native
      title: paco-forge-poc
      icon: https://developer.atlassian.com/platform/forge/images/icons/issue-panel-icon.svg
  function:
    - key: resolver
      handler: index.handler
resources:
  - key: main
    path: src/frontend/index.jsx
app:
  runtime:
    name: nodejs20.x
    memoryMB: 256
    architecture: arm64
  id: ari:cloud:ecosystem::app/c95a82d4-ccc9-48e7-af00-e25a3fd3ea1d

package.json

{
  "name": "jira-issue-panel-ui-kit",
  "version": "1.1.14",
  "main": "index.js",
  "license": "MIT",
  "private": true,
  "scripts": {
    "lint": "eslint src/**/*"
  },
  "devDependencies": {
    "eslint": "^8.56.0",
    "eslint-plugin-react-hooks": "^4.6.0"
  },
  "dependencies": {
    "@forge/bridge": "^5.1.0",
    "@forge/react": "^9.3.0",
    "@forge/resolver": "^1.6.13",
    "react": "^18.2.0"
  }
}

I found several developer comments about how they found their apps disabled due to sudden deprecations in the Forge ecosystem. It’s a bit concerning that even the provided Hello World has been deprecated, if that’s the problem I’m experiencing.

I’ll appreciate someone having the same problem, and got it solved. Perhaps I did something wrong and I’m unable to see what.

Thanks in advance

2

I just tried the tutorial as is and was able to get the output as described in the docs. Here’s my manifest

modules:
  jira:issuePanel:
    - key: chris-ganta-jira-hello-world-app-hello-world-issue-panel
      resource: main
      resolver:
        function: resolver
      render: native
      title: 4th-july-chris-ganta-jira-hello-world-app
      icon: https://developer.atlassian.com/platform/forge/images/icons/issue-panel-icon.svg
  function:
    - key: resolver
      handler: index.handler
resources:
  - key: main
    path: src/frontend/index.jsx
app:
  runtime:
    name: nodejs22.x
    memoryMB: 256
    architecture: arm64
  id: <appId>

Here’s my index.jsx

import React, { useEffect, useState } from 'react';
import ForgeReconciler, { Text } from '@forge/react';
import { invoke } from '@forge/bridge';

const App = () => {
  const [data, setData] = useState(null);
  useEffect(() => {
    invoke('getText', { example: 'my-invoke-variable' }).then(setData);
  }, []);
  return (
    <>
      <Text>Hello world!</Text>
      <Text>{data ? data : 'Loading...'}</Text>
    </>
  );
};

ForgeReconciler.render(
  <React.StrictMode>
    <App />
  </React.StrictMode>
);

Here’s my package.json

{
  "name": "jira-issue-panel-ui-kit",
  "version": "1.1.14",
  "main": "index.js",
  "license": "MIT",
  "private": true,
  "scripts": {
    "lint": "eslint src/**/*"
  },
  "devDependencies": {
    "eslint": "^8.56.0",
    "eslint-plugin-react-hooks": "^4.6.0"
  },
  "dependencies": {
    "@forge/bridge": "5.1.0",
    "@forge/react": "11.2.4",
    "@forge/resolver": "1.6.13",
    "react": "^18.2.0"
  }
}

Output:

image
image995×537 31.4 KB

Let me know how it goes. If you find issue do let me know and we can update the docs.
Note: If you are using legacy runtime or any UI Kit 1 components, this issue is expected.

Chris Ganta
Sr. Technical content designer

3

Thanks @ChrisGanta. I tried again the Hello World tutorial, and right now the published hello world app works as expected.

Actually, between my failing attempt and this last one, the dependencies have been upgraded. The current Hello World template uses the jira-issue-panel-ui-kit 1.1.15-next.1 version, and the one that failed was using the 1.1.14.

I tried again with the original package.json, with the 1.1.14, and failed again.

Screenshot_2025-07-04_21-17-11
Screenshot_2025-07-04_21-17-11921×444 46.4 KB

Thanks for your fast response.

1 Like