How estopacema/mvp-global works
MVP Global is a snapshot-backed atlas and accessible directory of Microsoft MVPs. Visitors explore the globe or directory, refine results with URL-backed search and filters, and open shareable country or profile pages; profile links also provide generated social previews. The runtime uses bundled catalog/profile data rather than a database or live directory API. A separate refresh branch scrapes and imports updated snapshot data. Edges follow shown imports or README descriptions; scraper internals and some route wiring were not sampled, so those links are documented rather than inferred.
Main entry points: server-directory.ts Server directory · directory-view.tsx Directory view · explorer.tsx Globe explorer · page.tsx Profile page
Components 27
Visitor experience
- Globe home
src/app/page.tsx - Directory route
src/app/mvps/page.tsx - Country pages
src/app/countries/[country]/page.tsx - About page
src/app/about/page.tsx
Search and globe
- Directory view
src/components/directory-view.tsx - Globe explorer
src/components/explorer.tsx - Globe capability
src/components/globe/globe-client.tsx - Globe rendering
src/components/globe/globe-view.tsx - Globe geometry
src/lib/globe-geometry.ts - Globe palette
src/lib/globe-palette.ts - Search filters
src/components/filter-bar.tsx - URL filter state
src/hooks/use-filters.ts - Directory querying
src/lib/directory.ts - Result selection
src/hooks/use-directory-result.ts - Profile results
src/components/results.tsx - Snapshot catalog
src/lib/catalog.ts - Server directory
src/lib/server-directory.ts
Profiles and sharing
- Profile page
src/app/mvps/[id]/page.tsx - Profile details
src/components/mvp-id-card.tsx - Preview route
src/app/mvps/[id]/preview/route.ts - Preview rendering
src/lib/profile-preview-image.tsx - Profile sharing
src/components/profile-share.tsx
Snapshot refresh
- MVP scraper
mvp-scraper/scripts/scrape-mvps.ts - Snapshot importer
scripts/import-data.ts - Committed snapshot
src/lib/server-directory.ts
Other components
- Visitor
- Microsoft directory
Connections 34
- Visitor → Globe home: opens
README.md - Visitor → Directory route: opens
README.md - Visitor → Country pages: opens
README.md - Visitor → Profile page: opens
README.md - Globe home → Globe explorer: renders
src/app/page.tsx - Directory route → Directory view: renders
src/app/mvps/page.tsx - Country pages → Directory view: renders
src/app/countries/[country]/page.tsx - Directory view → Search filters: renders
src/components/directory-view.tsx - Directory view → Profile results: renders
src/components/directory-view.tsx - Directory view → Result selection: uses
src/components/directory-view.tsx - Globe explorer → Globe capability: renders
src/components/explorer.tsx - Globe explorer → Search filters: renders
src/components/explorer.tsx - Globe explorer → Profile results: renders
src/components/explorer.tsx - Globe capability → Globe rendering: loads
src/components/globe/globe-client.tsx - Globe rendering → Globe geometry: uses
src/components/globe/globe-view.tsx - Globe rendering → Globe palette: uses
src/components/globe/globe-view.tsx - Search filters → URL filter state: updates
src/components/filter-bar.tsx - URL filter state → Directory querying: parses
src/hooks/use-filters.ts - Result selection → Directory querying: queries
src/hooks/use-directory-result.ts - Result selection → Snapshot catalog: reads
src/hooks/use-directory-result.ts - Profile results → Directory querying: uses
src/components/results.tsx - Server directory → Snapshot catalog: reads
src/lib/server-directory.ts - Server directory → Directory querying: queries
src/lib/server-directory.ts - Directory route → Server directory: loads results
src/app/mvps/page.tsx - Country pages → Server directory: loads results
src/app/countries/[country]/page.tsx - Profile page → Server directory: loads profile
src/app/mvps/[id]/page.tsx - Profile page → Profile details: renders
src/app/mvps/[id]/page.tsx - Profile page → Profile sharing: renders
src/app/mvps/[id]/page.tsx - Preview route → Server directory: loads profile
src/app/mvps/[id]/preview/route.ts - Preview route → Preview rendering: generates
src/app/mvps/[id]/preview/route.ts - Visitor → About page: opens
README.md - Microsoft directory → MVP scraper: provides directory data
README.md - MVP scraper → Snapshot importer: exports data for
README.md - Snapshot importer → Committed snapshot: updates
README.md