v2.0.0 release notes

WARNING

Vue Storefront for BigCommerce v2.0.0 contains backward-incompatible changes.

Introduction

In this release, we:

• added support for BigCommerce's multi-storefront feature (see Multi-storefront overview for more information),
• changed the way of using and deploying our middleware (see Separate Middleware for more information),
• reduced and simplified configuration steps of BigCommerce instance,
• moved the logic of @vsf-enterprise/bigcommerce package to the theme composables,
• reduced the code complexity and improved performance,
• updated StorefrontUI version to v0.13.3

Backward-incompatible changes

Crucial breaking changes in the v2.0.0 compared to the v1.3.0 release.

What has changed	How it has changed
@vue-storefront/core package	Package was removed from the dependences, features (that were being used in the integration) was moved to the theme.
Logger of @vue-storefront/core package	Loger is now available with usage of useLogger composable.
onSSR of @vue-storefront/core package	Instead of onSSR, now useAsync and useFetch from @nuxtjs/composition-api are being used.
sharedRef of @vue-storefront/core package	Global state management with sharedRef was replace by Pinia (opens new window)
Routes	Routes looks the same, but are no longer defined in @vue-storefront/core package, they are included in nuxt.config.js file now.
@vsf-enterprise/bigcommerce package	@vsf-enterprise/bigcommerce package was removed from the dependences, features and logic and interfaces has been changed and moved to the theme.
useCart of @vue-storefront/core package	useCart has been moved to the theme, see useCart composable. for more information.
useCategory of @vue-storefront/core package	useCategory has been merged with useCategoryTree, see useCategory composable. for more information.
useCategoryTree of @vue-storefront/core package	useCategoryTree has been merged with useCategory, see useCategory composable. for more information.
useGuestWishlist of @vue-storefront/core package	useGuestWishlist has been moved to the theme, see useGuestWishlist composable. for more information.
useProduct of @vue-storefront/core package	useProduct has been moved to the theme, see useProduct composable for more information.
useReview of @vue-storefront/core package	useReview has been moved to the theme, see useReview composable. for more information.
useUser of @vue-storefront/core package	useUser has been moved to the theme, see useUser composable for more information.
useUserOrder of @vue-storefront/core package	useUserOrder has been moved to the theme, see useOrder composable for more information.
useUserOrderByCart of @vue-storefront/core package	useUserOrderByCart has been moved to the theme, see useSearchOrderByCart composable for more information.
useUserOrderProducts of @vue-storefront/core package	useUserOrderProducts has been moved to the theme, see useOrderProducts composable for more information.
useUserShipping of @vue-storefront/core package	useUserShipping has been moved to the theme, see useUserShipping composable for more information.
useWishlist of @vue-storefront/core package	useWishlist has been moved to the theme, see useWishlist composable for more information.
useCartData composable	Cart helpers can now be imported from ~composables/useCart/helpers.
useCategoryData composable	Category helpers can now be imported from ~composables/useCategory/helpers.
useFacetData composable	useFacetData has been refactored and renamed to useSortOptions.
useOrderData composable	Order helpers can now be imported from ~composables/useOrder/helpers.
usePaginationData composable	usePaginationData has been refactored and renamed to usePagination.
useProductData composable	Product helpers can now be imported from ~composables/useProductData/helpers
useReviewData composable	Review helpers can now be imported from ~composables/useReview/helpers
useUserShippingData composable	Shipping helpers can now be imported from ~composables/useUserShipping/helpers
useUserShippingData composable	Shipping helpers can now be imported from ~composables/useUserShipping/helpers

WARNING

Composables in theme may have different interfaces, despite of the same name. See List of composables for more information about the new interfaces.

Project configuration

TIP

See Configuring BigCommerce and Configuring Vue Storefront for complex configuration information.

If you're migrating from v1.3.0, you need to adjust project configuration. The only breaking change here is adding new environment variables:

• DEFAULT_CHANNEL_ID - Channel of the default storefront. This value was previously called BIGCOMMERCE_CHANNEL_ID
• API_BASE_URL - Link to the API, see Separate Middleware for more information.

Following environment variables are not being used anymore:

• BIGCOMMERCE_CHANNEL_ID
• BIGCOMMERCE_DEVTOOLS_APP_CLIENT_ID
• BIGCOMMERCE_DEVTOOLS_APP_CLIENT_SECRET
• BIGCOMMERCE_STORE_URL

There are no breaking changes that require updates to your BigCommerce instance, however we encourage you to follow the steps from the Configure Content-Security-Policy Header guide, which is necessary to set up multi-storefront capabilities.