SkillBridge 🎯

India's AI-powered platform that bridges the gap between education and employment using live job market intelligence and Opportunity Score technology.

🚀 Live Demo

Deploy instructions below

---

📁 Project Structure

skillbridge/
├── client/          # React frontend (Vite)
│   ├── src/
│   │   ├── components/
│   │   │   ├── auth/        # Login, Register
│   │   │   ├── common/      # Navbar, Loader, Toast
│   │   │   ├── dashboard/   # OpportunityCards, SkillGap, Roadmap, Heatmap
│   │   │   ├── jobs/        # JobCard, JobFilters
│   │   │   ├── mentors/     # MentorCard, BookingModal
│   │   │   └── assessment/  # AssessmentFlow
│   │   ├── pages/           # Landing, Dashboard, Jobs, Mentors
│   │   ├── context/         # AuthContext
│   │   ├── hooks/           # useAuth, useJobs, useMentors
│   │   └── utils/           # api.js, opportunityScore.js
│   └── public/
└── server/          # Node.js + Express backend
    ├── controllers/ # authController, jobController, etc.
    ├── models/      # User, Job, Mentor, SkillPath MongoDB models
    ├── routes/      # auth, jobs, mentors, skills, users routes
    ├── middleware/  # authMiddleware, errorHandler
    ├── config/      # db.js
    ├── utils/       # opportunityScore.js, seedData.js
    └── data/        # seed JSON files

---

⚙️ Tech Stack

Layer	Technology
Frontend	React 18 + Vite
Styling	Tailwind CSS
State	Context API + useState
Backend	Node.js + Express
Database	MongoDB + Mongoose
Auth	JWT + bcryptjs
HTTP Client	Axios

---

🛠️ Setup & Installation

Prerequisites

• Node.js v18+
• MongoDB (local or Atlas)
• Git

1. Clone the repo

git clone https://github.com/YOUR_USERNAME/skillbridge.git
cd skillbridge

2. Backend setup

cd server
npm install
cp .env.example .env
# Edit .env with your MongoDB URI and JWT secret
npm run seed      # Seeds sample data
npm run dev       # Starts on http://localhost:5000

3. Frontend setup

cd client
npm install
cp .env.example .env
# Edit .env — set VITE_API_URL=http://localhost:5000/api
npm run dev       # Starts on http://localhost:5173

---

🔑 Environment Variables

server/.env

PORT=5000
MONGO_URI=mongodb://localhost:27017/skillbridge
JWT_SECRET=your_super_secret_key_here
JWT_EXPIRE=7d
NODE_ENV=development

client/.env

VITE_API_URL=http://localhost:5000/api

---

📡 API Endpoints

Auth

Method	Endpoint	Description
POST	/api/auth/register	Register new user
POST	/api/auth/login	Login user
GET	/api/auth/me	Get current user

Skills & Opportunities

Method	Endpoint	Description
GET	/api/skills/opportunities	Get all opportunity scores
GET	/api/skills/heatmap	Get saturation heatmap
GET	/api/skills/gap/:userId	Get user skill gap
POST	/api/skills/assessment	Submit assessment answers

Jobs

Method	Endpoint	Description
GET	/api/jobs	Get all jobs (with filters)
GET	/api/jobs/:id	Get single job
GET	/api/jobs/matches/:userId	Get matched jobs for user

Mentors

Method	Endpoint	Description
GET	/api/mentors	Get all mentors
GET	/api/mentors/:id	Get mentor profile
POST	/api/mentors/book	Book a session

Users

Method	Endpoint	Description
GET	/api/users/profile	Get user profile
PUT	/api/users/profile	Update user profile
GET	/api/users/roadmap	Get user roadmap

---

🧠 Core Innovation: Opportunity Score

Opportunity Score = (Job Openings / Active Learners) × Growth Velocity × Location Weight

Score > 7.0  →  High Opportunity 🟢
Score 4.0-7.0 → Moderate 🟡
Score < 4.0  →  Saturated 🔴

---

👥 User Roles

• Student — Takes assessment, follows roadmap, applies for jobs
• Employer — Posts jobs, views verified candidate profiles
• Mentor — Offers paid sessions, builds reputation
• College — Views placement analytics dashboard

---

🚀 Deployment

Backend → Render

1. Push to GitHub
2. Create new Web Service on render.com
3. Set build command: cd server && npm install
4. Set start command: node server.js
5. Add environment variables

Frontend → Vercel

1. Import GitHub repo on vercel.com
2. Set root directory to client
3. Add VITE_API_URL environment variable
4. Deploy

---

📄 License

MIT — free to use for your final year project

---

Built with ❤️ to solve India's real skill-employment gap