Skip to content

Code-Social/fitfinder

Repository files navigation

🎯 Profile Rank (FitFinder) – Find opportunities Meant for You

Welcome to Profile Rank, a smart and community-driven platform where you can discover global scholarships, conferences, hackathons, research programs, apprenticeships, and more, all based on your profile.

Think of it as a chill version of LinkedIn, but focused only on non-job opportunities that help you grow. We help you figure out where you're most likely to get accepted, based on your skills, goals, and even your LinkedIn profile. You'll get suggestions from the UI when you submit your profile, and community members can comment on opportunities and share their experiences.


🌍 What Can You Do with Profile Rank?

Discover Opportunities
Search or browse through opportunities curated by other users:

  • 🎓 Scholarships
  • 🧑‍🔬 Research Programs
  • 🧑‍🏫 Apprenticeships
  • 🧑‍💻 Hackathons
  • 🌎 Conferences

... and see if you're a good fit or what you can do to become one.

🧠 Find Your Fit
Once you create your FitProfile, the system will show you how well you match with each opportunity using a percentage based on your:

  • Skills
  • Education & GPA
  • Location
  • LinkedIn Profile
  • Past experience

💬 Read Success Stories
Each opportunity can feature real prep tips, success stories, and checklists shared by people who got selected.

Submit New Opportunities
Logged-in users can submit global opportunities to help others grow. Once approved by admins, they'll be featured on the platform.

🔖 Bookmark and Track
Save opportunities, view past submissions, and help others in any way you can.


🧰 Tech Stack

Part Tech Used
Frontend React.js, TailwindCSS
Backend Node.js with Express or Firebase
Database MongoDB or Firebase Realtime DB
Auth Firebase Authentication (Google)
AI Integration OpenAI or basic ML model (future)
LinkedIn Sync LinkedIn scraping via Puppeteer/API
Hosting Vercel, Render, or Firebase Hosting

💻 Pages in the MVP

  1. Home – Overview of platform and highlights of other sections
  2. Opportunities – List view with filters (type, location, deadline, fit score), full info, apply link, success stories, and chance level
  3. Submit Opportunity – Form to submit a new opportunity (login required)
  4. My Dashboard – Saved opportunities, fit history, profile editor
  5. FitProfile Setup – Onboarding flow or edit page
  6. Success Stories – A separate feed of real user stories and tips
  7. Admin Panel (optional) – For moderators to approve or reject opportunities

🧑‍💻 Getting Started

Ready to contribute? We welcome beginners! 🙌

📦 Prerequisites

Make sure you have:

  • Git and GitHub account
  • Node.js and npm installed
  • Code editor (VS Code recommended)

🚀 Clone & Run Locally

git clone https://github.com/Code-Social/fitfinder.git
cd fitfinder
npm install
npm start

Open http://localhost:3000 in your browser.


🛠️ How to Contribute

We follow beginner-friendly open source practices.

📌 Step-by-Step Guide

  1. Go to the Issues tab
  2. Look for labels like good first issue, help wanted, or feature request
  3. Comment on the issue to get assigned
  4. Fork the repo
  5. Create a new branch (e.g., feature/form-validation)
  6. Make your changes
  7. Create a Pull Request (PR) – we'll review and guide you

🔁 Example Commands

git checkout -b feature/profile-card
git add .
git commit -m "feat: add profile card component"
git push origin feature/profile-card

🔎 Areas You Can Contribute To

  • Frontend UI
  • Form validation
  • Building filters and dropdowns
  • Bookmark/save functionality
  • Firebase integration
  • Data models (MongoDB/Firebase)
  • LinkedIn profile scraping
  • Creating dummy data or success stories
  • Writing docs and tooltips
  • ...and more!

💬 Community and Help

Questions? Ideas? Join us here:


✨ Project Mentors

arushi2610
arushi2610
Rizwan102003
Rizwan102003

💖 Code of Conduct

Be kind, helpful, and welcoming to everyone.


⭐ Support the Project

If you like the idea, give this repo a ⭐ and share it with friends.
Let’s make opportunity discovery smarter and more inclusive 🚀

About

No description, website, or topics provided.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •