Skip to content

mian-abd/GTG

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

44 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽ“ DePauw Gateway To Gold Pre-College Program Mobile App

A comprehensive mobile application for DePauw University's Pre-College Summer Program, built with React Native and Expo. This app serves administrators, mentors, and students with role-based access to manage and participate in the summer program.

๐ŸŽฅ Live Demo

YouTube Live Demo

๐Ÿ”ด Click here to watch the complete app walkthrough and live demonstration!

See the app in action with real-time features, user interactions, and complete functionality showcase


React Native Expo Firebase TypeScript

๐Ÿ“ฑ App Overview

The DePauw Pre-College Program App is a role-based mobile application designed to enhance the summer program experience for all participants. With dedicated interfaces for Administrators, Mentors, and Students, the app streamlines communication, scheduling, and campus navigation.

๐ŸŽฏ Key Features

๐Ÿ‘จโ€๐Ÿ’ผ For Administrators

  • Real-time Dashboard - Monitor program statistics and activities
  • User Management - Manage mentor and student accounts
  • Schedule Management - Create and modify program schedules
  • Room Assignments - Assign and track student accommodations
  • Analytics & Reporting - View program engagement metrics
  • Firebase Integration - Real-time data synchronization

๐Ÿ‘ฉโ€๐Ÿซ For Mentors

  • Mentor Portal - Personalized dashboard with daily schedules
  • Student Management - View assigned students and track progress
  • Resource Library - Access to mentor handbooks and guidelines
  • Communication Tools - Connect with students and administrators
  • Schedule Coordination - View and manage mentor shift assignments

๐ŸŽ“ For Students

  • Interactive Campus Map - Explore DePauw University campus with 20+ locations
  • Personal Schedule - View daily activities, classes, and events
  • Mentor Connection - Access mentor information and contact details
  • Campus Exploration - Discover academic buildings, residence halls, and facilities
  • Program Information - Access to DePauw's official program resources

๐Ÿ› ๏ธ Technical Architecture

Frontend Stack

  • React Native 0.76.9 - Cross-platform mobile development
  • Expo SDK ~52.0.43 - Development and deployment platform
  • React Navigation 7.x - Navigation and routing
  • Expo Vector Icons - Comprehensive icon library
  • TypeScript - Type-safe development

Backend & Data

  • Firebase 11.6.0 - Real-time database and authentication
    • Firestore for data storage
    • Firebase Auth for user management
    • Cloud Storage for file uploads
  • AsyncStorage - Local data persistence
  • Context API - State management

Development Tools

  • Expo Dev Client - Custom development builds
  • EAS Build - Cloud-based app compilation
  • Document Picker - File import functionality
  • Date-fns - Date manipulation utilities

๐Ÿ“ธ App Screenshots

Note: Screenshots will be added to showcase the modern UI design and user experience across all three user roles.

๐ŸŽจ Design System

  • Dark/Light Theme Support - Adaptive UI design
  • DePauw Branding - Official university colors and assets
  • Modern UI Components - Custom-designed interface elements
  • Responsive Design - Optimized for various screen sizes

๐Ÿš€ Getting Started

Prerequisites

  • Node.js (16.x or higher)
  • npm or yarn
  • Expo CLI (npm install -g @expo/cli)
  • iOS Simulator or Android Emulator (optional)

Installation

  1. Clone the repository

    git clone <repository-url>
    cd GTG
  2. Install dependencies

    npm install
  3. Start the development server

    npm start
    # or
    expo start
  4. Run on device/emulator

    # iOS
    npm run ios
    
    # Android
    npm run android
    
    # Web
    npm run web

๐Ÿ“ฑ Demo Credentials

For testing purposes, use these credentials:

Role Email Password
Admin [email protected] contact devlopers for password
Mentor [email protected] contact devlopers for password
Student [email protected] contact devlopers for password

๐Ÿ—๏ธ Project Structure

GTG/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ assets/                 # Images, fonts, and static files
โ”‚   โ”œโ”€โ”€ components/             # Reusable UI components
โ”‚   โ”‚   โ”œโ”€โ”€ Button.js
โ”‚   โ”‚   โ”œโ”€โ”€ Card.js
โ”‚   โ”‚   โ”œโ”€โ”€ Header.js
โ”‚   โ”‚   โ””โ”€โ”€ ProfileAvatar.js
โ”‚   โ”œโ”€โ”€ context/                # React Context providers
โ”‚   โ”‚   โ”œโ”€โ”€ AuthContext.js      # Authentication state
โ”‚   โ”‚   โ””โ”€โ”€ ThemeContext.js     # Theme management
โ”‚   โ”œโ”€โ”€ navigation/             # Navigation configuration
โ”‚   โ”‚   โ”œโ”€โ”€ AppNavigator.js
โ”‚   โ”‚   โ”œโ”€โ”€ AdminNavigator.js
โ”‚   โ”‚   โ”œโ”€โ”€ MentorNavigator.js
โ”‚   โ”‚   โ””โ”€โ”€ VisitorNavigator.js
โ”‚   โ”œโ”€โ”€ screens/                # Screen components
โ”‚   โ”‚   โ”œโ”€โ”€ admin/              # Administrator screens
โ”‚   โ”‚   โ”œโ”€โ”€ auth/               # Authentication screens
โ”‚   โ”‚   โ”œโ”€โ”€ mentor/             # Mentor screens
โ”‚   โ”‚   โ””โ”€โ”€ visitor/            # Student screens
โ”‚   โ””โ”€โ”€ utils/                  # Utility functions
โ”‚       โ”œโ”€โ”€ firebaseConfig.js   # Firebase configuration
โ”‚       โ”œโ”€โ”€ scheduleService.js  # Schedule management
โ”‚       โ””โ”€โ”€ emailService.js     # Email integration
โ”œโ”€โ”€ assets/                     # Campus images and assets
โ”œโ”€โ”€ android/                    # Android-specific configuration
โ”œโ”€โ”€ ios/                        # iOS-specific configuration
โ”œโ”€โ”€ App.js                      # Main application component
โ””โ”€โ”€ package.json                # Dependencies and scripts

๐Ÿ” Authentication & Security

  • Role-based Access Control - Three distinct user types with appropriate permissions
  • Firebase Authentication - Secure user management
  • Token-based Sessions - Persistent login state
  • Data Validation - Input sanitization and validation

๐ŸŒŸ Key Features Breakdown

๐Ÿ“Š Admin Dashboard

  • Real-time statistics display
  • Quick action buttons for common tasks
  • Recent activity tracking
  • Firebase-integrated data management

๐Ÿ—บ๏ธ Campus Exploration

  • 20+ Campus Locations mapped with high-quality images
  • Interactive location cards with detailed information
  • Category filtering (Academic, Residential, Dining)
  • GPS coordinates and directions
  • Virtual tour integration for select locations

๐Ÿ“… Schedule Management

  • Dynamic schedule loading from Firebase
  • Day-wise schedule organization
  • Event type categorization (Classes, Meals, Activities)
  • Search and filter functionality
  • Real-time updates and synchronization

๐Ÿ‘ฅ Mentor System

  • Dedicated mentor portal with personalized dashboard
  • Student assignment and progress tracking
  • Resource library access
  • Communication tools

๐Ÿš€ Deployment

Mobile App Stores

The app is configured for deployment to both iOS App Store and Google Play Store using EAS Build:

# Build for iOS
eas build --platform ios

# Build for Android
eas build --platform android

# Build for both platforms
eas build --platform all

Configuration Files

  • app.json - Expo configuration
  • eas.json - EAS Build configuration
  • iOS Bundle ID: com.depauw.gtg
  • Android Package: com.depauw.gtg

๐Ÿ”ฎ Future Enhancements

  • Push Notifications - Real-time alerts and announcements
  • Offline Support - Cached data for offline usage
  • Advanced Analytics - Detailed usage and engagement metrics
  • Chat System - In-app messaging between users
  • Calendar Integration - Sync with device calendars
  • Document Management - File sharing and document repositories
  • Biometric Authentication - Fingerprint/Face ID login
  • Multi-language Support - Internationalization

๐Ÿค Contributing

We welcome contributions to improve the DePauw Pre-College Program App! Please follow these steps:

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

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ‘ฅ Development Team

  • Lead Developer: Mian Abdullah
  • Institution: DePauw University
  • Program: Pre-College Summer Program

๐Ÿ“ž Support

For technical support or questions about the app:


Built with โค๏ธ for DePauw University Pre-College Program

Empowering the next generation of scholars through technology

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors