RepoRanger

📊 GitHub Repository Dashboard – Quickly visualize stars, forks, and activity for your repositories. Personal project with MIT license.

RepoRanger Docs / GitHub Pages

RepoRanger is a client-side dashboard that displays key metrics for GitHub repositories, including stars, forks, and last push.

It is a personal project designed for learning, visualization, and efficiently tracking repositories.

---

📌 Features

• Fetches all public repositories of a GitHub user
• Displays stars, forks, and last push date for each repository
• Interactive visualization with charts (Chart.js)
• Responsive layout for desktop and mobile devices
• Easy navigation to repository links
• Live updates when refreshing the dashboard

---

📁 Project Structure

RepoRanger/
│
├── index.html              # Main HTML page
├── script.js               # Main JavaScript logic (API + UI)
├── styles.css              # Styling
│
├── assets/
│   └── images/
│       ├── screenshot-1.png
│       └── screenshot-2.png
│
├── docs/
│   ├── index.md            # Project overview
│   ├── installation.md     # Setup instructions
│   └── usage.md            # How to use the app
│
├── testing/
│   └── manual-testing.md   # Manual QA documentation
│
├── LICENSE
└── README.md               # Main project description

---

⚙️ Installation

Follow the steps below to run RepoRanger locally:

# Clone the repository
git clone https://github.com/KristiyanGeorgiev1996/RepoRanger.git

# Enter the folder
cd RepoRanger

# Open index.html in your browser
open index.html  # or double-click the file

⚠️ RepoRanger works entirely client-side (no backend). It can be extended with Node.js/Express for additional features.

---

💻 Usage

1. Enter your GitHub username
2. View the list of repositories with stars, forks, and last activity
3. Click on a repository to see detailed statistics
4. Charts display repository trends interactively

See the Usage guide for screenshots and instructions.

---

📚 Documentation

Detailed documentation is available in the docs folder.

• 📦 Installation Guide
• 💻 Usage Guide
• 👨‍💻 Developer Guide

You can also browse the documentation as a landing page:

🔗 RepoRanger Docs / GitHub Pages

---

⚠️ Security

• No sensitive data is required (client-side application)
• If extended with API tokens in the future, use .env and never commit credentials

---

📜 License

MIT License – free to use, but always credit the author.

---

📞 Contact

• Author: Kristiyan Georgiev
• GitHub: KristiyanGeorgiev1996
• Email: georgievk1996@gmail.com

---

⭐ Acknowledgements

• GitHub API – for fetching repository data
• Chart.js – for interactive charts
• All open-source tools that make development easier