How to use UseGap

Track real feature usage, compare it against requests, and get a Truth Score (0–100) that tells you what to build next.

Step 1

Sign up and create a project

Create a free account at usegap.app/signup. During onboarding, you'll name your project and set the allowed origin domain. You'll get a Tracking Token (ut_...) for client-side tracking and an endpoint URL.

Tracking Token vs API Key

ut_... Tracking Token — recommended for client-side. Write-only, can only send events. Safe to expose in your HTML.

ug_... API Key — for server-side use only. Has full read/write access. Never expose it in client-side code.

Step 2

Install the script

Paste the following snippet before the closing </body> tag in your HTML. It's under 5KB, has zero dependencies, and buffers events locally to minimize API calls.

index.html

<script src="https://usegap.app/ug.min.js"></script>
<script>
  UseGap.init({
    trackingToken: 'ut_YOUR_TOKEN',
    endpoint: 'https://usegap.app/api/track'
  });
</script>

Step 3

Tag your features

Add the data-feature="..." attribute to any HTML element you want to track. UseGap will automatically capture clicks, hovers, and views.

your app html

<!-- Buttons -->
<button data-feature="export-csv">Export CSV</button>
<button data-feature="invite-team">Invite Team</button>

<!-- Links -->
<a href="/billing" data-feature="billing-page">Billing</a>

<!-- Any element -->
<div data-feature="onboarding-wizard">...</div>

You can also track events programmatically with JavaScript:

app.js

// Programmatic tracking (optional)
UseGap.track('export-csv', 'click');
UseGap.track('search-bar', 'view');

Ready to see the truth?

Create your account and start tracking feature usage in under 2 minutes.

Start free trial