Transforming students experience college life — one feature at a time.
Campus Connect is a production-grade, full-stack AI-powered student collaboration platform I built from scratch for Maharishi Markandeshwar University (MMDU), Ambala, Haryana.
Gone are the days of scattered WhatsApp groups, missed placement deadlines, and lost notices. Campus Connect brings everything under one roof — a blazing-fast, real-time platform where students and administrators co-exist in a seamlessly connected digital campus.
This isn't just a college project. This is a startup-ready product.
Built by: Ayush B.Tech Computer Science Engineering, 4th Semester, MMDU
| Technology | Version | Purpose |
|---|---|---|
| React | 18.x | UI component architecture |
| Vite | 5.x | Lightning-fast build tool & HMR |
| React Router v6 | 6.x | Client-side routing & navigation |
| JavaScript ES2024 | — | Modern async/await patterns |
| Technology | Purpose |
|---|---|
| Tailwind CSS v3 | Utility-first responsive styling |
| shadcn/ui | Premium accessible component library |
| Radix UI | Headless UI primitives under shadcn |
| Lucide React | Beautiful consistent icon system |
| CSS Custom Properties | Dynamic theming variables |
| Technology | Purpose |
|---|---|
| Supabase | Backend-as-a-Service platform |
| PostgreSQL 15 | Primary relational database |
| Supabase Auth | JWT-based authentication system |
| Supabase Storage | File storage for PDFs and images |
| Supabase Realtime | WebSocket-based live data sync |
| Supabase Edge Functions | Serverless Deno runtime functions |
| Row Level Security | Database-level access control |
| Technology | Purpose |
|---|---|
| Groq API | Ultra-fast LLM inference engine |
| llama3-8b-8192 | Open-source language model |
| Streaming API | Real-time token-by-token responses |
| RAG Architecture | Context-aware notice querying |
| react-markdown | Markdown rendering for AI responses |
| @tailwindcss/typography | Beautiful prose formatting |
| Technology | Purpose |
|---|---|
| Resend | Transactional email delivery |
| Supabase Cron | Scheduled deadline check jobs |
| Custom HTML Emails | Branded deadline reminder emails |
| Technology | Purpose |
|---|---|
| Git & GitHub | Version control & collaboration |
| Vercel | Zero-config production deployment |
| ESLint | Code quality enforcement |
| PostCSS | CSS transformation pipeline |
📊 Intelligent Dashboard A real-time command center showing live stats, upcoming deadlines, recent notes, placement drives and important notices — all updating instantly without a single page refresh.
📚 Notes Library A full-featured academic resource hub. Upload PDFs, filter by subject and semester, track download counts, and access study materials from anywhere. Powered by Supabase Storage with instant previews.
📅 Events & Announcements Never miss a college event again. Live countdown timers, category filters, featured event banners and one-click registration links for every workshop, seminar, fest and hackathon.
🎓 Placement Hub A hyper-organized placement board showing real-time company drives with CGPA eligibility filters, deadline countdowns, package details and direct application links. Color-coded urgency indicators for closing drives.
🔍 Lost & Found A compassionate community board for lost and found items across campus. Image uploads, category filtering, location tagging and real-time status updates.
💬 Discussion Forum A Stack Overflow-inspired academic forum with upvoting, accepted answers, tag-based filtering, solved/unsolved status and pinned questions. Real community knowledge sharing.
📢 Official Notices A clean notice board with AI-powered querying. Students can ask natural language questions about any notice and get instant intelligent answers. Type filters, importance flags and PDF attachments.
🏫 Campus Clubs A vibrant club discovery portal. Join/leave clubs with one click, view member lists, browse club events and follow clubs on social media. Real-time member count updates.
⚙️ Settings & Profile Granular control over profile information, password management, and notification preferences with individual toggle controls per notification type.
🧠 AI Buddy A persistent AI assistant living in the sidebar with access to real-time campus data — active placement drives, upcoming events, latest notices and available notes. Powered by Groq's llama3-8b-8192 model for near-instant responses. Supports multi-turn conversations with context memory.
📄 AI Notice Assistant Every official notice gets its own AI assistant. Ask "What is the deadline?", "Who is eligible?" or "Summarize this notice" and get precise, context-aware answers drawn directly from the notice content.
📖 Study Assistant Transform any note into an interactive study session:
- Smart Summaries — Bullet-point breakdowns with key concepts
- AI Quiz Generator — Auto-generated MCQs with scoring and explanations
- Flashcard Deck — 3D flip-card study decks with shuffle and navigation
📊 Executive Dashboard High-level platform metrics, user growth trends, branch-wise student distribution and recent activity feeds. Everything an administrator needs at a glance.
📢 Notice Management Push important notices to thousands of students instantly. Toggle importance flags, set expiry dates and manage the entire notice lifecycle from a clean table interface.
💼 Placement Management Full CRUD control over company drives. Toggle active status, edit eligibility criteria, update deadlines and manage applications for every placement opportunity.
📅 Event Management Create, pin and manage campus events. Add posters, set registration deadlines, toggle paid/free status and control what students see on the events page.
👥 User Management Complete visibility into every registered student. Change user roles inline, deactivate accounts, search and filter by branch/semester/role, and deep-dive into individual user profiles with activity statistics.
📈 Platform Analytics Data-driven insights into platform health — most downloaded notes, trending forum discussions, branch demographics, content growth trends and engagement metrics.
🔄 Real-Time Everything Every page subscribes to Supabase Realtime WebSocket channels. When an admin posts a notice, every logged-in student sees it appear in under 500ms — no polling, no refresh.
📧 Automated Email System Supabase Edge Functions run on a daily cron schedule, scanning for deadlines and automatically dispatching beautifully designed HTML reminder emails at 7 days and 1 day before every deadline.
🛡️ Enterprise-Grade Security Row Level Security policies at the database level ensure users can only access their own data. Role-based routing guards protect every admin route from unauthorized access.
🔔 Live Notification System In-app notification bell with unread count badges, type-based categorization, mark-as-read functionality and auto-refresh polling — keeping students informed without interrupting their workflow.
1. Clone the repository:
git clone https://github.com/coderayushraj-png/campus-connect.git
cd campus-connect2. Install dependencies:
npm install3. Start development server:
npm run devApp runs at http://localhost:3000
All new users get student role by default.
To elevate an account to Admin:
- Register normally via the signup page
- Go to Supabase Dashboard → SQL Editor
- Run:
UPDATE public.profiles
SET role = 'admin'
WHERE email = 'your@email.com';- Sign out and login again
- Automatically redirected to
/admin/dashboard
campus-connect/
├── public/
├── src/
│ ├── components/
│ │ ├── AIBuddy.jsx
│ │ ├── NotificationBell.jsx
│ │ └── NotificationPanel.jsx
│ ├── hooks/
│ │ ├── useRealtimeTable.js
│ │ └── useDashboardRealtime.js
│ ├── lib/
│ │ └── supabase.js
│ ├── pages/
│ │ ├── auth/
│ │ │ ├── Login.jsx
│ │ │ └── Signup.jsx
│ │ ├── student/
│ │ │ ├── Dashboard.jsx
│ │ │ ├── Notes.jsx
│ │ │ ├── Events.jsx
│ │ │ ├── Placement.jsx
│ │ │ ├── LostFound.jsx
│ │ │ ├── Forum.jsx
│ │ │ ├── Notices.jsx
│ │ │ ├── Clubs.jsx
│ │ │ └── Settings.jsx
│ │ └── admin/
│ │ ├── Dashboard.jsx
│ │ ├── Notices.jsx
│ │ ├── Placements.jsx
│ │ ├── Events.jsx
│ │ ├── Users.jsx
│ │ └── Analytics.jsx
│ ├── App.jsx
│ ├── main.jsx
│ └── index.css
├── supabase/
│ └── functions/
│ ├── send-deadline-email/
│ └── check-deadlines/
├── README.md
├── package.json
└── vite.config.js
✅ Production-ready architecture ✅ Real AI integration (not just ChatGPT wrappers) ✅ Live real-time sync across all pages ✅ Automated email notification pipeline ✅ Enterprise-grade database security (RLS) ✅ Separate admin and student experiences ✅ Mobile responsive design ✅ Seeded with realistic college data ✅ Scalable to any college in India
Distributed under the MIT License.
See LICENSE for more information.
Ayush B.Tech Computer Science Engineering 4th Semester • Maharishi Markandeshwar University Ambala, Haryana
"Built this to solve real problems I face every day as a student at MMDU."
⭐ If this project helped you, consider giving it a star! ⭐
Built with ❤️, lots of ☕ and zero sleep by Ayush