# Installation

Install module into your app.

npm install @vsf-enterprise/amplience --save

or

yarn add @vsf-enterprise/amplience``

Not a Vue Storefront user? You can still use the module in any Nuxt.js application. Learn how.

IMPORTANT: This package is a part of private registry. To install it you'll need to be logged in. If you don't have access to it please contact our support (opens new window).

# Setup


From version 0.2.0 we're using the vue-storefront middleware package. This means that the integration and the API Client connections are handled on server side. To set this new configuration you'll need to follow this steps.

Install @vue-storefront/middleware

npm install @vue-storefront/middleware --save

Create a new file middleware.config.js in your root folder. Pass the configuration.

module.exports = {
  integrations: {
    ampl: {
      location: '@vsf-enterprise/amplience/server',
      configuration: {
        url: 'https://yourname.cdn.content.amplience.net',
      },
    },
    // ... other configs
  },
}

In the nuxt.config.js file just leave the module initialization. Like this.

modules: ['@vsf-enterprise/amplience/nuxt']

You will also need to register Amplience module as a rawSource in the @vue-storefront/nuxt module. Like that.

['@vue-storefront/nuxt', {
  ...
  useRawSource: {
    dev: ['@vsf-enterprise/amplience'],
    prod: ['@vsf-enterprise/amplience'],
  }
}],

Still using the < 0.2.0 version? Check the old installation guide here.


# Not a Vue Storefront user?

If you want to use this integration with a stand-alone Nuxt app you will need additional Vue Storefront Nuxt module. It will handle the asynchronous requests, install the Nuxt Composition API module and will provide some extra methods like onSSR.

Install @vue-storefront/nuxt module into your app.

npm i @vue-storefront/nuxt --save

or

yarn add @vue-storefront/nuxt

Then register it in the nuxt.config file.

modules: [
  ['@vue-storefront/nuxt'],
]