UniDash: All in one dashboard for university students

August 1, 2024

UniDash šŸŽ“

A unified portal aggregator for BITS Pilani Dubai Campus

UniDash simplifies university life by bringing all your academic tools and resources into one place. Built specifically for BITS Pilani Dubai Campus students and faculty.

Next.js TypeScript Tailwind

šŸš€ Key Features

šŸ“± Core Functionality

  • Single sign-on integration for all university portals
  • Unified dashboard for ERP, LMS, and other systems
  • Progressive Web App (PWA) support

šŸ“š Academic Resources

  • Course pathways visualization
  • Previous year papers repository
  • Student-contributed study materials
  • ACM library access integration

šŸ’¼ Career Services

  • PS1/PS2 company listings
  • Resume builder and templates
  • Career counseling appointment system
  • Google DSC resources

šŸ› ļø Technical Overview

Tech Stack

  • Framework: Next.js 14
  • Language: TypeScript
  • Styling: Tailwind CSS + Radix UI/Shadcn
  • Authentication: Firebase
  • Data Management:
    • SWR for fetching
    • React Hooks for state
    • Papa Parse for CSV handling
  • Icons: Lucide React

System Architecture

flowchart TD
A[UniDash] --> B[Frontend]
A --> C[Authentication]
A --> D[Data Management]
B --> B1[Next.js 14]
B --> B2[TypeScript]
B --> B3[Tailwind CSS]
B --> B4[Radix UI/Shadcn]
C --> C1[Firebase Auth]
D --> D1[SWR]
D --> D2[React Hooks]
D --> D3[Papa Parse]

User Flow

flowchart LR
User --> |Authenticates| Auth[Firebase Auth]
Auth --> |Grants Access| App[UniDash App]
App --> |Fetches Data| Resources[University Resources]
Resources --> ERP[BITS ERP]
Resources --> LMS[LMS Portal]
Resources --> Notes[Uni Notes]
Resources --> Career[Career Services]

šŸ‘©ā€šŸ’» Development Guide

Project Structure

unidash/
ā”œā”€ā”€ src/
ā”‚   ā”œā”€ā”€ app/         # Next.js app router
ā”‚   ā”œā”€ā”€ components/  # Reusable UI components
ā”‚   ā”œā”€ā”€ lib/        # Utility functions
ā”‚   ā””ā”€ā”€ styles/     # Global styles
ā”œā”€ā”€ public/         # Static assets
ā””ā”€ā”€ tests/         # Test files

Contributing Workflow

flowchart LR
    A[Fork] --> B[Clone]
    B --> C[Create Branch]
    C --> D[Make Changes]
    D --> E[Test]
    E --> F[Create PR]

šŸš€ Deployment

Deployment Flow

flowchart LR
A[Code Changes] --> B[PR Created]
B --> C[Preview Deploy]
C --> D{Tests Pass?}
D -->|Yes| E[Review]
D -->|No| A
E --> F[Merge to Main]
F --> G[Production Deploy]

šŸ“„ Additional Resources

šŸ¤ Support

For support, email f20210150@dubai.bits-pilani.ac.in.