Storefront Theme Versioning, Install, and Rollback

When this skill applies

Use this skill whenever the version of a content-holding storefront app (a theme such as vendor.store-theme, or any app that ships store/blocks.json, store/routes.json, store/templates/, or store/contentSchemas.json) is about to change in master.

• Bumping the version of a theme app with vtex release patch | minor | major
• Running vtex publish / vtex deploy on a theme app
• Running vtex install vendor.store-theme@X.Y.Z against a production account
• Promoting a workspace that has a different theme version installed than master
• Planning recovery from a deploy that "lost" all storefront content
• Reviewing a developer's deploy script that touches a storefront theme

Do not use this skill for:

• block registration via interfaces.json — use vtex-io-render-runtime-and-blocks
• shopper-facing component code under react/ — use vtex-io-storefront-react
• app-level settings under manifest.json#settingsSchema — use vtex-io-app-settings
• Master Data schema versioning — use vtex-io-masterdata-strategy