Skip to content

Mahfoudh94/Contributor

Repository files navigation

🚀 Smart Collaborative Development Platform 🌍

Welcome to the Smart Collaborative Development Platform — a space where developers, project owners, and innovators connect, collaborate, and create amazing projects together. 💻🤝✨

📖 Table of Contents


📋 Overview

This platform empowers project owners and contributors to collaborate seamlessly. Project owners can introduce challenges as "rooms," and contributors can join to work on real-world tasks. With GitHub integration, managing tasks like forking, branching, and merging becomes a breeze. 🎉

Contributors get to build portfolios, get recognized for their contributions, and grow alongside project owners. 🚀


🔥 Features

  • Project Rooms: 🛠️ Project owners can create rooms to post challenges and tasks.
  • Gamified Recognition: 🏆 Best solutions are rewarded, motivating contributors.
  • GitHub Integration: 🔗 Fork, branch, and merge with ease!
  • Portfolio Building: 🖼️ Each contribution helps build your professional portfolio.
  • Collaborative Growth: 🌱 Win-win for both project owners and contributors!

🔧 Technologies Used

  • Frontend: Vue.js, Inertia.js, TailwindCSS 🌐
  • UI Components: PrimeVue 💎
  • Backend: Laravel ⚙️
  • Version Control: GitHub 🗂️
  • Other Libraries/Frameworks: Axios 📡

Installation

To get started locally, follow these easy steps:

1. Clone the repository 🧑‍💻

git clone https://github.com/Mahfoudh94/Contributor.git

2. Install dependencies 📦

Make sure Node.js and Composer are installed on your machine.

cd Contributor
npm install
composer install

3. Set up environment variables 🌿

Copy the example environment file and configure your database, GitHub API keys, etc.

cp .env.example .env

4. Run migrations 🏗️

Set up your database:

php artisan migrate

5. Run the Development Server 🚀

To start the app locally:

npm run dev
php artisan serve

Visit http://localhost:8000 to see the platform in action! 😎


💡 How It Works

For Project Owners 👩‍💻👨‍💻

  1. Create a Room: 💬 Share a project challenge or task.
  2. Invite Contributors: 🌍 Allow contributors to join and start working.
  3. Review Solutions: ✅ Evaluate the solutions provided by contributors.
  4. Reward Contributions: 🎁 Acknowledge the best solutions and offer recognition or rewards.

For Contributors 👩‍💻👨‍💻

  1. Join Rooms: 🔍 Find and join projects you’re passionate about.
  2. Submit Solutions: 💡 Fork, branch, and work on tasks.
  3. Build Your Portfolio: 📈 Get recognized for your work and build your professional portfolio.
  4. Collaborate & Grow: 🌱 Learn and grow while working on real-world projects.

🤝 Contributing

We welcome contributions! 🙌 To contribute:

  1. Fork the repository.
  2. Create a branch (git checkout -b feature/your-feature-name).
  3. Make your changes and commit them (git commit -am 'Add new feature').
  4. Push your branch (git push origin feature/your-feature-name).
  5. Create a pull request.

Ensure your code follows the project’s style and passes all tests before submitting. ✅

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published