How to upgrade an app from Starter Kit v2 to v3?

[ShubhamAg2]

I have developed an app using Adobe I/O Starter Kit version 2, integrated with Adobe Commerce. I’ve noticed that Starter Kit v3.0 now supports several enhancements, including the ability to configure multiple apps with the same Adobe Commerce instance.

I’m looking to upgrade my existing app from v2 to v3, but I couldn’t find a clear guide or migration path.

Could you please help me with:

•  The recommended steps to upgrade an existing v2 app to v3?
• Any breaking changes or configuration updates I should be aware of?
• How to ensure my existing integrations (e.g., instance ID, provider ID, event mappings) are preserved or migrated correctly?

Any official documentation or best practices would be greatly appreciated.

Thanks in advance!

[rojoangel]

Hi @ShubhamAg2, thanks for reaching out!

To get started with the upgrade from Starter Kit v2 to v3, you might find these resources helpful:

• The v3.0.0 release notes highlight the main enhancements and breaking changes.

• This pull request shows the specific code changes that introduced support for multiple event providers—helpful for understanding what you'll need to update.

There isn’t a formal migration guide yet, but if these don’t cover your case (e.g., preserving instance IDs, event mappings, etc.), feel free to share more details and we’ll help you through it.