https://github.com/dotzero/been-there
🌍 BeenThere is a simple way to visualize the countries you've visited on an interactive world map
https://github.com/dotzero/been-there
geography map travel-map visited-countries world-map
Last synced: 20 days ago
JSON representation
🌍 BeenThere is a simple way to visualize the countries you've visited on an interactive world map
- Host: GitHub
- URL: https://github.com/dotzero/been-there
- Owner: dotzero
- License: mit
- Created: 2026-05-30T12:35:12.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-06-12T07:50:47.000Z (about 1 month ago)
- Last Synced: 2026-06-12T09:24:07.200Z (about 1 month ago)
- Topics: geography, map, travel-map, visited-countries, world-map
- Language: JavaScript
- Homepage: https://map.dotzero.dev
- Size: 614 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```bash
npm install
```
Create a local env file:
```bash
cp .env.example .env
```
Add your public Mapbox token:
```env
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
```bash
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
```bash
MAPBOX_TOKEN=pk.your_public_mapbox_token_here docker compose up -d
```
## Development
Start the dev server:
```bash
npm run dev
```
## License
[MIT](https://opensource.org/license/mit)