Open Source  ·  Self-Hosted  ·  Apache 2.0

Invite attribution
that just works

When a user clicks your invite link and installs the app, the invite code resolves automatically on first launch — no clipboard tricks, no login required.

POST /v1/resolutions
// Mobile SDK — first launch
POST /v1/resolutions
Authorization: Bearer sk_live_•••
 
200 OK
{
  "inviteCode": "INV-2024-K9X",
  "channel": "fuzzy",
  "confidence": 0.94
}
How it works

Five steps. Zero friction.

Device fingerprinting bridges the gap between a web click and an app install — without cookies, logins, or clipboard permission.

Share Link

User A shares an invite link

Click

User B visits your landing page

Fingerprint

JS SDK captures browser signals

Install

User B installs and opens the app

Matched

Invite code resolved automatically

Why share-installs

Everything you need.
Nothing you don't.

Built for developers who want precise invite tracking without third-party lock-in.

Fully Self-Hosted

Your data never leaves your infrastructure. Deploy with a single docker compose up command. No vendor lock-in, no monthly fees.

Three-Channel Resolution

Redis exact hash match → PostgreSQL fuzzy scoring → Android clipboard fallback. Maximises match rate across all scenarios.

Smart Fingerprinting

Multi-signal matching across timezone, screen, IP subnet, language, and hardware. Configurable confidence threshold (0–1).

Native SDKs

First-class Swift SDK for iOS, Kotlin SDK for Android, and a TypeScript Web SDK. All open source, ready to ship.

Your Invite Codes

Bring your own invite codes. We store and return them verbatim. Generation, validation, and usage limits are yours to own.

Multi-Tenant Ready

Run as a shared SaaS with per-project API keys and usage quotas, or deploy in single-tenant mode with zero auth overhead.

SDKs

Integrate in minutes

Official SDKs for all major platforms. Drop them in and go.

Web / JavaScript

TypeScript · Browser + Node
npm install @share-installs/js-sdk

iOS

Swift 5.9+ · Swift Package Manager
swift package add share-installs/sdk-ios

Android

Kotlin · Gradle
implementation("com.share-installs:sdk-android:0.0.1")
Deployment

Your infrastructure, your choice

Zero-config self-hosting or full SaaS with GitHub OAuth and usage quotas — flip a single env var.

Self-Hosted

Run Your Own

Deploy on your servers. No API keys, no auth overhead. Perfect for private teams and single-app deployments.

  • One-command Docker deploy
  • No authentication required
  • Optional admin secret for project management
  • PostgreSQL + Redis included in Compose
SaaS Mode

Managed Service

Enable multi-tenant mode for teams. GitHub OAuth login, per-project API keys, and plan-based usage quotas.

  • GitHub OAuth login
  • Per-project API key management
  • Free / Pro / Unlimited tiers
  • Dashboard with usage analytics
Quick Start

Up and running in 60 seconds

Start with self-hosted mode. Upgrade to SaaS when you need multi-tenancy.

bash
# Clone and start all services
git clone https://github.com/ceeyang/share-installs.git
cd share-installs
docker compose up --build
bash
# Verify the server is running
curl http://localhost:6066/health
→ {"status":"ok","mode":"self-hosted","version":"1.0.0"}
Full documentation

Open source and free forever

Self-host it, fork it, or contribute. Licensed under Apache 2.0.

Get Started Free Star on GitHub