An open API service indexing awesome lists of open source software.

https://github.com/abdul-wahab619/contribforge

Connect with Open Source Opportunities Discover the perfect projects to contribute to, grow your skills, and build your open source portfolio with ContribForge.
https://github.com/abdul-wahab619/contribforge

good-first-issue open-source opensource opensource-contributions opensource-projects

Last synced: about 2 months ago
JSON representation

Connect with Open Source Opportunities Discover the perfect projects to contribute to, grow your skills, and build your open source portfolio with ContribForge.

Awesome Lists containing this project

README

          

# ContribForge

ContribForge is an open-source platform designed to make discovering, tracking, and managing open-source contributions easier for developers.

Instead of jumping between GitHub tabs, issues, and notes, ContribForge helps you **find the right issues, save them, and track your contribution journey in one place**.

---

## Why ContribForge?

Open source is powerful, but the entry barrier is high.

Common problems developers face:

* Finding beginner-friendly issues
* Losing track of saved repositories and issues
* No clear view of contribution progress
* Hard to showcase open-source work publicly

ContribForge aims to solve this.

---

## Features (Current & Planned)

### Phase 1: Search & Discovery

* GitHub repository and issue search
* Filters by language, difficulty, and labels
* Highlight `good first issue` opportunities
* Repository cards with key stats

### Phase 2: Authentication

* GitHub OAuth and Email/Password login
* Protected dashboard routes
* User profiles

### Phase 3: Dashboard

* Save and bookmark repos and issues
* Quick access to saved items
* Personalized dashboard layout

### Phase 4: Contribution Tracking

* Sync GitHub contributions (PRs, commits, issues)
* Progress charts and contribution history
* Streaks and milestones

### Phase 5: Public Portfolio

* Shareable public profile
* Contribution showcase
* Activity graph and badges

---

## Live Demo

[https://contribforge.vercel.app](https://contribforge.vercel.app)

---

## Repository

[https://github.com/abdul-wahab619/ContribForge](https://github.com/abdul-wahab619/ContribForge)

---

## Tech Stack

* Frontend: React + Tailwind CSS
* Backend: Node.js
* API: GitHub REST API
* Auth (planned): GitHub OAuth
* Deployment: Vercel

---

## Getting Started

### 1. Clone the Repository

```bash
git clone https://github.com/abdul-wahab619/ContribForge.git
cd ContribForge
```

### 2. Install Dependencies

```bash
npm install
```

### 3. Run Locally

```bash
npm run dev
```

The app will run on `http://localhost:3000`.

---

## Contributing

Contributions are welcome and encouraged.

Whether you want to:

* Fix bugs
* Add features
* Improve UI/UX
* Enhance documentation

Please read `CONTRIBUTING.md` before submitting a pull request.

Beginner-friendly issues are labeled as `good first issue`.

---

## Creating Issues

If you have ideas or find bugs:

* Check existing issues first
* Use clear titles and descriptions
* Add screenshots or examples if applicable

Create an issue here:
[https://github.com/abdul-wahab619/ContribForge/issues/new](https://github.com/abdul-wahab619/ContribForge/issues/new)

---

## Roadmap

* Advanced issue filtering
* Contribution analytics
* Notifications for issue updates
* Team and organization dashboards
* Browser extension integration

---

## Philosophy

ContribForge is built with a simple belief:

Open source should be accessible.
Tracking contributions should be effortless.
Developers should feel motivated, not overwhelmed.

---

## License

This project is licensed under the MIT License.

---

## Acknowledgements

Inspired by the open-source community and built to give back to it.

If you find this project useful, consider giving it a star.