# Configuration

Usually, the first thing to do after setting up a fresh Vue Storefront project is configuring it. The bare minimum is to provide the API credentials for your integrations.

Your Vue Storefront-related configuration is located in two places:

  • nuxt.config.js is a place where you're configuring properties related only to the frontend part of your application.
  • middleware.config.js is a place where you're configuring your integration middleware. You will put there API keys, integration configurations, custom GraphQL queries, and new API endpoints.

# Configuring Integrations

Most of the integrations business logic is placed in the Integration Middleware. Therefore they're configurable through the integrations field in middleware.config.js.

// middleware.config.js
module.exports = {
  integrations: {
   // integration configs

Sometimes integrations also expose a Nuxt module to configure frontend-related properties and i18n.

// nuxt.config.js
[`@vue-storefront/{INTEGRATION}/nuxt` {
  i18n: {
    // i18n config

# Configuring Nuxt

We try to use the most common modules from Nuxt Community whenever it's possible. For example, we use the nuxt-i18n package for internationalization and the @nuxtjs/pwa package PWA capabilities. You can find a list of the Nuxt modules used in the default theme here. Each of them is configured in a way that works best for the majority of users.

There are some features and behaviors that are specific to Vue Storefront only yet not specific to a certain integration. You can configure such things through @vue-storefront/nuxt module.

Below you can find its default configuration:

// nuxt.config.js
    // use only if you're developing an integration
    // adds theme inheritance mechanism
    coreDevelopment: false,
    logger: {
      // read about this part in `Advanced/Logging` section
    performance: {
      httpPush: true,
      // installs https://purgecss.com/guides/nuxt.html
      // CAUTION: Could break classess generated dynamically (eg variable + '-secondary')
      purgeCSS: {
        enabled: false,
        paths: ['**/*.vue'],
    // use `module` field from `package.json` for included packages
    // custom configuration will be merged with the default one
    // this property is used mainly to process ESM and benefit the most from treeshaking
    useRawSource: {
      dev: ['@storefront-ui/vue', '@storefront-ui/shared'],
      prod: ['@storefront-ui/vue', '@storefront-ui/shared'],


It's unsafe and not recommended to remove @vue-storefront/nuxt from your project. Integrations and other modules rely on it.

# Configuring Server Middleware

You can read more about the Server Middleware and its configuration on the Server Middleware page.

# Integration References

# Setting up official eCommerce integrations

# Configuration references of official eCommerce integrations