🌐 DevGlobe

The global network for top open-source developers — discover, connect, and celebrate the people behind the code

26,000+ developers · ranked by stars, commits, repo reach & StackOverflow reputation · searchable by skill, location & language

---

✨ Features

• Interactive 3D Globe — Explore developers pinned to their real-world locations using Three.js
• AI-Powered Search — Hybrid + vector search via Azure Cosmos DB (e.g. "AI & deep learning", "full stack JS dev")
• Composite Scoring — Each developer scored 0–100 across 6 dimensions
• Leaderboard — Filter by country, language, or sort by score/stars/commits
• Developer Profiles — Click any pin to see detailed stats, top repos, and contribution breakdown
• Mobile Responsive — Bottom-sheet filters and full-width search on smaller screens

🚀 Quick Start

git clone https://github.com/sajeetharan/devglobe.git
cd devglobe
npm install
npm run dev
# Open http://localhost:5173

The app runs with sample data out of the box — no API keys needed for local development.

Want to test with a real database locally? Use the Azure Cosmos DB Emulator — it runs locally with no Azure subscription required. Set COSMOS_ENDPOINT=https://localhost:8081 and the emulator's key in your .env.

🏗️ Tech Stack

Layer	Technology
Frontend	React 19, Three.js (react-globe.gl), Vite
Search	Azure Cosmos DB (vector + hybrid search)
API	Vercel Serverless Functions
Hosting	Vercel
Data Pipeline	Node.js scripts (GitHub GraphQL, StackOverflow API, geocoding)

📊 Scoring Formula (0–100)

Dimension	Weight	Source
GitHub Stars	25%	Total stars across repos
GitHub Commits	25%	Yearly commit activity
Repo Reach	20%	Forks + watchers
SO Reputation	15%	StackOverflow reputation
SO Engagement	10%	Answer acceptance × count
Community	5%	Followers + badges

All dimensions are log-normalized to prevent outlier domination.

🔧 Building the Full Dataset

Requires API keys — copy .env.example to .env and fill in your tokens.

npm run fetch-github          # Fetch top devs from GitHub GraphQL
npm run fetch-stackoverflow   # Enrich with StackOverflow reputation
npm run geocode               # Convert locations to lat/lng
npm run build-data            # Run full pipeline
npm run upload-cosmos         # Upload to Azure Cosmos DB

📁 Project Structure

├── index.html                  # Entry HTML
├── src/
│   ├── main.jsx                # App bootstrap + Vercel Analytics
│   ├── App.jsx                 # Root component, data loading
│   ├── components/
│   │   ├── Globe.jsx           # 3D globe (react-globe.gl)
│   │   ├── Leaderboard.jsx     # Ranked sidebar with filters
│   │   ├── SearchBar.jsx       # Hybrid/vector search input
│   │   ├── DetailPanel.jsx     # Developer detail card
│   │   ├── Header.jsx          # Top bar with branding
│   │   └── LoadingOverlay.jsx  # Loading state
│   └── utils/
│       ├── scoring.js          # Composite scoring algorithm
│       └── format.js           # Number formatting helpers
├── api/
│   ├── developers.js           # List all developers
│   ├── developer.js            # Single developer lookup
│   └── search.js               # Cosmos DB vector/hybrid search
├── scripts/                    # Data pipeline scripts
├── styles/main.css             # Dark theme styles
└── data/
    └── developers-sample.json  # Sample data for local dev

🌍 Deploy to Vercel

npx vercel

Required environment variables:

Variable	Purpose
COSMOS_ENDPOINT	Azure Cosmos DB endpoint
COSMOS_KEY	Azure Cosmos DB key
COSMOS_DATABASE	Database name
COSMOS_CONTAINER	Container name

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for setup instructions and areas where help is needed.

📄 License

MIT — see LICENSE for details.

---

⭐ Star this repo if you find it useful!

Built with ❤️ by @sajeetharan