TypeScript 5 support for @forge/bundler and better typings for Forge

Forge Forge Platform and Tools
1

Hi everyone,

I’m currently developing a Forge app and ran into several TypeScript compatibility issues when using newer libraries such as Zod v4, which rely on TypeScript 5 features.

At the moment, the @forge/bundler package still uses:

"typescript": "4.8.4"

Because of that, I was getting multiple TypeScript errors when running my app.
As a temporary workaround, I managed to fix it by using pnpm’s overrides:

overrides:
  "typescript": "^5.9.3"

Everything seems to be working fine with this setup, but I’d prefer to rely on official support rather than a workaround.

While working with Forge, I’ve also noticed that the TypeScript experience could be improved.
For example, some of the types shown in the documentation (like the context object in the Forge Resolver reference) are not exported from any official package.

And i found my self manually copy and pasting type definitions from the docs instead of importing them from an official Forge typings library.

Having a dedicated package for TypeScript types or at least exposing existing internal ones would make the developer experience smoother.

These points lead me to a couple of questions:

  1. Are there any plans or a timeline for upgrading @forge/bundler TypeScript version to v5?
  2. Is Atlassian considering publishing or improving official TypeScript type definitions for Forge? And maybe even types for Jira/Confluence cloud API’s?

Thanks in advance for your time and for all the work on Forge it’s a good platform, and I’d love to see it continue evolving toward full TypeScript support.

3 Likes
2

Hi Aymane,

Thanks for your interest in typing! We currently have a EAP for directly using TypeScript to compile your Forge application: https://developer.atlassian.com/platform/forge/changelog/#CHANGE-2652. This will let you choose the version of TypeScript for the application and update it yourself.

Changing the TypeScript version used by the bundler by default is a bit more complicated but I’ve let the responsible team know.

The rest of your points are valid too, and it would help us prioritise them if you leave your votes on:

  • FRGE-1312 TypeScript library for the REST APIs
  • FRGE-1617 Upgrade Typescript version used by bundler
  • FRGE-490 Typescript Context Type missing properties
  • FRGE-323 Export more types in TypeScript libraries
  • FRGE-535 Better typescript type support in @forge/resolver package
1 Like
3

@AlexeyKotlyarov, nice to hear that Forge will support Typescript natively.
Care to update your links so they display something more helpful than just “Jira”?

4

Updated, sorry, I thought our auto-linker would pick up the title automatically.

1 Like