KUConnect

KUConnect is a student resource web application for the University of Karachi, designed to provide semester-wise academic content, quizzes, forums, and an AI-powered chatbot — all in one place.

Status: 🚧 Under Development (MERN Stack)

---

✨ Features (Planned)

• 📂 Semester-wise academic content
• 📝 Quizzes & practice material
• 💬 Discussion forums
• 🤖 AI chatbot for academic help
• 📱 Responsive UI

---

🛠 Tech Stack

Frontend: React + Vite, TailwindCSS, shadcn/ui
Backend: Node.js, Express, MongoDB (coming soon)
Other: ESLint, Prettier, GitHub for version control

---

📦 Getting Started (Local Setup)

Follow these steps to run KUConnect on your local machine:

1️⃣ Clone the Repository

git clone https://github.com/alishanawer/kuconnect-frontend.git

2️⃣ Go into the Project Directory

cd kuconnect-frontend

3️⃣ Install Dependencies

Make sure you have Node.js (v18+) installed. Then run:

npm install

4️⃣ Run the Development Server

npm run dev

The app should now be running at:

http://localhost:5173

---

🤝 Contribution Guidelines

• 📂 Follow the existing folder structure and naming conventions.
• ✔️ Write clean, readable, and well-commented code.
• ❕ Commit messages should be short but descriptive.
• ♾️ Pull the latest changes from the main branch before starting or committing new work.
• 🔗 Create a branch with your name, and work on your assigned features and bug fixes there.
• 🛑 Test your changes before pushing.
• 💭 Submit a pull request (PR) for review before merging into main.

---

📌 Notes

• This project is under active development by the KUConnect team.
• Please follow the contribution guidelines to keep our workflow smooth.

---

🙌 Thanks

Thanks to everyone contributing their time and effort to make KUConnect a reality! 🚀