Skip to Content
UsageMapDocs

Quickstart

Create a project, add the tracker, and see your first verified page view in about five minutes.

Sign in

Open app.usagemap.dev and sign in with a Stellar wallet: Freighter, xBull, Albedo, LOBSTR, Hana or any wallet that can sign a message. Hardware wallets and multisig accounts can sign a transaction instead. There is no password to create.

Create your project

Choose Find your SCF project to look your project up in the public Stellar project registries and fill the form in for you, or Create a project and type a name and a short name (used in links).

Some projects are reviewed before they count traffic. Until then the project shows Awaiting approval.

Add your website

In the project, choose Add a website. Keep the defaults (profile standard, visitor identifier On) unless you need the strict profile. Then open Settings → Domains and add the domain your site runs on.

Paste the snippet

Open the website's Snippet tab and copy the tag. It already contains your site key and the right integrity hash. Put it in the <head> of every page:

index.html
<script
  src="https://e1.usagemap.dev/lib/1.1.0/standard.js"
  integrity="sha384-AYjFWyBUxxvOL92oDDKxAus7EAPjONT2RDrOiuPh4XUiEJNKkMaZqGVBDw4Lqn0+"
  crossorigin="anonymous"
  data-site="YOUR_SITE_KEY"
  defer
></script>

Using a framework? See framework guides.

See your first event

Deploy, open your site in a normal browser window, then open the website's Installation check tab. Within about a minute it shows your first event and whether it was counted.

Testing locally?

Events from localhost or preview URLs are only counted after you add them as a dev origin, and they are kept for 24 hours, never mixed into your real numbers. Browsers with Global Privacy Control turned on (Brave does this by default) send nothing at all, by design.

Verify your domain

Back in Settings → Domains, choose Verify by DNS TXT record, a file under /.well-known/, or an HTML meta tag. Until your domain is verified, its page views are marked as suspect.

Next steps

Prefer a checklist?

In the app, the project's Set-up wizard and Integration kit walk you through the same steps, with your own site key, domain and ready-to-run curl tests filled in.

On this page