---
name: bijection-convalytics
description: "Evaluate and integrate the Convalytics component with Bijection."
---

# Convalytics

Bijection component for server-side analytics tracking with Convalytics

- Package: @bijectionhq/convalytics
- Category: Integrations
- Status: Preview
- License: MIT
- Bijection source (repository access required): https://github.com/bijectionhq/convalytics/tree/7ac95d6ab3baf4454fe065345fd2e0fc958abc4d
- Upstream: https://github.com/Dan-Cleary/convalytics-convex-component/tree/46c2effc03914718546861ef909916a17fa712a4
- Documentation: https://docs.bijection.com/components/using
- Directory: https://bijection.com/components/convalytics

## Get the source

Bijection repository access is required. Request access at https://bijection.com/contact.

```sh
git clone https://github.com/bijectionhq/convalytics.git
cd convalytics
git checkout 7ac95d6ab3baf4454fe065345fd2e0fc958abc4d
```

## Before using this component

Read the package README at the recorded revision for setup, dependencies, and API examples. Upstream documentation describes the original package and may differ from the Bijection adaptation. This is a source candidate for evaluation. Catalog inclusion does not establish npm availability or runtime qualification. Check compatibility with your SDK and deployment before adoption. External providers run their own compute.

## Integration workflow

1. Read the source README and package manifest at the recorded revision.
2. Confirm the required SDK, dependency availability, and runtime compatibility.
3. Follow the component's documented setup and configuration. Never invent an npm install command from a catalog package name.
4. Keep credentials in the project's existing secret store.
5. Follow the project's execution rules for verification and report what was actually checked.

## Original upstream skill

The following guidance describes convalytics-dev. Its installation commands and APIs refer to the upstream package. Evaluate compatibility with the Bijection source separately.


> Agents: read this skill fully before writing code that uses Convalytics. Follow the installation and configuration steps exactly.

# Convalytics

## Instructions

Convalytics provides server-side analytics for Convex applications, allowing you to track product events reliably from mutations and actions. Unlike client-side tracking, server-side events bypass ad blockers and aren't lost on page unloads. It includes web analytics capabilities and provides a unified dashboard for both server events and browser page views.

### Installation

```bash
npm install convalytics-dev
```

Current npm version: `convalytics-dev@0.3.5`

## Use cases

- Track user lifecycle events like signups, upgrades, and feature adoption from your Convex mutations
- Monitor payment and subscription events from webhook handlers in Convex actions
- Analyze user behavior patterns without worrying about ad blockers or dropped events
- Get reliable analytics data for business metrics and product decisions
- Combine server-side product events with traditional web analytics in one dashboard

## How it works

The component integrates as a Convex component that you register in `convex.config.ts` and configure with a write key from the Convalytics dashboard. You create an analytics singleton that wraps the component with your credentials.

To track events, call `analytics.track()` from your mutations or actions, passing the Convex context and event data including name, userId, and optional properties. Events are delivered asynchronously and failures are logged without affecting your application flow.

For web analytics, you add a script tag to your HTML that points to your Convex deployment URL. The CLI tool `npx convalytics init` can automate the entire setup process, creating projects, installing dependencies, and configuring your environment variables.

## When NOT to use

- When a simpler built-in solution exists for your specific use case
- If you are not using Convex as your backend
- When the functionality provided by Convalytics is not needed

## Resources

- [npm package](https://www.npmjs.com/package/convalytics-dev)
- [GitHub repository](https://github.com/Dan-Cleary/convalytics-convex-component)
- [Live demo](https://convalytics.dev)
- [Convex Components Directory](https://www.convex.dev/components/convalytics-dev)
- [Convex documentation](https://docs.convex.dev)