Skip to content

Code-Social/fitfinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 

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/<your-org>/profile-rank.git
cd profile-rank
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

πŸ’¬ 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

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published