UniWeek - University Event Management App

A comprehensive mobile application for university Student Week where societies (ACM, CLS, CSS) can create and manage events, and students can browse, register, and provide feedback.

Demo: https://igit.me/UniWeek

🚀 Features

For Students

• Browse all university events
• Filter by society (ACM/CLS/CSS), date, and category
• Search events by name
• One-click registration with capacity management
• View registered events ("My Events")
• Rate and review events after attendance
• Push notifications for upcoming events

For Society Handlers

• Create, edit, and delete events
• View event registrations and analytics
• Send custom notifications to registered students
• Track participation rates and feedback
• View charts for registration trends

🛠 Tech Stack

• Framework: Expo React Native + TypeScript
• Database: Supabase (PostgreSQL)
• Authentication: Supabase Auth
• State Management: React Context API
• Navigation: React Navigation v6
• UI Components: React Native Paper
• Charts: react-native-chart-kit
• Notifications: expo-notifications
• Calendar: expo-calendar

📋 Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• Expo CLI (npm install -g expo-cli)
• Supabase account (free tier available)

🔧 Installation

1. Clone and Install Dependencies

cd "e:\\University\\VISIO SPARK"
npm install

2. Supabase Setup

1. Go to https://supabase.com and create a new project
2. Once created, go to Settings > API
3. Copy your Project URL and anon/public key
4. Navigate to src/services/
5. Copy supabase-config.example.ts to supabase-config.ts
6. Fill in your Supabase credentials:

export const SUPABASE_URL = 'https://your-project.supabase.co';
export const SUPABASE_ANON_KEY = 'your-anon-key-here';

3. Database Setup

1. Go to your Supabase project dashboard
2. Click on SQL Editor
3. Copy the SQL from supabase-config.example.ts comments
4. Run the SQL to create all tables and policies

This will create:

• users table (student and society profiles)
• events table (all event information)
• registrations table (event registrations with ratings)
• notifications table (custom notifications)
• Row Level Security policies

4. Install Additional Dependencies

If using a physical device, install the Expo Go app:

• iOS App Store
• Google Play Store

🚀 Running the App

Development Mode

npm start

This will open Expo DevTools. You can then:

• Press a to open on Android emulator
• Press i to open on iOS simulator
• Scan QR code with Expo Go app on your phone

Platform-Specific

# Android
npm run android

# iOS
npm run ios

# Web
npm run web

📁 Project Structure

uniweek/
├── src/
│   ├── components/
│   │   ├── common/          # Reusable components (Button, Card, Input)
│   │   ├── events/          # Event-specific components
│   │   └── analytics/       # Chart and analytics components
│   ├── context/
│   │   ├── AuthContext.tsx  # Authentication state management
│   │   └── EventContext.tsx # Event state management
│   ├── navigation/
│   │   ├── AppNavigator.tsx      # Root navigator
│   │   ├── AuthNavigator.tsx     # Login/Signup flow
│   │   ├── StudentNavigator.tsx  # Student tab navigation
│   │   └── SocietyNavigator.tsx  # Society tab navigation
│   ├── screens/
│   │   ├── auth/            # Login and Signup screens
│   │   ├── student/         # Student-specific screens
│   │   ├── society/         # Society-specific screens
│   │   └── shared/          # Shared screens (Profile, Feedback)
│   ├── services/
│   │   ├── supabase.ts      # Supabase client setup
│   │   ├── auth.ts          # Authentication services
│   │   ├── events.ts        # Event CRUD operations
│   │   ├── notifications.ts # Push notification handling
│   │   └── ai.ts            # AI recommendations
│   ├── types/
│   │   └── index.ts         # TypeScript interfaces
│   └── utils/
│       ├── constants.ts     # App constants and theme
│       └── helpers.ts       # Utility functions
├── App.tsx                  # App entry point
├── package.json
└── README.md

🔐 Authentication Flow

1. Signup: Users create an account selecting role (Student/Society)
   • Society users also select their society (ACM/CLS/CSS)
2. Login: Email/password authentication via Supabase Auth
3. Navigation: Users are routed to appropriate dashboard based on role

💾 Database Schema

Users

id, email, name, role (student|society), 
society_type (ACM|CLS|CSS), registered_events[], created_at

Events

id, title, description, date, time, venue, society,
category, capacity, registered_students[], created_by, 
created_at, updated_at

Registrations

id, user_id, event_id, timestamp, attended, 
rating (1-5), feedback

🎨 Design System

• Society Colors:

  • ACM: Blue (#2196F3)
  • CLS: Green (#4CAF50)
  • CSS: Orange (#FF9800)

• Theme: Material Design principles with React Native Paper

📱 Key Screens

Student Flow

1. Browse Events - Filter and search all events
2. Event Details - View full event info and register
3. My Events - View registered events
4. Feedback - Rate and review attended events

Society Flow

1. My Events - View and manage created events
2. Create/Edit Event - Event management forms
3. Event Analytics - Registration stats and feedback
4. Send Notifications - Notify registered students

🔔 Notifications

• Automatic reminders 24 hours before registered events
• Custom notifications from societies to registered students
• Push notification permissions requested on first launch

🤖 AI Features

The app includes basic AI-powered features:

• Event Recommendations: Suggests events based on past registrations
• Category Auto-Suggest: Suggests categories based on event title/description
• Sentiment Analysis: Analyzes feedback for positive/negative sentiment

🐛 Troubleshooting

Supabase Connection Issues

• Verify your supabase-config.ts has correct credentials
• Check that Row Level Security policies are properly set up
• Ensure database tables were created successfully

React Native Issues

# Clear cache and reinstall
rm -rf node_modules
npm install
expo start -c

TypeScript Errors

• Run npm install to ensure all type definitions are installed
• Check tsconfig.json is properly configured

📄 License

This project is created for educational purposes as part of a university course.

👥 Team

Developed for University Student Week Event Management

---

📝 Next Steps

1. Install dependencies: npm install
2. Set up Supabase project and configure supabase-config.ts
3. Run database migrations (SQL in config file)
4. Start development server: npm start
5. Test with Expo Go on your device or emulator

For questions or issues, refer to:

• Expo Documentation
• Supabase Documentation
• React Navigation