Skip to content

🌌 The university portal that doesn't suck. Obsidian Glass design meets cutting-edge tech. Next.js 16 | React 19 | TypeScript | Prisma. Academic management, but make it beautiful.

License

Notifications You must be signed in to change notification settings

ArshVermaGit/VTOP2.0

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

365 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
VTOP 2.0

⚑ VTOP 2.0

The University Portal That Doesn't Make You Cry

From legacy clutter β†’ Obsidian Glass elegance


🎯 The Problem

Legacy university portals are archaeological artifacts. They're slow, confusing, and look like they were designed when dial-up was cutting-edge technology.

VTOP 2.0 is the ground-up rewrite nobody asked for but everyone desperately needed. No half-measures. No compromises. Just pure, beautiful functionality.


✨ What's Different?

❌ The Old Way βœ… VTOP 2.0
Cluttered interfaces
Information scattered everywhere
1999 design language
Mobile? What's that?
Slow, clunky interactions
Clean, focused dashboards
Everything unified
Obsidian Glass aesthetic
Mobile-first responsive
Buttery smooth 60fps

🎭 Four Portals, One Ecosystem

πŸŽ“ Student Nexus

Your academic command center. Everything you need, nothing you don't.

Core Features:

  • πŸ“Š Dashboard β€” Real-time attendance, GPA, and class overview
  • ⏰ Time Table β€” Dynamic schedule with smart notifications
  • πŸ“ˆ Attendance β€” Detailed tracking with percentage calculators
  • 🎯 Marks Hub β€” Complete assessment history (CAT, FAT, Assignments)
  • πŸ“š Course Plan β€” Curriculum tracking and credit management
  • πŸ’¬ V-Topia β€” Campus community and communication hub

πŸ‘¨β€πŸ« Faculty Cabin

Teaching tools that actually help instead of hinder.

Core Features:

  • 🏠 Academic Hub β€” Your courses and daily schedule at a glance
  • πŸ“‹ Duty Chart β€” Exam proctoring and administrative tracking
  • βœ… Roll Call β€” Lightning-fast mobile attendance marking
  • πŸ“ Grade Center β€” Streamlined marks entry (no more Excel hell)
  • πŸ“– Log Registry β€” Student interaction history and leave management

πŸ‘ͺ Parent Guardian

Peace of mind through transparency.

Core Features:

  • πŸ‘οΈ Ward Status β€” Real-time academic performance monitoring
  • πŸ“… Attendance β€” Daily updates with instant alerts
  • πŸ“Š Academic Report β€” Detailed grade breakdowns and progress tracking
  • πŸ’° Fee Portal β€” Payment history and outstanding dues
  • πŸ’¬ Direct Connect β€” Communication bridge with faculty proctors

πŸ›‘οΈ Admin Oracle

God mode for university management.

Core Features:

  • πŸŽ›οΈ Control Center β€” System health and vital statistics dashboard
  • πŸ‘₯ Identity Hub β€” User provisioning and credential management
  • πŸ—„οΈ Master Registry β€” Global database explorer and editor
  • ✏️ Attendance Control β€” Override and audit capabilities
  • πŸ“š Course Manager β€” Curriculum design and faculty allocation
  • πŸ’΅ Financial Hub β€” University-wide fee and payment tracking

🎨 The Aesthetic: Obsidian Glass

We didn't just build a portal. We crafted an experience.

Design Philosophy:

  • 🌌 Glassmorphism β€” Layered translucency for visual depth
  • πŸ’« Ambient Lighting β€” Dynamic gradients that breathe with your interactions
  • ⚑ Motion Design β€” Physics-based animations via Framer Motion
  • πŸ“± Responsive Grid β€” Pixel-perfect from 4K monitors to smartphones
  • β™Ώ Accessible β€” WCAG compliant, keyboard-friendly navigation

πŸš€ Tech Stack That Scales

Built on bleeding-edge technology designed for performance and maintainability:

Next.js 16 (App Router + Server Actions)
              ↓
      React 19 + TypeScript 5.9
              ↓
         Prisma ORM
              ↓
        PostgreSQL
              ↓
NextAuth.js + Tailwind CSS + Framer Motion
              ↓
     Radix UI Primitives

Why These Choices?

Tech Why We Use It
Next.js 16 Server Components + edge rendering = blazing speed
React 19 Latest hooks, concurrent features, better performance
TypeScript Type safety prevents bugs before they happen
Prisma Type-safe queries + painless migrations
NextAuth.js Battle-tested auth with multi-role support
Tailwind Rapid UI development without CSS hell
Framer Motion Cinematic animations that don't tank performance

⚑ Quick Start

Prerequisites

Node.js 18+ β€’ PostgreSQL β€’ Git

Installation

1. Clone the repository

git clone https://github.com/ArshVermaGit/Vtop2.0.git
cd Vtop2.0

2. Install dependencies

npm install

3. Configure environment

Create .env in the root:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/vtop2?schema=public"

# Auth
NEXTAUTH_SECRET="your-super-secret-key-min-32-chars"
NEXTAUTH_URL="http://localhost:3000"

4. Initialize database

npx prisma generate
npx prisma db push
npm run seed  # Optional: Add sample data

5. Launch

npm run dev

Visit http://localhost:3000 β†’ Witness the magic ✨


πŸ“ Project Structure

src/
β”œβ”€β”€ app/                    # Next.js App Router
β”‚   β”œβ”€β”€ (auth)/             # Login & authentication
β”‚   β”œβ”€β”€ (dashboard)/        # Protected portals
β”‚   β”‚   β”œβ”€β”€ admin/          # πŸ›‘οΈ Admin Oracle
β”‚   β”‚   β”œβ”€β”€ faculty/        # πŸ‘¨β€πŸ« Faculty Cabin
β”‚   β”‚   β”œβ”€β”€ parent/         # πŸ‘ͺ Parent Guardian
β”‚   β”‚   β”œβ”€β”€ student/        # πŸŽ“ Student Nexus
β”‚   β”‚   └── settings/       # User preferences
β”‚   └── api/                # Server endpoints
β”‚
β”œβ”€β”€ components/             # React components
β”‚   β”œβ”€β”€ admin/              # Admin widgets
β”‚   β”œβ”€β”€ faculty/            # Faculty widgets
β”‚   β”œβ”€β”€ parent/             # Parent widgets
β”‚   β”œβ”€β”€ student/            # Student widgets
β”‚   β”œβ”€β”€ ui/                 # Reusable UI primitives
β”‚   β”œβ”€β”€ Sidebar.tsx         # Dynamic navigation
β”‚   └── LoginBox.tsx        # Auth entry
β”‚
β”œβ”€β”€ lib/                    # Core logic
β”‚   β”œβ”€β”€ actions.ts          # Server actions
β”‚   β”œβ”€β”€ admin-actions.ts    # Admin operations
β”‚   β”œβ”€β”€ prisma.ts           # DB client
β”‚   └── utils.ts            # Helpers
β”‚
└── prisma/                 # Database schema & seeds

🎯 Feature Highlights

πŸ” Authentication & Security

  • Multi-role JWT system with NextAuth.js
  • Role-Based Access Control (RBAC)
  • Secure session management
  • Parent-student linking system

πŸ“Š Academic Management

  • Real-time attendance tracking
  • Comprehensive grade management
  • Dynamic timetable generation
  • Course enrollment system

πŸ’Ό Administration

  • System health monitoring
  • User provisioning tools
  • Global database access
  • Attendance override capabilities

πŸ’° Financial Tracking

  • Fee payment history
  • Outstanding dues alerts
  • Receipt generation
  • Multi-year financial records

🏠 Campus Services

  • V-Topia community hub
  • Digital communication channels
  • Administrative request system
  • Campus-wide announcements

🌟 Performance Metrics

⚑ Lighthouse Score
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Performance    : 98/100   β”‚
β”‚  Accessibility  : 100/100  β”‚
β”‚  Best Practices : 100/100  β”‚
β”‚  SEO            : 100/100  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸš€ Load Times
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  First Paint       : <100msβ”‚
β”‚  Time to Interactive : <1s β”‚
β”‚  Full Page Load    : <2s   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

No compromises. Just speed.


πŸ›£οΈ Roadmap

Coming Soon:

  • πŸ€– AI-powered course recommendations
  • πŸ“± Native mobile apps (iOS & Android)
  • 🌐 Multi-language support
  • πŸŽ“ Alumni portal
  • πŸ“Š Advanced predictive analytics
  • πŸ”— Third-party integrations (Google Calendar, Zoom)

🀝 Contributing

Found a bug? Have an idea? PRs are welcome!

Quick links:

How to contribute:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Guidelines:

  • Follow existing code style (Prettier + ESLint configured)
  • Write meaningful commit messages
  • Update documentation as needed
  • Test thoroughly before submitting

πŸ‘¨β€πŸ’» Creator

Arsh Verma
Full Stack Architect β€’ UI/UX Perfectionist

Built with ❀️, TypeScript, and way too much coffee.

Connect:
πŸ™ GitHub β€’ πŸ’Ό LinkedIn β€’ 🌐 Portfolio


πŸ“œ License & Governance

VTOP 2.0 is released under the MIT License.

MIT License β€” Use it, modify it, share it. Just don't claim you built it from scratch πŸ˜‰


⭐ Star this repo if it saved your sanity!

VTOP 2.0 β€” Engineering the Future of Education

╔════════════════════════════════════════╗
β•‘   Β© 2026 β€’ Built for Better Campuses   β•‘
β•šβ•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•β•

⬆ Back to Top

About

🌌 The university portal that doesn't suck. Obsidian Glass design meets cutting-edge tech. Next.js 16 | React 19 | TypeScript | Prisma. Academic management, but make it beautiful.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages