Documentation

Everything you need to start tracking events in your app. Native SDKs for every platform, or use our simple REST API.

SDKs

Swift SDK

iOS, macOS, tvOS, watchOS

v0.5.3

Kotlin SDK

Android

v0.2.2

React Native SDK

iOS & Android

v0.3.2

Flutter SDK

iOS & Android

v0.2.2

JavaScript SDK

Web & Node.js

v0.4.2

Quick Start

Copy-paste examples to get started quickly. Replace your_api_key_here with your actual API key.

curl -X POST https://mostlygoodmetrics.com/v1/events \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key_here" \
  -d '{
    "name": "test_event",
    "user_id": "user_123",
    "properties": {
      "button": "signup",
      "screen": "home"
    }
  }'

A successful request returns HTTP 204 (no content).

Add via Swift Package Manager:

View on GitHub

https://github.com/Mostly-Good-Metrics/mostly-good-metrics-swift-sdk

Initialize and track events:

import MostlyGoodMetrics

// Initialize once (e.g., in AppDelegate)
MgmCore.configure(apiKey: "your_api_key_here")

// Identify user (optional)
MgmCore.identify(userId: "user_123")

// Track events
MgmCore.track("button_tapped", properties: [
    "button": "signup",
    "screen": "home"
])

Add JitPack repository to settings.gradle.kts:

View on GitHub

dependencyResolutionManagement {
    repositories {
        maven { url = uri("https://jitpack.io") }
    }
}

Add to build.gradle.kts:

implementation("com.github.Mostly-Good-Metrics:mostly-good-metrics-android-sdk:0.2.2")

Initialize and track events:

import com.mostlygoodmetrics.sdk.MostlyGoodMetrics

// Initialize once in your Application class
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        MgmCore.configure(this, "your_api_key_here")
    }
}

// Identify user (optional)
MgmCore.identify("user_123")

// Track events
MgmCore.track("button_tapped", mapOf(
    "button" to "signup",
    "screen" to "home"
))

Install via npm:

View on GitHub

npm install @mostly-good-metrics/react-native

Initialize and track events:

import MostlyGoodMetrics from '@mostly-good-metrics/react-native';

// Initialize once at app startup
MgmCore.configure('your_api_key_here');

// Identify user (optional)
MgmCore.identify('user_123');

// Track events
MgmCore.track('button_clicked', {
  button: 'signup',
  screen: 'home'
});

Install via npm:

View on GitHub

npm install @mostly-good-metrics/javascript

Initialize and track events:

import { MostlyGoodMetrics } from '@mostly-good-metrics/javascript';

// Initialize once at app startup
MgmCore.configure({
  apiKey: 'your_api_key_here'
});

// Identify user (optional)
MgmCore.identify('user_123');

// Track events
MgmCore.track('button_clicked', {
  button: 'signup',
  screen: 'home'
});

Add to pubspec.yaml:

View on GitHub

dependencies:
  mostly_good_metrics_flutter: ^0.2.2

Initialize and track events:

import 'package:mostly_good_metrics_flutter/mostly_good_metrics_flutter.dart';

// Initialize once at app startup
await MgmCore.configure(
  MGMConfiguration(
    apiKey: 'your_api_key_here',
    appVersion: '1.0.0',
  ),
);

// Identify user (optional)
MgmCore.identify('user_123');

// Track events
MgmCore.track('button_clicked', properties: {
  'button': 'signup',
  'screen': 'home',
});

REST API

POST


              https://mostlygoodmetrics.com/v1/events

Headers

Authorization: Bearer your_api_key_here

Content-Type: application/json

Request Body

{
  "events": [
    {
      "name": "button_clicked",
      "user_id": "user_123",
      "properties": {
        "button": "signup",
        "page": "/pricing"
      }
    }
  ]
}

Fields

events

required Array of event objects to track

name

required Event name (e.g., "button_clicked", "purchase_completed")

user_id

optional Unique identifier for the user

properties

optional Object with custom properties for the event

timestamp

optional ISO 8601 timestamp (defaults to server time)

Response

Returns 204 No Content on success.

Ready to get started?

Create a free account and start tracking events in minutes.

Get started for free