{"id":48289759,"url":"https://github.com/yashab-cyber/gitrank","last_synced_at":"2026-04-04T23:02:22.821Z","repository":{"id":309456373,"uuid":"1036338084","full_name":"yashab-cyber/gitrank","owner":"yashab-cyber","description":"Real-time GitHub ranking badge generator - Generate dynamic SVG badges that show your GitHub ranking based on stars, forks, followers, or commits!","archived":false,"fork":false,"pushed_at":"2025-08-12T00:51:45.000Z","size":92,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-12T02:37:51.964Z","etag":null,"topics":["coder","developer","git","github"],"latest_commit_sha":null,"homepage":"https://www.zehrasec.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yashab-cyber.png","metadata":{"files":{"readme":"README-HACKER.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":"Thank you for considering supporting GitRank Live! 💰"},"created_at":"2025-08-11T23:42:58.000Z","updated_at":"2025-08-12T01:08:40.000Z","dependencies_parsed_at":"2025-08-12T02:37:54.599Z","dependency_job_id":"6c3219c2-effa-47e6-9260-48f7e34cdbc9","html_url":"https://github.com/yashab-cyber/gitrank","commit_stats":null,"previous_names":["yashab-cyber/gitrank"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/yashab-cyber/gitrank","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fgitrank","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fgitrank/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fgitrank/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fgitrank/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashab-cyber","download_url":"https://codeload.github.com/yashab-cyber/gitrank/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fgitrank/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31418287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coder","developer","git","github"],"created_at":"2026-04-04T23:02:06.871Z","updated_at":"2026-04-04T23:02:22.812Z","avatar_url":"https://github.com/yashab-cyber.png","language":"JavaScript","readme":"# GitRank Live - Hacker Edition ⚡\n\n\u003cdiv align=\"center\"\u003e\n\n![GitRank Live](https://img.shields.io/badge/GitRank-Live-00ff7f?style=for-the-badge\u0026logo=github\u0026logoColor=white)\n[![License](https://img.shields.io/badge/license-MIT-cyan.svg?style=for-the-badge)](LICENSE)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg?style=for-the-badge\u0026logo=node.js)](https://nodejs.org)\n\n### 🎨 **Real-time GitHub ranking badges with hacker-style design**\n\n*Generate dynamic SVG badges that show your GitHub ranking with neon colors, rounded corners, and the iconic Octocat*\n\n\u003c/div\u003e\n\n---\n\n## 🔥 **What's New in Hacker Edition**\n\n- **🎨 Dark Theme**: Sleek hacker-style badges with neon green/cyan accents\n- **☀️ Light Theme**: Clean light mode for versatile usage  \n- **🔧 JSON API**: RESTful endpoint for developers to fetch raw ranking data\n- **⚡ Enhanced Design**: Rounded corners, GitHub Octocat icon, improved typography\n- **💻 Monospace Fonts**: Terminal-friendly font stack for that authentic hacker look\n\n---\n\n## 🚀 **Quick Start**\n\n### 🏆 **Embed Your GitHub Rank**\n\n```markdown\n\u003c!-- Dark Theme (Default) --\u003e\n![GitHub Stars](https://gitrank.zehrasec.com/api/badge?user=yourusername\u0026metric=stars\u0026theme=dark)\n![GitHub Followers](https://gitrank.zehrasec.com/api/badge?user=yourusername\u0026metric=followers\u0026style=for-the-badge\u0026theme=dark)\n\n\u003c!-- Light Theme --\u003e\n![GitHub Stars](https://gitrank.zehrasec.com/api/badge?user=yourusername\u0026metric=stars\u0026theme=light)\n![GitHub Commits](https://gitrank.zehrasec.com/api/badge?user=yourusername\u0026metric=commits\u0026style=for-the-badge\u0026theme=light)\n```\n\n### 🎨 **Badge Styles Showcase**\n\n| Style | Dark Theme | Light Theme |\n|-------|------------|-------------|\n| **flat** | `?style=flat\u0026theme=dark` | `?style=flat\u0026theme=light` |\n| **flat-square** | `?style=flat-square\u0026theme=dark` | `?style=flat-square\u0026theme=light` |\n| **for-the-badge** | `?style=for-the-badge\u0026theme=dark` | `?style=for-the-badge\u0026theme=light` |\n| **plastic** | `?style=plastic\u0026theme=dark` | `?style=plastic\u0026theme=light` |\n\n---\n\n## 🔌 **Developer API**\n\n### 📊 **JSON Endpoint**\nGet raw ranking data for your applications:\n\n```bash\n# Badge Generation (SVG)\ncurl \"https://gitrank.zehrasec.com/api/badge?user=USERNAME\u0026metric=stars\u0026theme=dark\"\n\n# Raw Data (JSON)\ncurl \"https://gitrank.zehrasec.com/api/rank?user=USERNAME\u0026metric=stars\"\n\n# User Stats\ncurl \"https://gitrank.zehrasec.com/api/stats/USERNAME\"\n\n# System Health\ncurl \"https://gitrank.zehrasec.com/health\"\n```\n\n```json\n{\n  \"user\": {\n    \"login\": \"octocat\",\n    \"name\": \"The Octocat\",\n    \"avatar_url\": \"https://github.com/images/error/octocat_happy.gif\"\n  },\n  \"metric\": {\n    \"name\": \"stars\",\n    \"value\": 8123,\n    \"formatted\": \"8.1K\"\n  },\n  \"ranking\": {\n    \"percentile\": 95,\n    \"description\": \"Top 5%\",\n    \"tier\": \"expert\",\n    \"badge_color\": \"#ff8500\"\n  },\n  \"benchmarks\": {\n    \"next_tier\": {\n      \"name\": \"Top 1%\",\n      \"value\": 10000,\n      \"needed\": 1877\n    }\n  },\n  \"all_metrics\": {\n    \"stars\": 8123,\n    \"forks\": 2543,\n    \"followers\": 4567,\n    \"commits\": 1234\n  }\n}\n```\n\n### 🛠️ **API Endpoints**\n\n| Endpoint | Description | Response |\n|----------|-------------|-----------|\n| `GET /api/badge` | Generate SVG badge | `image/svg+xml` |\n| `GET /api/rank` | Get ranking data | `application/json` |\n| `GET /api/stats/:user` | Get user statistics | `application/json` |\n| `GET /health` | Health check | `application/json` |\n\n---\n\n## ⚙️ **Parameters**\n\n### 🎯 **Badge Generation**\n```\nGET /api/badge?user={username}\u0026metric={metric}\u0026style={style}\u0026theme={theme}\n```\n\n| Parameter | Required | Options | Default | Description |\n|-----------|----------|---------|---------|-------------|\n| `user` | ✅ | Any GitHub username | - | Target GitHub user |\n| `metric` | ❌ | `stars`, `forks`, `followers`, `commits` | `stars` | Ranking metric |\n| `style` | ❌ | `flat`, `flat-square`, `for-the-badge`, `plastic` | `flat` | Badge style |\n| `theme` | ❌ | `dark`, `light` | `dark` | Color theme |\n| `country` | ❌ | Country name | - | Regional ranking |\n\n### 📊 **JSON API**\n```\nGET /api/rank?user={username}\u0026metric={metric}\n```\n\n---\n\n## 🎨 **Design Features**\n\n### 🌙 **Dark Theme (Hacker Style)**\n- **Background**: Deep space black (`#0d1117`)\n- **Accents**: Neon green (`#00ff7f`) and cyan (`#00ffff`)\n- **Typography**: Monospace fonts for terminal aesthetic\n- **Effects**: Subtle glowing borders and text shadows\n\n### ☀️ **Light Theme**\n- **Background**: Clean white (`#ffffff`)  \n- **Accents**: GitHub blue (`#0969da`)\n- **Typography**: Same monospace fonts for consistency\n- **Effects**: Subtle shadows and clean borders\n\n### 🎯 **Visual Elements**\n- **🐙 Octocat Icon**: Positioned on the left side of each badge\n- **📊 Metric Display**: Clear metric name and ranking\n- **🔢 Value Formatting**: Smart number formatting (1.2K, 5.6M)\n- **🏆 Tier Colors**: Color-coded ranking tiers\n\n---\n\n## 🏆 **Ranking System**\n\n| Tier | Percentile | Color (Dark) | Color (Light) | Requirements |\n|------|------------|--------------|---------------|--------------|\n| **Top 1%** | 99th | ![#ff0080](https://via.placeholder.com/15/ff0080/000000?text=+) Neon Pink | ![#d1242f](https://via.placeholder.com/15/d1242f/000000?text=+) Red | ⭐10K+ stars, 👥5K+ followers |\n| **Top 5%** | 95th | ![#ff4500](https://via.placeholder.com/15/ff4500/000000?text=+) Neon Orange | ![#fb8500](https://via.placeholder.com/15/fb8500/000000?text=+) Orange | ⭐2K+ stars, 👥1K+ followers |\n| **Top 10%** | 90th | ![#00ffff](https://via.placeholder.com/15/00ffff/000000?text=+) Cyan | ![#0969da](https://via.placeholder.com/15/0969da/000000?text=+) Blue | ⭐500+ stars, 👥300+ followers |\n| **Top 25%** | 75th | ![#00ff7f](https://via.placeholder.com/15/00ff7f/000000?text=+) Neon Green | ![#1a7f37](https://via.placeholder.com/15/1a7f37/000000?text=+) Green | ⭐100+ stars, 👥50+ followers |\n| **Top 50%** | 50th | ![#9370db](https://via.placeholder.com/15/9370db/000000?text=+) Purple | ![#8250df](https://via.placeholder.com/15/8250df/000000?text=+) Purple | ⭐20+ stars, 👥10+ followers |\n\n---\n\n## 🚀 **Installation \u0026 Deployment**\n\n### 💻 **Local Development**\n```bash\n# Clone the repository\ngit clone https://github.com/yashab-cyber/gitrank.git\ncd gitrank\n\n# Install dependencies\nnpm install\n\n# Set up environment variables\ncp .env.example .env\n# Add your GitHub token (optional but recommended)\n\n# Start development server\nnpm run dev\n```\n\n### 🐳 **Docker**\n```bash\n# Build and run\ndocker build -t gitrank .\ndocker run -p 3000:3000 --env-file .env gitrank\n\n# Or use Docker Compose\ndocker-compose up\n```\n\n### ☁️ **Cloud Deployment**\n\n#### **Vercel** (Recommended)\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/yashab-cyber/gitrank)\n\n#### **Railway**\n[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template?template=https://github.com/yashab-cyber/gitrank)\n\n#### **Render**\n1. Connect your GitHub repository\n2. Set build command: `npm install`  \n3. Set start command: `npm start`\n4. Add environment variables\n\n---\n\n## 📖 **Usage Examples**\n\n### 🏠 **Personal Profile README**\n```markdown\n\u003cdiv align=\"center\"\u003e\n\n# Hi there! I'm [Your Name] 👋\n\n## 🏆 My GitHub Rankings\n\n![Stars](https://gitrank.zehrasec.com/api/badge?user=yourusername\u0026metric=stars\u0026style=for-the-badge\u0026theme=dark)\n![Followers](https://gitrank.zehrasec.com/api/badge?user=yourusername\u0026metric=followers\u0026style=for-the-badge\u0026theme=dark)\n![Commits](https://gitrank.zehrasec.com/api/badge?user=yourusername\u0026metric=commits\u0026style=for-the-badge\u0026theme=dark)\n\n*Real-time rankings updated every 12 hours*\n\n\u003c/div\u003e\n```\n\n### 🏢 **Repository Badges**\n```markdown\n## 👨‍💻 Maintainer Stats\n\n[![Maintainer Stars](https://gitrank.zehrasec.com/api/badge?user=maintainer\u0026metric=stars\u0026theme=light)](https://github.com/maintainer)\n[![Maintainer Followers](https://gitrank.zehrasec.com/api/badge?user=maintainer\u0026metric=followers\u0026theme=light)](https://github.com/maintainer)\n```\n\n### 🌐 **HTML Integration**\n```html\n\u003cdiv class=\"github-stats\"\u003e\n  \u003cimg src=\"https://gitrank.zehrasec.com/api/badge?user=developer\u0026metric=stars\u0026style=flat-square\u0026theme=dark\" alt=\"GitHub Stars Ranking\"\u003e\n  \u003cimg src=\"https://gitrank.zehrasec.com/api/badge?user=developer\u0026metric=forks\u0026style=flat-square\u0026theme=dark\" alt=\"GitHub Forks Ranking\"\u003e\n\u003c/div\u003e\n```\n\n---\n\n## 🔧 **Configuration**\n\n### 🔐 **Environment Variables**\n```bash\n# Required\nPORT=3000                    # Server port\nNODE_ENV=production         # Environment\n\n# Optional (Recommended)  \nGITHUB_TOKEN=your_token     # Personal access token for higher rate limits\nCACHE_TTL=43200            # Cache duration (12 hours)\nRATE_LIMIT_WINDOW=3600000  # Rate limit window (1 hour)\nRATE_LIMIT_MAX=1000        # Max requests per window\n```\n\n### ⚡ **Performance**\n- **Caching**: 12-hour intelligent caching reduces API calls by 95%\n- **Rate Limiting**: 1000 requests/hour per IP\n- **CDN Ready**: Perfect for global deployment with edge caching\n- **Response Time**: Sub-500ms response times with caching\n\n---\n\n## 🧪 **Testing**\n\n```bash\n# Run all tests\nnpm test\n\n# Run with coverage\nnpm run test:coverage\n\n# Run specific tests\nnpm test tests/ranking.test.js\n```\n\n---\n\n## 🤝 **Contributing**\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n1. **Fork** the repository\n2. **Create** a feature branch: `git checkout -b feature/amazing-feature`\n3. **Commit** your changes: `git commit -m 'Add amazing feature'`\n4. **Push** to the branch: `git push origin feature/amazing-feature`  \n5. **Open** a Pull Request\n\n---\n\n## 📊 **API Rate Limits**\n\n| Authentication | Requests/Hour | GitHub API Limit |\n|----------------|---------------|------------------|\n| **No Token** | 60 | GitHub's IP-based limit |\n| **With Token** | 5,000 | GitHub's authenticated limit |\n| **Cached Responses** | Unlimited | Served from cache |\n\n---\n\n## 🌟 **Showcase**\n\n### 🎯 **Live Examples**\n\n\u003c!-- Dark Theme Examples --\u003e\n![Example Stars Dark](https://gitrank.zehrasec.com/api/badge?user=octocat\u0026metric=stars\u0026style=for-the-badge\u0026theme=dark)\n![Example Followers Dark](https://gitrank.zehrasec.com/api/badge?user=octocat\u0026metric=followers\u0026style=for-the-badge\u0026theme=dark)\n\n\u003c!-- Light Theme Examples --\u003e  \n![Example Stars Light](https://gitrank.zehrasec.com/api/badge?user=octocat\u0026metric=stars\u0026style=for-the-badge\u0026theme=light)\n![Example Followers Light](https://gitrank.zehrasec.com/api/badge?user=octocat\u0026metric=followers\u0026style=for-the-badge\u0026theme=light)\n\n---\n\n## 📄 **License**\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 **Acknowledgments**\n\n- **GitHub** for the excellent API and Octocat mascot\n- **Open Source Community** for inspiration and feedback\n- **Terminal Culture** for the hacker aesthetic inspiration\n- **Contributors** who make this project better\n\n---\n\n## 📞 **Support \u0026 Community**\n\n\u003cdiv align=\"center\"\u003e\n\n### 🌟 **Star this repo if it helped you!**\n\n[![GitHub stars](https://img.shields.io/github/stars/yashab-cyber/gitrank?style=social)](https://github.com/yashab-cyber/gitrank/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/yashab-cyber/gitrank?style=social)](https://github.com/yashab-cyber/gitrank/network/members)\n\n**[💬 Discussions](https://github.com/yashab-cyber/gitrank/discussions) • [🐛 Issues](https://github.com/yashab-cyber/gitrank/issues) • [✨ Feature Requests](https://github.com/yashab-cyber/gitrank/discussions)**\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ⚡ by hackers, for hackers**\n\n*Keep coding, keep ranking* 🚀\n\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fgitrank","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashab-cyber%2Fgitrank","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fgitrank/lists"}