Vue SDK - Tell

npm install @tell-rs/vue @tell-rs/browser

A plugin with a composable and global $tell property.

@tell-rs/vue is a thin wrapper around the browser SDK. It connects Tell to Vue’s app lifecycle — the plugin calls configure() on install and close() on app unmount. You install @tell-rs/browser alongside because that’s where the actual tracking, sessions, and transport live.

Setup

import { createApp } from "vue";
import { TellPlugin } from "@tell-rs/vue";

const app = createApp(App);
app.use(TellPlugin, { apiKey: "YOUR_API_KEY" });
app.mount("#app");

With options

import { redact, SENSITIVE_PARAMS } from "@tell-rs/browser";

app.use(TellPlugin, {
  apiKey: "YOUR_API_KEY",
  options: {
    beforeSend: redact({ stripParams: SENSITIVE_PARAMS }),
    captureErrors: true,
  },
});

Composable

<script setup>
import { useTell } from "@tell-rs/vue";

const tell = useTell();

function onSignUp() {
  tell.track("Sign Up Clicked", { plan: "pro" });
  tell.identify("user_123", { name: "Alice" });
}
</script>

<template>
  <button @click="onSignUp">Sign Up</button>
</template>

Page view tracking with Vue Router

import { tell } from "@tell-rs/vue";
import router from "./router";

router.afterEach((to) => {
  tell.track("Page Viewed", { path: to.path, url: to.fullPath });
});

What you get from the browser SDK

All features documented in the browser SDK guide are available — sessions, device context, super properties, structured logging, opt-out, and beforeSend hooks. The Vue package only adds lifecycle integration and the composable.