​

Student Offline Pass App (UniTix Student APK)

​

Why an Offline Student App is Essential

• Zero-Cellular Venues: University basements, sports complexes, and auditoriums frequently suffer from severe network congestion or zero mobile reception.
• No Waiting on Slow Web Pages: Once synced, your passes open instantly without loading spinners or network timeouts.
• 100% Offline Dynamic Pass Generation: The app computes the time-rotating security QR code on-device every 15 seconds using secure local credentials, eliminating the need to ping a server at the venue entrance.

​

📱 Onboarding & First-Time Setup

Step 1: Install APK ➔ Step 2: Log In with Student Email ➔ Step 3: Auto-Sync Vault ➔ Step 4: Ready for Offline Entry

1. Download & Install: Install unitix_student.apk on your Android device (or launch the mobile app).
2. Sign In: Enter your registered UniTix student email address and password.
3. Vault Initialization: On initial sign-in, the app initializes your secure on-device local database and automatically downloads all active event tickets you have purchased or claimed.

​

🗂️ App Screen Layout & UI Components

​

1. The Ticket Vault Header (TicketWalletScreen)

• UniTix Wallet Branding: Top app bar showing the purple gradient ticket icon and the app title.
• Student Identity: Displays your verified name (e.g., Student Pass Vault).
• Sync Vault Button ((🔄) Sync Ticket Vault): Tap this icon at any time while connected to the internet to fetch newly purchased tickets or status updates. A rotating spinner indicates active cloud synchronization.
• Sign Out Button ((🚪) Sign Out): Securely clears credentials and returns to the login screen.
• Status Sync Banner: A notification bar at the top displays sync progress:
  • Passes synchronized with cloud (X passes ready). (When synced successfully)
  • Offline Mode active. (When viewing cached tickets without internet)

​

2. Event Pass Cards

• Status Badge: Green OFFLINE READY badge indicating the ticket is permanently cached on-device.
• Price Tag: Displays FREE PASS or the ticket price in PKR (e.g., Rs. 500).
• Event Title: Bold heading with the event name.
• Society Name: Listed with a university building icon.
• Venue & Date: Listed with a location pin icon (e.g., Main Auditorium • 2026-08-25).
• Action Button: Wide purple button labelled [OPEN DYNAMIC PASS 🎟️].

​

🔄 The Dynamic QR Screen (DynamicQrScreen)

1. Top Security Badge: Green capsule reading 100% Offline Ready • 15s Rotation.
2. Event Header: Event title and your ticket tier (e.g., VIP Front Row, General Admission).
3. Dynamic QR Code Container: High-contrast white container rendering your active time-rotating QR pass.
4. Slot Identifier: Dark monospace pill showing SLOT #X (indicating the active time slice).
5. Refresh Countdown Timer: Displays Xs remaining alongside a purple linear progress indicator that smoothly drains as the 15-second window elapses.
6. Zero-Internet Assurance Card: Informs gate staff and attendees that this pass is generated entirely on-device and will be successfully validated by the Gate Scanner APK even without Wi-Fi.

​

💡 Best Practices for Gate Entry

1. Sync Before Heading to the Venue: Open the app at home or on campus Wi-Fi and tap the Sync Vault icon to ensure all your latest tickets are downloaded.
2. Screen Brightness: Turn your screen brightness to high before presenting your phone to the gate scanner.
3. Do Not Take Screenshots: Screenshots are static and will fail gate validation because the time slot expires within seconds. Always present the live screen inside the app.