UniEvent is a comprehensive event management platform designed specifically for universities, colleges, and educational institutions. It streamlines event discovery, registration, attendance tracking, and analytics while providing role-based access for students, club administrators, and system administrators.
- Centralized Platform: Single source of truth for all campus events
- Data-Driven Insights: Comprehensive analytics for event organizers
- Scalable Architecture: Built on Firebase for enterprise-grade reliability
- Cross-Platform: Native iOS, Android, and Progressive Web App support
- Open Source: MIT licensed, community-driven development
| Feature | Description |
|---|---|
| Event Discovery | Browse and search events filtered by department, year, and interests |
| One-Tap Registration | Quick RSVP with automatic calendar integration |
| Smart Notifications | Push notifications and reminders before events |
| QR Code Check-in | Contactless attendance tracking |
| Gamification | Earn reputation points and compete on leaderboards |
| Saved Events | Bookmark events for later review |
| Event Chat | Real-time discussion with other attendees |
| Feature | Description |
|---|---|
| Event Creation | Rich media support with audience targeting |
| Attendance Dashboard | Real-time QR code scanning and tracking |
| Analytics Suite | Branch-wise, year-wise participation insights |
| Custom Forms | Dynamic registration forms with validation |
| Payment Integration | Built-in ticketing for paid events |
| Google Meet Integration | Auto-generate meeting links for virtual events |
| Reputation Tracking | Gamified scoring based on event success metrics |
| Feature | Description |
|---|---|
| Control Panel | Platform-wide event moderation and oversight |
| Role Management | Assign admin/club privileges via cloud functions |
| Event Moderation | Suspend/unsuspend events that violate guidelines |
| User Analytics | Track platform engagement and usage metrics |
| Bulk Operations | Manage multiple events efficiently |
- React Native + Expo - Cross-platform mobile development
- React Navigation - Routing and navigation
- Firebase SDK - Authentication, Firestore, Storage, Functions
- Expo Notifications - Push notification system
- React Native Reanimated - Smooth animations
- Firebase Cloud Functions - Serverless TypeScript functions
- Firebase Admin SDK - Server-side operations
- Node.js 18+ - Runtime environment
- EmailJS & Resend - Automated email services
- PDF-lib - Certificate generation
- GitHub Actions - CI/CD automation
- ESLint + Prettier - Code quality enforcement
- Jest - Unit testing framework
- Firebase Emulators - Local development environment
- Dependabot - Automated dependency management
- CodeRabbit AI - Automated code reviews
- Node.js 18+ (Download)
- npm or yarn
- Firebase CLI:
npm install -g firebase-tools - Java 11+ (for Firebase Emulators)
# Clone the repository
git clone https://github.com/roshankumar0036singh/Uni-Event.git
cd Uni-Event
# Install app dependencies
cd app
npm install
# Install cloud functions dependencies
cd ../cloud-functions
npm install-
Copy environment template:
cp app/.env.example app/.env
-
Configure credentials in
app/.env:- Firebase project configuration
- Google OAuth Client IDs
- EmailJS keys (optional)
-
Detailed setup: See docs/SETUP.md
Terminal 1 - Backend (Emulators):
cd cloud-functions
npm run serveTerminal 2 - Frontend (Expo):
cd app
npm start
# Press 'w' for web, 'a' for Android, 'i' for iOS- Setup Guide - Comprehensive installation and configuration
- Firebase Setup - Emulator configuration details
- Architecture - System design and architecture
- Contributing Guide - Contribution guidelines
- Code of Conduct - Community standards
We welcome contributions from the community. Whether you're fixing bugs, adding features, improving documentation, or reporting issues, your input is valuable.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Documentation: Project Wiki
Built for the university community to streamline event management and enhance student engagement.
Powered by Firebase, Expo, and React Native.
Professional event management for modern educational institutions