Skip to content

LoaiWael/EduBridge

Repository files navigation

EduBridge

EduBridge Banner

Bridging the gap between students, educators, and project opportunities.


🌟 Overview

EduBridge is a comprehensive ecosystem designed to streamline coordination within academic environments. It empowers students to find project ideas, form teams, and seek professional supervision from Teaching Assistants (TAs), all while providing educators with the tools to manage and track research progress seamlessly.

🎯 Objective

To create a unified platform that eliminates the administrative friction in graduation projects and research coordination, fostering a culture of collaboration and innovation.

✨ Key Features

  • 📑 Idea Library: Browse and save high-impact project concepts with detailed technology stacks and categorizations.
  • 👥 Team Management: Form teams, invite members, and manage roles within a dedicated workspace.
  • 👨‍🏫 TA Supervision: Direct request-to-approval workflow for project mentoring and academic supervision.
  • 🔍 Unified Search: Instant filtering across Users, Teams, Ideas, and TAs using a fast, centralized search component.
  • 🔔 Real-time Notifications: Custom notification system for team invites, request status updates, and milestones.
  • 🤖 AI Support: Integrated Chatbot for instant platform guidance and project assistance.
  • 🌗 Dark Mode & Theming: Full glassmorphism UI supporting both light and dark modes with branded aesthetics.

🛠️ Tech Stack

🚀 Getting Started

Prerequisites

  • Node.js (v20 or higher)
  • npm or pnpm

Installation

  1. Clone the repository:

    git clone https://github.com/LoaiWael/EduBridge.git
    cd EduBridge
  2. Install dependencies:

    npm install
  3. Start the development server:

    npm run dev
  4. Build for production:

    npm run build

📂 Architecture

src/
├── assets/          # Static images, icons, and SVG illustrations
├── components/      # Reusable global UI components (Search, NavBar, etc.)
│   └── ui/          # base shadcn primitives
├── data/            # Mock JSON data for users, teams, and ideas
├── features/        # Feature-based module organization
│   ├── auth/        # Login, Register, Session management
│   ├── ideas/       # Library browsing and detail views
│   ├── profile/     # User profile and settings
│   ├── teams/       # Team creation and member management
│   ├── supervision/ # Request handling for TAs
│   └── notifications/
├── layouts/         # Layout wrappers (Root, WithoutNav)
├── pages/           # High-level route components
├── router/          # React Router configuration and guards
└── store/           # Global Zustand store definitions

🤝 Contributing

We welcome contributions! If you have ideas for features or find bugs, please:

  1. Fork the repo.
  2. Create your feature branch (git checkout -b feature/AmazingFeature).
  3. Commit your changes (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

📄 License

This project is private and intended for educational purposes at Mansoura University.


Developed with ❤️ by Loai Wael

About

A smart, rule-based recommendation platform designed to take the friction out of academic team formation. This frontend application connects students and team leaders by matching technical skills, academic tracks, and project requirements.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages