AmazeCC

A unified student operating system for VIT University

Live Site · API Docs · API Stats

---

Overview

AmazeCC is a comprehensive student dashboard for VIT University, replacing the clunky official VTOP portal with a fast, modern, and intuitive experience. It aggregates attendance, grades, schedules, hostel info, library services, payments, events, and more — all in one place.

Originally forked from Arya4930/UniCC · Captcha solver adapted from arshsaxena/ViBoot-Enhanced

---

Features

Area	Features
Academics	Attendance tracking with color-coded percentages, marks & assessment breakdown, semester-wise grades with CGPA tracking, GPA predictor & what-if simulations, exam schedule (CAT/FAT) with venue info, course curriculum & syllabus viewer
Campus Life	Hostel mess menu, laundry & leave management, day scholar transport & bus route finder, library catalog search (KOHA integration), fee dues, payment history & receipts, event discovery & registration (EventHub), cab sharing platform
Productivity	Command palette (Ctrl+K) with fuzzy search, real-time attendance predictor, Moodle/LMS assignment deadlines, academic calendar with event overlay, on-duty (OD) hours tracker, course dashboard with deep analytics
Experience	Light / Dark / Midnight themes, custom accent colors & palettes, PWA with offline support, push notifications, touch gesture navigation, export to PDF, iCal & images

---

Architecture

                          AmazeCC (Next.js 16)
                              :3001
                                │
                    Main.tsx (Entry) → LoginForm / Dashboard
                        │
                    NavigationTabs (desktop sidebar + mobile nav)
                        │
                    StatsCards (attendance, CGPA, marks, OD)
                        │
                    Sub-tab content (conditional render)
                        │
                    CommandPalette (Ctrl+K overlay)
                        │
              ┌─────────┴──────────┐
              │                    │
         API_BASE ← env(NEXT_PUBLIC_API_URL)
              │                    │
              ▼                    ▼
        AmazeCC API         External Services
     (Next.js API Routes)   (Supabase, VTOP, etc.)
      ~130 POST endpoints
       ~15 GET endpoints
        ~10 Admin endpoints

Frontend: Next.js 16, TypeScript, Tailwind CSS v4, Framer Motion, Radix UI, Recharts · Backend: Next.js API Routes, PostgreSQL, Cheerio, Axios, tough-cookie

---

Tech Stack

---

API Endpoints

Category	Endpoints
Auth	/api/login, /api/status
Academic	/api/attendance, /api/marks, /api/grades, /api/all-grades, /api/schedule, /api/calendar
Hostel	/api/hostel, /api/hostel-leave, /api/mess-menu, /api/mess-feedback
Profile	/api/student, /api/profile-image, /api/bank-info
Payments	/api/payments, /api/payment-receipts, /api/wallet, /api/online-transfer
Library	/api/koha/search, /api/koha/login, /api/koha/patron, /api/library-due
Transport	/api/buses, /api/transport, /api/dayboarder
Events	/api/events, /api/events/profile, /api/clubs/details
LMS	/api/lms-data, /api/lms-data/assignments
Exams	/api/arrear-details, /api/makeup-exam, /api/compre-exam, /api/reexam
Research	/api/faculty-info, /api/research-profile, /api/project
Admin	/api/admin/auth, /api/admin/fresher-resources, /api/admin/buses, /api/admin/migrate

Full API documentation is available at api.amazecc.com.

---

Getting Started

Prerequisites

• Node.js 18+
• npm

Frontend

git clone https://github.com/AmazeContinuityProjects/AmazeCC.git
cd AmazeCC
npm install
npm run dev          # → http://localhost:3001

Backend (Self-Hosted)

The app uses the hosted API (https://api.amazecc.com) by default. To run your own:

# Set up environment
MONGODB_URI=          ADMINS=
B2_ENDPOINT=          ID_SALT=
B2_BUCKET_NAME=       SMTP_PASS=
B2_ACCESS_KEY_ID=     SMTP_USER=
B2_SECRET_ACCESS_KEY= SMTP_HOST=
B2_REGION=

npm run api-build
npm run api-start

Override the API URL via NEXT_PUBLIC_API_URL env var or in src/components/custom/Main.tsx:

export const API_BASE = process.env.NEXT_PUBLIC_API_URL || "https://api.amazecc.com";

Scripts

Command	Description
npm run dev	Start Next.js dev server (:3001, HTTPS)
npm run build	Production build
npm run start	Start production server
npm run test	Run Vitest tests
npm run lint	Run ESLint
npm run api-dev	Start backend in dev mode
npm run api-build	Build backend
npm run api-start	Start backend production

---

Project Stats

---

Contributing

Contributions are welcome! Feel free to fork the repo and submit pull requests.

1. Fork the project
2. Create a feature branch (git checkout -b feat/amazing)
3. Commit your changes (git commit -m 'feat: add amazing thing')
4. Push to the branch (git push origin feat/amazing)
5. Open a Pull Request

Please read and follow our Code of Conduct.

---

License

This project is licensed under the GNU General Public License v3.0.

---

Contributors