I can't publish my theme due to app dependency
Learn how to fix app dependency validation errors when publishing a theme or app in VTEX IO.
Keywords: Dependency | App | Theme | Publish | VTEX IO CLI
When attempting to install a new store theme or publish an app in VTEX IO, you may encounter a dependency validation error.
This issue occurs when an app dependency is deprecated, or is a release candidate or pre-release version. In these cases, VTEX IO blocks installation or publishing and displays an error similar to the following:
Error validating app dependencies: Error with dependency {appvendor}.{appname}@{appversion}: App cannot be deprecated, a release candidate version, or a pre-release version: {appvendor}.{appname}@{appversion}
Solution
To solve this issue, follow the steps below:
-
In the error message, identify the specific app causing the issue with the format
{appvendor}.{appname}@{appversion}. For example:template.mygiftcard@0.x. -
If the dependent app version is deprecated, a release candidate, or a pre-release, disable it so the system can use a stable version. Run:
_10vtex deprecate {appvendor}.{appname}@{appversion} -
To install the latest stable version of the app in an account, run:
_10vtex update {appvendor}.{appname} -
If deprecation isn't needed and you want to republish that specific version, run:
_10vtex undeprecate {appvendor}.{appname}@{appversion} -
After adjusting dependencies, try installing the theme or publishing the app again.
If the issue persists, open a ticket with VTEX Support.