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:
<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.