https://github.com/yottahmd/geostarmap
A web application that visualizes the geographic distribution of GitHub repository stargazers on an interactive world map
https://github.com/yottahmd/geostarmap
Last synced: 3 months ago
JSON representation
A web application that visualizes the geographic distribution of GitHub repository stargazers on an interactive world map
- Host: GitHub
- URL: https://github.com/yottahmd/geostarmap
- Owner: yottahmd
- License: mit
- Created: 2025-06-21T11:35:38.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-06-21T15:04:31.000Z (4 months ago)
- Last Synced: 2025-06-30T18:54:37.938Z (3 months ago)
- Language: TypeScript
- Homepage: https://geostarmap.pages.dev
- Size: 1.71 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GeoStarMap - GitHub Stars Geography Visualizer
A web application that visualizes the geographic distribution of GitHub repository stargazers on an interactive world map.
🌐 **Live Demo:** [https://geostarmap.pages.dev](https://geostarmap.pages.dev)
## Features
- Input any public GitHub repository URL
- View stargazer locations on an interactive map
- Requires GitHub API token to fetch user location data
- Progress tracking while processing users
- Cached geocoding results for performance
- Fully responsive design
- Processes up to 5,000 stargazers per repository
## Development
### Prerequisites
- Node.js 18+
- pnpm
### Setup
```bash
# Install dependencies
pnpm install
# Run development server
pnpm dev
# Build for production
pnpm build
# Run linting
pnpm lint
# Format code
pnpm format
```
## Tech Stack
- React + TypeScript
- Vite
- Tailwind CSS + shadcn/ui
- Leaflet for maps
- OpenStreetMap for geocoding
## Data Sources
- City geocoding data from [SimpleMaps World Cities Database](https://simplemaps.com/data/world-cities) (Basic version) - Licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)