We’ve released version 5.2.0 of the Forge CLI. This update includes:
jira:adminPage now supports two new properties useAsConfig and useAsGetStarted.
You can now:
add an extra page entry in the jira:adminPage module and mark it with useAsConfig: true to create a configure page that will be linked from the Manage apps page
add an extra page entry in the jira:adminPage module and mark it with useAsGetStarted: true to create a get started page that will be linked from the Manage apps page
have up to three-page entries at the same time in jira:adminPage module:
default admin page entry that will be displayed on the sidebar
configure page entry that will be displayed in the app details section on the Manage apps page
get started page entry that will be displayed in the app details section on the Manage apps page
All Forge CLI list commands now feature a new option for displaying output in JSON (instead of table format). JSON outputs are much easier to parse and incorporate into scripts and automated processes.
Run npm install -g @forge/cli@latest on the command line to install the latest version of @forge/cli .
Hello @OwenFrere,
I really love the possibility to guide my customers to the admin page for app configuration and to get started.
What I don’t understand is the forced dependency that.
The jira:adminPage entry with the useAsGetStarted or useAsConfig property won’t be displayed on the sidebar.
What if I just want to guide my customers to my admin page, without adding additional pages for config and get started?
FYI – As of right now, version 5.1.1 is still tagged as the “latest” in NPM. So the npm install commands referenced above will not install 5.2.0. Based on this announcement and the warnings outputted by the CLI, I assume 5.2.0 is intended to be tagged as the latest?
Disregard. I just saw a status notification that 5.2.0 was just “unpublished”.
Today, 12th of October 2022 at 07:00 UTC we have unpublished the version 5.2.0 and repointed the ‘latest’ Forge CLI tag to the stable version 5.1.1 to mitigate the impact.
This threw me off, because the 5.1.1 CLI prompts to upgrade to 5.2.0
Your use case makes perfect sense but unfortunately it won’t work for everyone as some developers may want to exclude getting started page from the sidebar (on the left) when the app is open. Same may apply to the configure page. For this reason we’ve decided to make it more flexible so developers could decide on their own whether they want those pages to be present in the sidebar all the time or not (as in some cases those pages would be open only once and then completely forgotten).
If you would like to have those pages in the sidebar, you may simply create subpages for them and reuse resources you are using for useAsConfig and useAsGetStarted entries. Which would technically result in the same behavior you expect (plus a bit bigger manifest).