IntelliClass

Smart Classroom Management System

A modern AI-powered classroom management platform built using React, TypeScript, Firebase, and Gemini AI.

---

📌 Overview

IntelliClass is a smart classroom and academic management web application developed to simplify communication, academic tracking, and administration inside educational institutions.

The platform provides separate dashboards for students, faculty members, HODs, and administrators with role-based access and cloud database integration.

---

🚀 Features

👨‍🎓 Student Dashboard

• View grades and academic records
• Access course details
• Manage profile information
• Real-time communication system
• Performance analytics

---

👨‍🏫 Faculty Dashboard

• Student management
• Academic monitoring
• Communication tools
• Dashboard analytics

---

🏫 Admin / HOD Dashboard

• User role management
• Department monitoring
• Academic overview
• Administrative controls

---

🤖 AI Integration

• Gemini AI-powered features
• Smart educational assistance
• AI-driven workflow support

---

🛠️ Tech Stack

Technology	Purpose
React	Frontend development
TypeScript	Type safety
Vite	Build tool
Firebase Authentication	User authentication
Firestore Database	Cloud database
Tailwind CSS	UI styling
Gemini AI	AI-powered functionality

---

📂 Project Structure

src/
 ├── components/
 ├── pages/
 ├── dashboard/
 ├── context/
 ├── lib/
 ├── chat/
 └── assets/

---

⚙️ Installation & Setup

Prerequisites

Make sure the following are installed:

• Node.js
• npm

---

🔧 Run Locally

1️⃣ Clone Repository

git clone https://github.com/sarangoki/IntelliClass.git

---

2️⃣ Navigate to Project Folder

cd IntelliClass

---

3️⃣ Install Dependencies

npm install

---

4️⃣ Create Environment File

Create a file named:

.env.local

Add your Gemini API key:

GEMINI_API_KEY=your_api_key_here

---

5️⃣ Run Development Server

npm run dev

Application will run at:

http://localhost:3000

---

🔥 Firebase Configuration

This project uses Firebase services for:

• Authentication
• Firestore Database
• Cloud connectivity

Update Firebase configuration inside:

firebase-applet-config.json

---

📦 Build for Production

npm run build

---

🌐 Deployment

This project can be deployed using:

• Vercel
• Netlify
• Firebase Hosting

---

📸 Screenshots

Add project screenshots here.

---

📖 Learning Objectives

This project demonstrates:

• Modern React architecture
• Cloud database integration
• Role-based authentication
• AI integration using Gemini
• Frontend application development

---

👨‍💻 Author

Gokul Nath S

GitHub: https://github.com/sarangoki

---

📄 License

This project is developed for educational and learning purposes.