# 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.

Test your knowledge →