/nuxt-intercom

💬 NuxtJS module for Intercom

Primary LanguageTypeScriptMIT LicenseMIT

nuxt-intercom

NuxtJS module for Intercom

Table of contents

Main features

  • Load Intercom only when required (once $intercom is called)
  • Reuse the same instance across all components
  • TypeScript support

Setup

  1. Add nuxt-intercom dependency to your project:
npm install nuxt-intercom
  1. Add nuxt-intercom module and configuration to nuxt.config.js:
export default {
  // ...other config options
  modules: ["nuxt-intercom"];
  intercom: {
    appId: 'my_app_id',
  }
}
  1. (Optional) TypeScript support. Add nuxt-intercom to the types section of tsconfig.json:
{
  "compilerOptions": {
    "types": ["nuxt-intercom"]
  }
}

Options

disabled

  • Type: Boolean
  • Default: false

Disable Intercom. Useful for non-production environments.

appId

  • Type: String

The app_id of your Intercom app which will indicate where to store any data.

i18n

  • Type: Boolean
  • Default: false

Enable i18n-module integration.

hideDefaultLauncher

  • Type: Boolean
  • Default: false

Hide the default launcher icon. Setting to false will forcefully show the launcher icon.

alignment

  • Type: String
  • Default: right

Dictate the alignment of the default launcher icon to be on the left/right. Possible values: "left" or "right" (any other value is treated as right).

horizontalPadding

  • Type: Number
  • Default: 20

Move the default launcher icon horizontally. Padding from right side of screen Minimum value: 20.

verticalPadding

  • Type: Number
  • Default: 20

Move the default launcher icon vertically. Padding from bottom of screen. Minimum value: 20.

enableMobilePadding

  • Type: Boolean
  • Default: false

Apply the verticalPadding property to mobile devices.

Usage

It can be used inside components like:

<button type="button" @click="$intercom('show')">Chat with us</button>

Intercom: Javascript API: Methods

License

See the LICENSE file for license rights and limitations (MIT).