Upgrading from FastStore v2 to v3
Stores using FastStore v2 hosted in the account's GitHub organization must upgrade to v3. In this guide, you'll learn the process for keeping your FastStore project up to date, avoiding breaking changes to your storefront.
For FastStore projects hosted in thevtex-sitesorganization and not using WebOps (FastStore v1), open a ticket with the VTEX Support to move your project to your account's GitHub organization and update it to v3.
Instructions
Step 1 - Update the @faststore/cli package
- Open your store project in the code editor of your choice.
- Open the terminal and run
yarn upgrade @faststore/clito update the@faststore/clipackage to the latest version.
Step 2 - Rename the faststore.config.js file
- In your store project, go to the
faststore.config.jsfile and rename it todiscovery.config.js. - Update any references pointing to
faststore.config.jsto usediscovery.config.jsinstead.
Step 3 - Sync the changes
Run
yarn dev to sync the updates you made to the @faststore/cli package and the new filename.After running the command, your project will be synchronized with the recent changes, and your FastStore v3 upgrade will be complete.