Version: 0.6.9 | Last updated: 2026-06-18
Free, open-source developer intelligence platform built around GitHub stargazer geography. No account required.
→ https://starmapper.bruniaux.com
Paste a GitHub repo URL and get an interactive world map of every stargazer, geocoded in real time. Beyond the map: stats by country/city/company, velocity trends, developer profiles, language distribution across 180+ countries, a live watch mode for launch days, and a Chrome Extension that injects a Map button on every GitHub page.
The core insight: stars are a proxy for developer community. Where those developers live tells you where your project has traction, which markets are accelerating, and who your most influential users are.
The core. Given a GitHub repo, StarMapper fetches all stargazers via the GitHub GraphQL API, geocodes their self-declared locations through a 3-tier cascade (Jawg → Geoapify → Nominatim), and renders a MapLibre GL map with native GeoJSON clustering.
- Progressive loading — points appear as each batch of 100 users is geocoded. No waiting for the full scan.
- Heatmap mode — toggle between scatter dots and heat density. One button in the dock.
- Multi-repo compare — overlay two repos on the same map. Points from repo A are blue, repo B are purple. Shows audience overlap at a glance.
- Animated timelapse — weekly buckets replay on the map at 0.5×→4× speed. Based on
starredAttimestamps already in DB. - Filters — country, city, company, follower count, date range, tier. All combinable.
- Deep link sharing — the Share modal encodes all active filters into a URL. Opening it restores the exact view with a dismissible "Shared view" pill.
- Star growth timeline — "Growth" button in the Dock opens a bar chart of weekly star accumulation. Shows the shape of growth (steady climb, viral spike, plateau) as a complement to the
+N/movelocity indicator. Data fromstarredAtalready in DB; falls back to in-memory scan data for recent, uncached repos. - Watch mode — during a product launch, polls GitHub every 60s and shows
+N ★ · India, Germanywith a pulsing badge. Auto-stops after 10 min of inactivity. No DB writes, cache-free. - Shared cache — first scan is cached globally. Any subsequent visitor loads the same repo instantly, no re-scan.
Maps the people who built a repo. Contributors are fetched from GitHub's REST endpoint, then locations are resolved via a GraphQL batch (100 logins per request) and geocoded through the same 3-tier cascade as repo maps.
- Dot size by commit count: contributors with more commits render as larger points. Commit count is cast into the
followersfield so the existing cluster and popup rendering works without forking the map component. The popup shows "N commits" via acontext: "contributors"field. - Side panel: left-side drawer listing contributors sorted by commit count. Each row has a commit badge and a pin icon that flies the map to their location. An "Unmapped" tab lists contributors whose location couldn't be resolved.
- Auto-start: if a GitHub token is already stored, the scan starts immediately on page load without a manual click.
- Progress pill: shows mapped count vs total in real time during the scan.
- Entry points: direct URL,
/reposcommunity table Contributors column, announcement banner ("Contributors Map →"), landing page explore section card. - Onboarding tour: four-step guided tour covering the scan controls, progress pill, and side panel.
Every GitHub user indexed in StarMapper has a followers map. The page geocodes all their GitHub followers through the same 3-tier cascade (Jawg, Geoapify, Nominatim) used for repo stargazers.
- Full-screen map with clustering: GeoJSON cluster layer, same rendering as repo maps. Points appear progressively as each batch of 100 followers is geocoded.
- FollowersPanel side panel: list of followers sorted by influence (follower count), with avatar, name, location, and follower badge. Virtual scroll handles large lists. Click a follower to fly the map to their location.
- Summary badge: mapped count and total, updated in real time during the scan.
- Entry points on profile pages: the followers count badge on
/profile/[login]links to the followers map. A "Map followers" button appears in the profile actions row.
Opened from the map page after a scan.
- Summary cards — total stargazers, geocoded %, countries, cities, companies, top followers
- Notable stargazers — top-5 by followers as avatar chips, visible immediately on open without switching tabs
- Top Stars tab — full leaderboard sortable by followers or public repos, with company badges
- Geographic velocity ("📈 Rising") — compares the 30-day daily rate vs the 31–90-day historical rate per country. Four statuses:
rising(×1.5+),new,stable,declining. Answers "which countries are discovering this repo right now?" - Power tab — cross-repo stargazers: users who starred more than one indexed repo. Identifies your most engaged community members.
Every GitHub username has a StarMapper profile. Two-column layout: scrollable panel with data on the left, sticky mini-map on the right.
- Profile card — bio, followers, location, languages, top repos grid (up to 8)
- Map a repo — full repo picker (up to 500 repos, searchable, sortable by stars or A–Z). One click navigates to the StarMapper map for that repo.
- Nearby developers — list + pins on the map for geolocated devs within X km
- Contact dropdown — GitHub, LinkedIn, email, all obfuscated against scraping. Fetched on demand.
- News & Announcements — devs can publish short posts (280 chars, optional link) authenticated via GitHub PAT. Each profile gets RSS 2.0 and JSON Feed 1.1 feeds (1h CDN cache,
If-Modified-Sincesupported). - Refresh — re-fetches location, followers, and repos from GitHub with a 1h cooldown.
- Auto-fetch on 404 — if a profile isn't in DB yet, it's fetched from GitHub on the first visit automatically.
Four tabs, sticky map that updates in sync with results.
- Top — leaderboard of stargazers ranked by followers. Filterable by country and company. Searchable by
@usernameorusername. - Power users — developers who've starred the most indexed repos. Cross-repo engagement signal.
- Nearby — geolocated developers within a bounding box (set by clicking the map). Shows who your community is concentrated around any location.
- Companies — which companies appear most in developer profiles across all indexed repos.
- Dev Maps — interactive map of developers filtered by programming language. Combobox to switch language, map updates in place. Based on
languages[]field populated from each dev's own public repos. - Language Atlas (
/devs/atlas) — world choropleth showing the dominant language per country. Click a country for breakdown: dominant language, percentage, number of devs. Based oncountry_language_stats_mv, a materialized view refreshed daily.
Two injection points depending on the GitHub page:
- Repo pages (
github.com/owner/repo) — "★ Map" button in the repo action bar. Toolbar popup: current repo + last 5 visited + search field. Right-click context menu on any GitHub repo link. - Profile pages (
github.com/login) — "★ StarMapper" button in the user sidebar, linking tostarmapper.bruniaux.com/profile/[login].
Handles GitHub SPA navigation (Turbo + bfcache). Adapts to dark/light theme via GitHub CSS variables.
For library authors: a table of repos that depend on a published package, across all ecosystems.
- Multi-ecosystem coverage: npm, PyPI, Go, Maven, Cargo, RubyGems, NuGet, and more. Data from ecosyste.ms (no API key, ToS-clean).
- Sortable table: sort by stars, forks, or name. Paginated (50 per page, up to 200). Ecosystem badge per row.
- Deep links: each dependent repo links to its own StarMapper map if indexed.
- 7-day Neon cache: results cached in
dependents_cache, gzip+base64. A "Refresh" button triggers a live fetch with a 1-hour cooldown per repo. - No published package: repos without a package on any registry show a clean empty state (no crash, no spinner loop).
- Feature-flagged:
NEXT_PUBLIC_DEPENDENTS_ENABLEDgates the page and table entry point.
A stdio MCP server for querying StarMapper data from AI agents and Claude Desktop. Install once (npx starmapper-mcp) and any MCP-compatible agent can interrogate GitHub repo audiences without writing API calls.
15 tools across four categories:
Repo analysis: get_repo_stats, get_organic_score, get_velocity, get_influential_stargazers, get_country_stats
People: get_contributors (top 50 contributors with optional location enrichment), get_followers (top 100 followers of any GitHub user, sorted by their own follower count)
Discovery: get_trending, list_repos, get_cache_status, get_global_country_stats (cross-repo country distribution from the materialized view)
Dependencies: get_dependents (who depends on your library, via ecosyste.ms), get_dependencies (what a repo depends on, via GitHub SBOM API)
Ops: index_repo (trigger a full scan), health_check
All tools return structured Markdown. The server hits STARMAPPER_BASE_URL (default: https://starmapper.bruniaux.com) — point it at localhost:3000 for local dev. GITHUB_TOKEN is forwarded server-side for live lookups (contributors, followers, dependencies).
- SVG shield badge (
/api/badge/[owner]/[repo]): star count + countries mapped. 6h CDN cache. Copy Markdown in one click from the map page. - Map image embed (
/api/map-image/[owner]/[repo]?theme=dark|light): full 800×400 SVG scatter map. Use<picture>to serve dark/light variants. Embeddable in any README. - Public GeoJSON API (
GET /api/geo/[owner]/[repo]): aggregate countries + cities (top 50 each), API key authenticated, rate-limited 60 req/min. GDPR-safe (no individual coordinates). For third-party tools and dashboards. - RSS 2.0 + JSON Feed 1.1: per-developer announcement feeds. Subscribable from any RSS reader.
- Organic Score (
GET /api/organic-score/[owner]/[repo]): 0–100 score estimating whether stars are organic or farmed. Three signals: fork/star ratio (40%), watcher/star ratio (5%), zero-follower stargazers (55%). 85.7% accuracy on calibration corpus. Displayed on the repos landing page with a detail modal. - Dependents API (
GET /api/dependents/[owner]/[repo]): paginated list of dependent repos from ecosyste.ms cache. Supports?sort=stars|forks|name&page=&per_page=. Public, 5-min CDN cache.POST .../refreshtriggers a live fetch (1h cooldown).
Next.js 16.2.6 (App Router, Turbopack) + TypeScript 5 + MapLibre GL 5 + Prisma 7 + Neon Postgres (100GB, sponsored) + Jawg Maps (geocoding + tiles), deployed on Vercel.
GitHub GraphQL + REST for stargazer data. Upstash Redis for distributed rate limiting and PAT verification cache.