SMALL WEB COMPONENTS · STATIC FIRST
Your website has been places.
A tiny visitor map for any website. Framework-free and MIT-licensed; public source and the v0.1.0 release open together.
View on GitHub · available with v0.1.0. The repository stays private until release.
LIVE MAP · VISITOR MAP DEMO
Aggregate country data
COUNTER + WEBSITE PASSPORT
A small record of the journey.
The passport keeps historical discovery numbers, even when countries are sorted by visitors.
This is the same live demo data as the map above. The horizontal passport scrolls inside its own area.
01 / START WITH STATIC DATA
A map, without a stack.
Put the two map files beside your page. Add the classic script and a few country codes. No framework, account, tracker, Worker or database is needed.
<script src="./visitor-map.js"></script>
<visitor-map countries="DE,NL,JP" credit></visitor-map>The component loads its colocated stylesheet. Attribution is optional; omit the credit attribute to hide it. The public source and downloadable release become available with v0.1.0.
02 / ADD YOUR OWN DATA
Live data is just JSON.
Point the component at an endpoint you control. Serving the map and loading its data are separate from collecting visits.
<visitor-map src="/stats.json"></visitor-map>For automatic discovery, add the optional tracker and self-host the reference Worker and D1 database:
visitortiny tracker Worker D1your stats JSON components
The collector is optional. Use your own endpoint and keep the data on infrastructure you operate; the Visitor Map demo Worker is not a production service for your site.
A PRECISE PRIVACY SUMMARY
Small data, stated plainly.
- Visitor Map sets no cookies, localStorage identifier or browser fingerprint.
- The optional tracker temporarily processes request IP and User-Agent for daily deduplication; raw values are not persisted in application D1.
- A keyed daily dedupe token is kept briefly (about 48 hours with normal cleanup). D1 keeps aggregate country statistics; counts are estimates, not exact unique people.
The live example on this page uses the optional tracker for demo traffic. Network infrastructure may process requests; operators remain responsible for their own deployment and legal obligations.
A SMALL COLOR CHANGE
Your colors can come through.
A real map component with static example countries, not live traffic.
OPEN SOURCE · SELF-HOSTABLE
Your site. Your data. Your choice.
Use a plain static JSON file, your own endpoint, or the optional reference collector. The components stay separate from the tracker and backend. Source, self-hosting instructions, issues and contributions will be public with v0.1.0.
View on GitHub · available with v0.1.0. The repository remains private until then. This page is a project demo, not hosted analytics.