🎓 CampusOne — AI-Powered Student Success OS

     **"We are not building just another college app.** **We are building an AI-powered Student Success Operating System for campuses."** [🚀 Live Demo](https://campusone.netlify.app)  ·  [📸 Screenshots](#-screenshots)  ·  [⚙️ Setup](#%EF%B8%8F-setup)  ·  [🧠 Features](#-features)

---

🧩 The Problem

Every day, 40 million college students in India struggle with:

Problem	Reality
📅 Poor planning	Missed deadlines, no study schedule
📋 Low attendance	Students don't know they're about to get debarred
📚 Academic weakness	No personalised gap analysis
💬 Doubt solving	Fear of asking questions in class
🎯 Career confusion	No roadmap until 3rd year panic
🧘 Student stress	Zero mental health support on campus

Students are juggling 6 different apps and still failing. There was no single platform solving all of it — until now.

---

💡 The Solution

CampusOne is a single AI-powered platform that combines all essential student tools into one intelligent ecosystem where every module shares data with every other module.

Attendance dips → Planner adjusts → Alert fires → Stress check-in triggered
Weak topic found → Study plan updated → AI Tutor activated → Recovery plan generated

---

🧠 Features

Module	Description
⚡ Dashboard	Real-time overview — attendance %, placement readiness ring, today's classes, live alerts
🗓️ Smart Timetable	Full weekly schedule, colour-coded by subject, with venue and live updates
📋 Attendance Tracker	Per-subject tracking with skip-budget calculator and danger zone warnings
📚 Academic Planner	AI-generated weekly study grid with adaptive replanning
💬 AI Doubt Solver	Google Gemini-powered 24/7 tutor — ask anything, get exam-focused answers
📊 Weak Topic Analysis	Visual mastery heatmap + auto-generated AI recovery plan
🎯 Placement Roadmap	Semester-by-semester career milestone tracker with company readiness score
🧘 Wellness Check-in	Weekly mood logging, stress trend analysis, counsellor nudges
🔔 Smart Alerts	Priority-tiered contextual notifications (urgent / warning / info)

---

🖥️ Tech Stack

Layer	Technology
Frontend	HTML5, CSS3, Vanilla JavaScript (ES6+)
AI Integration	Google Gemini 1.5 Flash API
Fonts	Nunito + Outfit (Google Fonts)
Deployment	Netlify
Architecture	Single Page Application (SPA) with custom JS router

Zero dependencies. No npm, no React, no build tools. Just open index.html and it works.

---

⚙️ Setup

Option 1 — Run Locally (No install needed)

# Clone the repository
git clone https://github.com/YOUR_USERNAME/campusone.git

# Navigate into the folder
cd campusone

# Open in browser — that's it!
open index.html

Option 2 — Add Gemini AI (Optional but recommended)

1. Get a free Gemini API key at aistudio.google.com/app/apikey
2. Open index.html in any text editor
3. Find this line: javascript const GEMINI_API_KEY = "YOUR_GEMINI_API_KEY_HERE";
4. Replace with your key: javascript const GEMINI_API_KEY = "AIzaSy...your_actual_key";
5. Save and refresh — AI Tutor is now live! 🤖

Note: The AI Tutor works even without a key using the built-in local knowledge base as fallback.

---

📁 Project Structure

campusone/
│
├── index.html              ← Single file — entire app lives here
│
└── (all CSS + JS are inline inside index.html for zero-dependency deployment)

The entire application is a single self-contained HTML file — no external files, no server required, works by double-clicking.

---

📸 Screenshots

Dashboard

Real-time student overview with gradient stat cards, attendance bars, placement ring, and live alerts

AI Doubt Solver

Gemini-powered chat interface with typing animation and exam-focused responses

Attendance Tracker

Per-subject cards with colour-coded progress bars and skip-budget calculator

Weak Topics Heatmap

Visual mastery map — green (strong), yellow (average), red (critical) — with AI recovery plan

Placement Roadmap

Semester-by-semester milestone tracker with readiness ring and target company list

---

🔌 How the AI Works

User types a question
        ↓
Try Gemini 1.5 Flash  (15 req/min free)
        ↓ if quota hit
Try Gemini 1.5 Flash-8B  (higher quota)
        ↓ if that fails too
Local Knowledge Base  (works 100% offline)
        ↓
Clean, formatted answer — every single time ✅

The AI Tutor never shows an error to the user. It always responds.

---

🎯 How Modules Connect (The Data Flywheel)

📋 Attendance low
        ↓
🔔 Smart Alert fires
        ↓
📚 Planner adds extra revision slots
        ↓
📊 Weak Topic flagged from quiz data
        ↓
💬 AI Tutor recommended for that topic
        ↓
🧘 Stress check-in triggered if pattern continues

This interconnection is what separates CampusOne from a bundle of separate apps. It's a system that gets smarter the more you use it.

---

🚀 Deployment

Deploy on Netlify (Recommended)

1. Go to netlify.com → Sign up free
2. Create a folder, put index.html inside it
3. Drag and drop the folder onto the Netlify dashboard
4. Get a live URL instantly: https://your-site-name.netlify.app

Deploy on GitHub Pages

1. Push this repo to GitHub
2. Go to Settings → Pages
3. Set source to main branch → / (root)
4. Your site is live at: https://YOUR_USERNAME.github.io/campusone

---

👩‍💻 Built By

Shreta Ojha CSE AIML · Semester 1 Hackathon 2025

---

📄 License

This project is licensed under the MIT License — feel free to use, modify, and distribute.

---

⭐ Support

If you found this project helpful or impressive, please consider giving it a ⭐ star on GitHub!

It took one hackathon, one problem statement, and a lot of passion to build this.

---

**Built with ❤️ for India's 40 million college students** *"We are not building just another college app.* *We are building an AI-powered Student Success Operating System for campuses."*

Built With

• html
• python