GitEasy

A beginner-friendly Git utility that makes pushing changes to GitHub effortless.

GitEasy is designed for those who are new to Git and want a no-hassle, one-command way to add, commit, and push code to a GitHub repository — all from the terminal. GitEasy streamlines discovering and contributing to beginner-friendly GitHub issues using smart filtering and real-time updates.

---

❓ Why GitEasy?

For beginners, Git commands can feel intimidating — especially when you just want to update your project without memorizing flags and command chains.

GitEasy solves this by wrapping all essential Git operations into a single, guided Python script that:

• Stages your changes
• Prompts you for a commit message
• Authenticates with GitHub
• Pushes your changes to the right branch

Finding a beginner-friendly issue across thousands of repositories is overwhelming:

• "Good first issue" tags are often misleading or outdated.
• Many projects are inactive or poorly maintained.
• Beginners waste hours just searching.

GitEasy changes the game by delivering curated, beginner-friendly issues at your fingertips—no more guesswork or wasted time.

No GitHub Desktop, no GUI. Just Python + terminal convenience.

---

✨ Features

• 🔒 Secure authentication using GitHub personal access tokens
• ✏️ Interactive prompts for commit messages and repository URLs
• 📤 Automatically adds, commits, and pushes in one go
• 🧑‍💻 Great for students, contributors, and first-time GitHub users
• 🛠️ Minimal setup — works from the terminal with Python 3

---

🎓 How are we better than others?

• Smart Issue Discovery
  Categorized issues across types like documentation, UI, bugs, testing, and more, tailored to your skill level.

• Real-Time Monitoring
  Auto-refreshes every few minutes so you never miss new opportunities.

• Flexible Filtering
  Choose by programming language (JavaScript, TypeScript, Python, Go, Rust, Java, C++…), difficulty (Beginner → Advanced), and project quality.

• Hybrid Ranking Algorithm
  Combines issue recency (60%) and repo popularity (stars) — to surface timely, relevant issues.

• Beautiful & Responsive Design
  Sleek modern UI using glass-morphism, with dark mode, fluid layouts, and smooth animations.

• Privacy-First Approach
  No backend storage—your session and preferences stay in the browser. Your GitHub token is encrypted and cleaned up automatically.

---

🎯 Ideal For

• Students working on college projects
• Beginners exploring open source
• Quick fixes and one-shot pushes
• Teaching Git workflows interactively

---

📁 Project Structure - Overview

giteasy/
├── src/ # Front-end source code (React + TypeScript components)
├── .env.example # Example environment variables
├── .gitignore # Ignored files
├── README.md # This overview
├── eslint.config.js # Linter configuration
├── postcss.config.js # PostCSS setup
├── tailwind.config.js # Tailwind CSS configuration
├── tsconfig.* # TypeScript configuration files
├── vite.config.ts # Vite build setup
├── index.html # HTML entry point for the app
├── package.json # Project metadata and dependencies
└── package-lock.json # Exact dependency versions

---

📄 License

This project is licensed under the BSD 3-Clause License. See the LICENSE file for more details.

---

🙋‍♂️ Want to Contribute?

We welcome contributions!
Check out the CONTRIBUTING.md file for setup instructions and how to get started.

---

Made with ❤️ by Soham-47