{"id":29122300,"url":"https://github.com/phucbm/gitsheet","last_synced_at":"2025-06-29T17:10:21.600Z","repository":{"id":301562112,"uuid":"1009652079","full_name":"phucbm/gitsheet","owner":"phucbm","description":"📊 GitHub Repository Analytics in Google Sheets - Track stars, issues, PRs, and more!","archived":false,"fork":false,"pushed_at":"2025-06-27T14:17:12.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-27T14:39:16.836Z","etag":null,"topics":["github-api","github-stats","google-spreadsheet","spreadsheet"],"latest_commit_sha":null,"homepage":"https://docs.google.com/spreadsheets/d/1yDYncOyZMl9EgtafObJzCeg7FK4h5qTmEUhycpOi6zo","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/phucbm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-27T13:35:46.000Z","updated_at":"2025-06-27T14:12:35.000Z","dependencies_parsed_at":"2025-06-27T14:39:20.599Z","dependency_job_id":"7f8d6a07-b7e1-4750-a165-679f8b779619","html_url":"https://github.com/phucbm/gitsheet","commit_stats":null,"previous_names":["phucbm/gitsheet"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/phucbm/gitsheet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phucbm%2Fgitsheet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phucbm%2Fgitsheet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phucbm%2Fgitsheet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phucbm%2Fgitsheet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phucbm","download_url":"https://codeload.github.com/phucbm/gitsheet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phucbm%2Fgitsheet/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262632328,"owners_count":23340214,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["github-api","github-stats","google-spreadsheet","spreadsheet"],"created_at":"2025-06-29T17:10:13.659Z","updated_at":"2025-06-29T17:10:21.589Z","avatar_url":"https://github.com/phucbm.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitSheet 📊\n\n\u003e **GitHub Repository Analytics in Google Sheets - Track stars, issues, PRs, and more!**\n\nTransform how you monitor your GitHub repositories with a beautiful, automated Google Sheets dashboard. No more switching between tabs or manually tracking stats - just enter your username and get instant insights into all your public repositories.\n\n![GitSheet Demo](https://github.com/user-attachments/assets/6fad2db7-81cf-4500-8915-2f0567c53928)\n\n\n## ✨ Features\n\n🔥 **Auto-fetch all public repositories** for any GitHub user  \n📊 **Complete repository analytics** - stars, forks, issues, PRs, watchers, size  \n🎯 **Smart data separation** - accurately separates issues from pull requests  \n📋 **Rich metadata** - license info, fork detection, creation/update dates  \n🎨 **Beautiful formatting** - professional styling with colors and auto-sizing  \n⚡ **Zero setup required** - works immediately after copying template  \n🔄 **One-click updates** - refresh all data with a single menu click  \n🛡️ **Rate limit protection** - built-in delays to respect GitHub API limits  \n\n## 🚀 Quick Start\n\n### Option 1: Use the Template (Recommended)\n1. **[📋 Copy the GitSheet Template](https://docs.google.com/spreadsheets/d/1yDYncOyZMl9EgtafObJzCeg7FK4h5qTmEUhycpOi6zo/edit?usp=sharing)**\n2. Click \"File \u003e Make a copy\" to create your own copy\n3. Go to \"GitSheet\" menu → \"Setup Profile Sheet\"\n4. Change the username from \"phucbm\" to your GitHub username\n5. Click \"GitSheet\" → \"Update Repository Stats\"\n6. **Done!** 🎉\n\n![Setup Process](https://github.com/user-attachments/assets/1d36f6e0-5e6f-4a38-bf58-b3764c36deb0)\n\n### Option 2: Manual Setup\nIf you prefer to set it up manually:\n\n1. Create a new Google Sheet\n2. Go to Extensions → Apps Script\n3. Copy the code from [`apps-script.js`]([gitsheet.js](https://github.com/phucbm/gitsheet/blob/main/apps-script.js))\n4. Save and authorize permissions\n5. Follow steps 3-6 from Option 1\n\n## 📋 What Data Does GitSheet Track?\n\n| Column | Description |\n|--------|-------------|\n| **Repository Name** | Name of the repository |\n| **Description** | Repository description |\n| **Language** | Primary programming language |\n| **Stars** | Number of stargazers |\n| **Forks** | Number of forks |\n| **Watchers** | Number of watchers |\n| **Open Issues** | Current open issues (excludes PRs) |\n| **Open PRs** | Current open pull requests |\n| **Size (MB)** | Repository size in megabytes |\n| **License** | Repository license (MIT, Apache, etc.) |\n| **Is Fork** | Whether the repo is a fork |\n| **Created** | Repository creation date |\n| **Updated** | Last update date |\n| **URL** | Direct link to repository |\n\n## 🔧 Advanced Usage\n\n### Refresh Data\n- Use \"GitSheet\" → \"Update Repository Stats\" to refresh all data\n- Data automatically updates timestamps in the Profile sheet\n\n### Multiple Users\n- Create separate sheets for different GitHub users\n- Each sheet maintains its own profile and data\n\n### Export \u0026 Sharing\n- Use Google Sheets' built-in export (Excel, CSV, PDF)\n- Share read-only copies with team members\n- Create charts and pivot tables for deeper analysis\n\n## ⚠️ First-Time Setup: Security Warning\n\nWhen you first run GitSheet, Google will show a security warning because the script accesses external APIs (GitHub). This is completely normal and safe.\n\n![Security Warning](https://github.com/user-attachments/assets/f70b8a37-30e6-4477-8dd2-4abc3b87ae47)\n\n**What to do:**\n1. Click \"Advanced\"\n2. Click \"Go to GitSheet (unsafe)\"\n3. Review permissions and click \"Allow\"\n\n**Why this happens:** Google shows this warning for any script that accesses external APIs. Your data stays completely private and secure.\n\n## 🛠️ Technical Details\n\n### Rate Limiting\n- GitSheet respects GitHub's API rate limits (60 requests/hour for unauthenticated users)\n- Built-in delays prevent hitting rate limits\n- Progress indicators show update status\n\n### Data Accuracy\n- Issues and PRs are accurately separated (GitHub API combines them)\n- Real-time data fetched directly from GitHub\n- Handles errors gracefully and continues processing\n\n### Performance\n- Batch API calls for optimal speed\n- Efficient Google Sheets operations\n- Handles repositories of any size\n\n## 🔮 Roadmap\n\nGitSheet is actively developed! Here's what's coming:\n\n### v2.0 - Write Operations (Coming Soon)\n- ✏️ Edit repository descriptions directly in sheets\n- 🏷️ Bulk update topics/tags\n- ⚙️ Modify repository settings\n- 📝 Batch operations across multiple repos\n\n### Future Features\n- 📈 Historical data tracking and charts\n- 🔔 Automated reports and notifications\n- 👥 Team collaboration features\n- 🌐 Support for organizations\n- 📱 Mobile app companion\n\n## 🤝 Contributing\n\nWe love contributions! Here's how you can help:\n\n- 🐛 **Report bugs** by opening an issue\n- 💡 **Suggest features** in the discussions\n- 📖 **Improve documentation** \n- 🔧 **Submit pull requests**\n- ⭐ **Star the repository** to show support\n\n## 📚 Use Cases\n\n**Individual Developers:**\n- Track personal project popularity\n- Monitor repository health\n- Identify trending projects\n- Portfolio management\n\n**Open Source Maintainers:**\n- Monitor multiple projects at once\n- Track community engagement\n- Identify repositories needing attention\n- Generate project reports\n\n**Development Teams:**\n- Competitive analysis\n- Portfolio overview\n- Project prioritization\n- Stakeholder reporting\n\n## ❓ FAQ\n\n**Q: Is GitSheet free?**  \nA: Yes! GitSheet is completely free and open source.\n\n**Q: Do I need a GitHub account?**  \nA: You need a GitHub account to have repositories, but anyone can view public repository data.\n\n**Q: Can I track private repositories?**  \nA: Currently GitSheet only supports public repositories. Private repo support is planned for v2.0.\n\n**Q: How often should I update the data?**  \nA: Whenever you want fresh data! There's no automatic refresh to respect API limits.\n\n**Q: Can I track organizations?**  \nA: Yes! Just enter the organization name instead of a username.\n\n**Q: What about GitHub rate limits?**  \nA: GitSheet includes built-in rate limiting protection. For heavy usage, consider using a GitHub Personal Access Token (v2.0 feature).\n\n## 📄 License\n\nMIT License - feel free to use GitSheet for any purpose!\n\n## 🙋‍♂️ Support\n\n- 📖 **Documentation**: Check this README first\n- 🐛 **Bug Reports**: [Open an issue](../../issues)\n- 💬 **Questions**: [Start a discussion](../../discussions)\n- 📧 **Contact**: [Your contact info]\n\n## 🌟 Show Your Support\n\nIf GitSheet helps you manage your GitHub repositories, please:\n- ⭐ Star this repository\n- 🐦 Share on social media\n- 📝 Write a blog post about your experience\n- 🗣️ Tell other developers\n\n---\n\n**Built with ❤️ for the developer community**\n\n*GitSheet v1.0 - Making GitHub repository management effortless, one spreadsheet at a time.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphucbm%2Fgitsheet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphucbm%2Fgitsheet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphucbm%2Fgitsheet/lists"}