Skip to content

Anay0305/EduGuide

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 

Repository files navigation

📚 EduGuide – One-Stop Career & Education Advisor

A Smart India Hackathon 2025 prototype built to guide students in making better academic & career choices.
EduGuide acts as a personalized digital mentor — helping students choose streams, explore government colleges, prepare for exams, and map career paths — all in one place.


✨ Overview (Non-Tech Friendly)

Choosing what to study after Class 10 or 12 is confusing. Many students (and parents) don’t know:

  • Which stream (Science, Commerce, Arts) to pick.
  • Which courses and colleges are available nearby.
  • What career options exist after a degree.
  • Whether higher education is worth pursuing.

👉 EduGuide solves this problem by offering a single platform where students can:

  • Take aptitude quizzes for guidance.
  • Explore nearby government colleges on a map.
  • Learn what jobs/careers each degree leads to.
  • Track exam timelines & scholarships.
  • Access everything in multiple languages for inclusivity.

🛠 Key Features

  • 🧠 AI Career Counsellor – Aptitude & interest-based course recommendations.
  • 🎓 Course-to-Career Mapping – Visual charts showing where each degree (B.A., B.Sc., B.Com., etc.) can lead (jobs, higher studies, exams).
  • 🏫 Nearby Colleges Explorer – Location-based search with advanced filters (courses, ranking, facilities, fees).
  • 🌐 Multilingual Support – English, Hindi, and regional languages (starting with J&K).
  • 📅 Timeline Tracker – Admission deadlines, exams, scholarship alerts.
  • 📝 Exam Support Hub – Competitive exam details (patterns, resources, success rates, past papers).
  • 📌 Bookmarking – Save recommended courses or colleges for later.
  • 👤 Personalized Profiles – Tracks student data to give tailored recommendations.

⚙️ Technical Approach

Frontend

  • Next.js (React + TypeScript) – Modern frontend framework with server-side rendering.
  • Tailwind CSS + ShadCN UI – Clean, responsive UI design.
  • Leaflet.js – Interactive map visualizations for nearby colleges.
  • Google Translate API – Multilingual platform support for inclusivity.
  • State management with React hooks for lightweight performance.

Backend

  • Node.js + Express.js – REST API server.
  • MongoDB + Mongoose – Flexible, document-based storage for courses, users, and bookmarks.
  • JWT Authentication – Secure login, token-based session management.
  • Modular controllers & routes for auth, courses, recommendations, and bookmarks.

Integrations

  • Google Maps API – Location-based college search and visualization.
  • AI-based Aptitude Quiz – Smart recommendations based on test results.
  • Exam APIs / Scraping – Real-time data on deadlines, scholarships, resources.

DevOps & Tools

  • .env configuration for secure API keys and credentials.
  • ESLint + Prettier – Code quality & consistency.
  • Git/GitHub – Version control and collaboration.
  • Planned Deployment: Vercel/Netlify (Frontend), Railway/Render (Backend).

🌍 Socio-Economic Impact

  • 🎯 Improves Enrollment – Helps students consider government colleges as viable options.
  • 🌱 Promotes Equity – Equal access to information regardless of background.
  • 🏡 Bridges Urban-Rural Divide – Multilingual + digital access for rural areas.
  • Saves Time & Effort – Students & parents don’t need to browse multiple sources.
  • 💼 Stronger Workforce – Guides students to sustainable, informed career paths.

📂 Project Structure

EduGuide/
├── backend/        # Node.js + Express backend
│   ├── controllers/ # Auth, courses, bookmarks, recommendations
│   ├── models/      # MongoDB schemas
│   ├── routes/      # API routes
│   └── server.js    # Entry point
│
└── frontend/       # Next.js frontend
    ├── app/         # Pages: quiz, exams, roadmap, profile, signup, etc.
    ├── components/  # UI & reusable components
    └── lib/         # API utils & middleware

🚀 Quick Start

# clone repo
git clone https://github.com/Anay0305/EduGuide
cd EduGuide

# setup backend
cd backend
npm install
npm run dev

# setup frontend
cd ../frontend
npm install
npm run dev

Frontend will run on http://localhost:3000 and backend on http://localhost:5000.


📬 Team

Team Aarambh – Smart India Hackathon 2025

  • Backend: APIs, database, integrations
  • Frontend: Next.js app, UI, UX
  • Creativity & Maps: Course explorer, Google Maps integration
  • Idea & Planning: Career mapping workflows, user journey design

📝 License

MIT License – free to use and adapt for educational or research purposes.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •