Skip to content

Krish-2118/project-match

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 ProjectMatch — Swipe to Collaborate

ProjectMatch is a collaboration-first platform inspired by swipe-based discovery systems, designed not for dating, but for building projects together.
It helps developers, designers, and builders discover compatible collaborators and live projects based on skills, interests, and intent.

The platform prioritizes meaningful collaboration over social networking, ensuring low-noise, high-signal matches.


🧠 The Problem

Finding the right people to build projects with is difficult.

GitHub showcases code but not availability or intent.
LinkedIn highlights resumes rather than active projects.
Discord communities are noisy and unstructured.
Hackathons are time-bound and temporary.

ProjectMatch addresses this gap by combining structured builder profiles, intelligent matching, and real project discovery into a single focused platform.


✨ What ProjectMatch Offers

👤 Builder Profiles

Each user has a swipeable profile that represents them as a builder, not a social account.

Profiles include:

  • Past projects
  • Tech stack and tools
  • Major achievements (hackathons, internships, open source)
  • Personal interests and hobbies
  • Preferred collaboration roles and domains

This allows others to quickly understand both capability and intent.


🔁 Swipe-Based Matching (People Mode)

Users discover other builders through a swipe interface:

  • Swipe right to express interest in collaborating
  • Swipe left to skip

A match occurs only when both users swipe right.
Once matched, GitHub profiles are shared and collaboration can begin.

This ensures that contact happens only when there is mutual interest.


🔴 Live Projects (Connect Mode)

ProjectMatch also provides a dedicated space for active, ongoing projects.

Users can:

  • Browse projects looking for collaborators
  • Join open projects directly
  • Apply to restricted projects
  • Post their own projects with defined roles

Each project clearly specifies its problem statement, tech stack, required skills, commitment level, and current stage.


🤖 Intelligent Recommendation System

At the core of ProjectMatch is a custom, indigenous recommendation model built specifically for collaboration discovery.

Instead of generic engagement-based ranking, the system analyzes:

  • Skill similarity and depth
  • Project domain overlap
  • Tech stack compatibility
  • Personal interests and learning goals
  • Past interaction and collaboration behavior

These signals are combined to generate high-quality recommendations for both people and projects, reducing randomness and improving match relevance.


🏗️ System Design Overview

ProjectMatch follows a clean, modular system design.
The frontend is built with Next.js and handles UI rendering, swipe interactions, authentication flows, and API communication.
The backend manages business logic such as matching, project lifecycle, recommendation scoring, and access control.

PostgreSQL is used as the primary database, with Prisma ORM ensuring type-safe and maintainable data access.
The recommendation logic operates as a service layer that processes user and project features to produce ranked suggestions.

The overall system is designed to be scalable, privacy-aware, and easy to extend with future features.


🔐 Authentication (Email Magic Link)

ProjectMatch uses passwordless email-based authentication.

Login flow:

  1. User enters their email address
  2. A secure magic link is sent to the email
  3. Clicking the link verifies the session
  4. The user is redirected directly to their dashboard

This approach removes the need for passwords, improves security, and significantly lowers onboarding friction.

GitHub OAuth is optionally used to link profiles and fetch public project information, but GitHub details are shared only after a mutual match.


🔒 Privacy & Safety

  • GitHub links are hidden until a mutual match occurs
  • No unsolicited messaging is allowed
  • Project owners control collaborator access
  • Rate limiting on swipes and join requests
  • Input validation across all user inputs

🛠 Tech Stack

Frontend

  • Next.js
  • TypeScript
  • Tailwind CSS
  • Framer Motion

Backend

  • Node.js
  • Next.js API Routes
  • Prisma ORM

Database

  • PostgreSQL

Authentication

  • Email Magic Links
  • GitHub OAuth (optional)

Infrastructure

  • Docker (optional)
  • Vercel / AWS / Railway
  • GitHub Actions (CI/CD)

🧪 Testing

  • Unit tests for recommendation logic
  • API route testing
  • Component-level UI testing
  • Load testing for swipe and match operations

🗺 Roadmap

  • In-app messaging
  • Team dashboards
  • Contribution tracking
  • Reputation and trust scores
  • AI-generated profile summaries
  • Advanced team compatibility scoring

🤝 Contributing

Contributions are welcome.

  1. Fork the repository
  2. Create a feature branch
  3. Commit with clear messages
  4. Open a pull request

📜 License

MIT License


🌟 Vision

GitHub shows what you’ve built.
ProjectMatch shows what you want to build next — and with whom.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors