🔗 Live Website: https://studymateplus.vercel.app

StudyMatePlus is an open-source platform designed to help college students access academic resources such as syllabus, previous year question papers (PYQs), and exam feedback, along with an option to connect with seniors for guidance. The goal is to support students during exam preparation by providing a centralized, reliable, and user-friendly resource hub.

Students often face difficulty finding authentic academic materials in one place. Information like syllabus PDFs, PYQs, and exam tips are scattered or unavailable. This project aims to build a platform that:

• Organizes syllabus and PYQs department-wise
• Includes student feedback on exam papers (e.g., difficulty levels, important topics)
• Connects juniors with seniors for mentoring and doubt clearing
• Supports multiple universities and departments in one place

• ✅ Filter syllabus and papers by university, semester, subject
• ✅ Student feedback section for each paper (e.g., "Paper was tricky — focus on Unit 2")
• ✅ Secure senior-student chat or forum system
• ✅ Upload and browse notes, guides, and important questions
• ✅ Clean and mobile-friendly interface

StudyMatePlus/
├── client/                # Frontend code
├── server/                # Backend code
├── docs/                  # Diagrams, mockups
├── .github/               # Issue templates, PR templates
├── README.md
├── CONTRIBUTING.md
├── LICENSE
└── .env.example

Click on the Fork button on the top-right corner of this page to create your own copy.

git clone https://github.com/your-username/StudyMatePlus.git
cd StudyMatePlus

To install the required dependencies, run the following commands:

npm install         # Install server-side dependencies
cd client
npm install         # Install frontend (React) dependencies

Create a .env file in both the root and client/ directories using the .env.example file provided as a reference.

Update values like your MongoDB URI and secret keys. Example

PORT=5000
MONGO_URI=your-mongodb-uri-here
JWT_SECRET=your-secret-key-here

Start both the backend and frontend:

# Terminal 1
npm run dev         # Runs server on localhost:5000 (or your preferred port)

# Terminal 2
cd client
npm start           # Runs React frontend on localhost:3000

We welcome contributors of all experience levels, especially beginners participating through GirlScript Summer of Code (GSSoC) 2025 and beyond.

Follow the steps below to begin your contribution journey:

• 📘 Read our README.md
• 📚 Go through the CONTRIBUTING.md
• 🤝 Understand our Code of Conduct

• Check the Issues tab for good first issue labels
• Comment on the issue you want to work on
• Wait for the maintainers to assign you the issue

• Create a new branch: git checkout -b feature-name
• Make your changes
• Run tests and ensure everything works smoothly

• Push your changes: git push origin feature-name
• Open a Pull Request (PR) from your forked repository
• Link the issue number in your PR description

We follow a Contributor Covenant to ensure a welcoming environment for everyone.

This project is licensed under the MIT License.

For queries or discussions:

• Contact me on LinkedIn (https://www.linkedin.com/in/lovely-mahour-992316265/)
• Follow project updates in Issues and Discussions tab

Let's build a student-friendly platform together! 🚀