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.
š 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.