From 26a214b874d1ab14d240fd7b5a234c6bd40ed48c Mon Sep 17 00:00:00 2001 From: sajeetharan Date: Mon, 3 Aug 2026 11:14:42 +0530 Subject: [PATCH] fix: resolve merge conflicts in README.md and streamline content --- README.md | 159 +----------------------------------------------------- 1 file changed, 2 insertions(+), 157 deletions(-) diff --git a/README.md b/README.md index 8760d8d..b48171e 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,3 @@ -<<<<<<< HEAD
# ๐ŸŒ DevGlobe @@ -8,55 +7,18 @@ [![Live Demo](https://img.shields.io/badge/Live-Demo-blue?style=for-the-badge&logo=vercel)](https://devglobe.vercel.app) [![GitHub Stars](https://img.shields.io/github/stars/sajeetharan/devglobe?style=for-the-badge&logo=github)](https://github.com/sajeetharan/devglobe/stargazers) [![License](https://img.shields.io/github/license/sajeetharan/devglobe?style=for-the-badge)](LICENSE) +[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=for-the-badge)](CONTRIBUTING.md) DevGlobe Demo *26,000+ developers ยท ranked by stars, commits, repo reach & StackOverflow reputation*
-======= -# ๐ŸŒ DevGlobe โ€” Visualizing the World's Top Open-Source Contributors - -

- Status - License - Stars - PRs Welcome -

- -

- JavaScript - D3.js - globe.gl - Vercel - Azure Cosmos DB -

- -

- An interactive 3D globe showcasing 40,000+ top open-source contributors worldwide, ranked by GitHub stars, commits, and Stack Overflow impact. -

- -

- ๐Ÿ”— Live Demo -

- ---- - -## ๐Ÿ“ธ Preview - - -

- DevGlobe demo preview -

- -> Want to add this? Drop a screenshot or screen recording of the globe UI in a `docs/` folder and update the path above โ€” see [good first issues](https://github.com/sajeetharan/devglobe/issues) for details. ->>>>>>> origin/main --- ## โœจ Features -<<<<<<< HEAD - **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 @@ -65,72 +27,8 @@ - **Mobile Responsive** โ€” Bottom-sheet filters and full-width search on smaller screens ## ๐Ÿš€ Quick Start -======= -- ๐ŸŒ **Interactive 3D globe** โ€” pan, zoom, and rotate through developer locations in real time -- ๐Ÿ† **Composite ranking** โ€” developers scored across GitHub stars, commits, repo reach, and Stack Overflow reputation -- ๐Ÿ“Š **Rich detail panels** โ€” radar charts, heatmaps, and donut charts per developer, powered by D3.js -- ๐Ÿ” **Searchable leaderboard** โ€” filter and search 40,000+ contributors from a ranked sidebar -- โšก **Fast, serverless data layer** โ€” Vercel serverless functions backed by Azure Cosmos DB -- ๐Ÿงฉ **Zero-config local dev** โ€” runs instantly with bundled sample data, no API keys required - ---- - -## ๐Ÿ—๏ธ Architecture - -``` - โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” - โ”‚ Data Sources โ”‚ - โ”‚ GitHub GraphQL API โ”‚ - โ”‚ Stack Overflow API โ”‚ - โ”‚ Geocoding API โ”‚ - โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ - โ”‚ - โ–ผ - โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” - โ”‚ scripts/ (build pipeline) โ”‚ - โ”‚ fetch โ†’ enrich โ†’ geocode โ”‚ - โ”‚ โ†’ score โ”‚ - โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ - โ”‚ - โ–ผ - โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” - โ”‚ Azure Cosmos DB โ”‚ - โ”‚ (developer records) โ”‚ - โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ - โ”‚ - โ–ผ - โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” - โ”‚ api/developers.js โ”‚ - โ”‚ Vercel serverless โ”‚ - โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ - โ”‚ - โ–ผ - โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” - โ”‚ Frontend (src/) โ”‚ - โ”‚ globe.js โ€” 3D globe โ”‚ - โ”‚ detail-panel.js โ€” D3 โ”‚ - โ”‚ leaderboard.js โ”‚ - โ”‚ scoring.js โ”‚ - โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ -``` ---- - -## ๐Ÿ› ๏ธ Tech Stack - -| Layer | Technology | -|---|---| -| 3D Visualization | [globe.gl](https://globe.gl/) (Three.js) | -| Charts | [D3.js](https://d3js.org/) | -| Frontend | Vanilla JavaScript (no framework), CSS custom properties | -| Backend | [Vercel Serverless Functions](https://vercel.com/docs/functions) | -| Database | [Azure Cosmos DB](https://azure.microsoft.com/en-us/products/cosmos-db) | -| Data Sources | GitHub GraphQL API, Stack Overflow API, Geocoding API | - ---- - -## ๐Ÿš€ Quick Start (with sample data) ->>>>>>> origin/main +## ๐Ÿš€ Quick Start ```bash git clone https://github.com/sajeetharan/devglobe.git @@ -140,13 +38,7 @@ npm run dev # Open http://localhost:5173 ``` -<<<<<<< HEAD The app runs with sample data out of the box โ€” no API keys needed for local development. -======= -No API keys required โ€” the app ships with bundled sample data for local development. - -## ๐Ÿ”ง Build Full Dataset (with API keys) ->>>>>>> origin/main ## ๐Ÿ—๏ธ Tech Stack @@ -183,7 +75,6 @@ npm run build-data # Run full pipeline npm run upload-cosmos # Upload to Azure Cosmos DB ``` -<<<<<<< HEAD ## ๐Ÿ“ Project Structure ``` @@ -212,21 +103,6 @@ npm run upload-cosmos # Upload to Azure Cosmos DB ``` ## ๐ŸŒ Deploy to Vercel -======= -This executes: **GitHub fetch โ†’ StackOverflow fetch โ†’ Geocoding โ†’ Scoring** - -3. Update `DATA_URL` in `src/app.js` to `'data/developers.json'` - -### Individual Pipeline Steps - -```bash -npm run fetch-github # Fetch top devs from GitHub GraphQL -npm run fetch-stackoverflow # Enrich with SO reputation -npm run geocode # Convert locations to lat/lng -``` - -## โ˜๏ธ Deploy to Vercel ->>>>>>> origin/main ```bash npx vercel @@ -234,22 +110,15 @@ npx vercel Required environment variables: -<<<<<<< HEAD | Variable | Purpose | |----------|---------| | `COSMOS_ENDPOINT` | Azure Cosmos DB endpoint | | `COSMOS_KEY` | Azure Cosmos DB key | | `COSMOS_DATABASE` | Database name | | `COSMOS_CONTAINER` | Container name | -======= ---- - -## ๐Ÿ“ Project Structure ->>>>>>> origin/main ## ๐Ÿค Contributing -<<<<<<< HEAD Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions and areas where help is needed. ## ๐Ÿ“„ License @@ -265,27 +134,3 @@ MIT โ€” see [LICENSE](LICENSE) for details. Built with โค๏ธ by [@sajeetharan](https://github.com/sajeetharan) -======= -## ๐Ÿ“ Scoring Formula (0โ€“100) - -| Dimension | Weight | Source | -|---|---|---| -| GitHub Stars | 25% | Total stars | -| GitHub Commits | 25% | Yearly commits | -| Repo Reach | 20% | Forks + watchers | -| SO Reputation | 15% | StackOverflow rep | -| SO Engagement | 10% | Acceptance ร— answers | -| Community | 5% | Followers + badges | - -All dimensions are log-normalized to prevent outlier domination. - ---- - -## ๐Ÿค Contributing - -Contributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions, code style, and open areas to help with. - -## ๐Ÿ“„ License - -MIT ->>>>>>> origin/main