Been There

BeenThere is a simple way to visualize the countries you've visited on an interactive world map.

Select countries, track your travels, and instantly generate a shareable map that others can view with a single link.

Features

• 🌍 Interactive world map
• ✅ Mark visited countries
• 🔗 Share your map via URL
• 🖼️ Export your map as a PNG image
• 🔒 Fully private — no accounts, no backend, no tracking
• 💾 All data is stored directly in the URL

Setup

Install dependencies:

npm install

Create a local env file:

cp .env.example .env

Add your public Mapbox token:

MAPBOX_TOKEN=pk.your_public_mapbox_token_here

Mapbox public tokens are safe to use in browser apps, but you should restrict the token by allowed URLs in your Mapbox account before publishing.

Run with Docker

docker run -d --rm -p 8080:80 -e MAPBOX_TOKEN=pk.your_public_mapbox_token_here ghcr.io/dotzero/been-there:latest

Run with Docker Compose

MAPBOX_TOKEN=pk.your_public_mapbox_token_here docker compose up -d

Development

Start the dev server:

npm run dev

License

MIT