Offline

πŸ“± Access Control App Guide

πŸ“± Access Control Mobile App Guide

Complete Setup & User Guide

Get your device ready and master the app in minutes!

⏱️ Setup Time: 5-10 minutesπŸ“– User Guide: 10 minutes⭐ Difficulty: Easy

πŸ“‘ Table of Contents

Part 1: Device Setup (Do This First!)

Part 2: User Guide (How to Use the App)


Part 1: Device Setup

πŸš€ Quick Start Checklist

⚠️ IMPORTANT: Complete these 6 steps BEFORE using the app!

βœ… Essential Setup (5 minutes)

  1. ⏱️ Screen Timeout β†’ Set to maximum (30 min or Never)
  2. πŸ”Š Volume β†’ Turn to maximum + Turn OFF Do Not Disturb
  3. 🌐 Internet β†’ Test with YouTube + Browser
  4. πŸ“· Camera β†’ Grant permission when app asks
  5. 🌍 Timezone β†’ Set to the event country's timezone
  6. βœ… Test App β†’ Login and try scanning

πŸ‘‰ Scroll down for detailed instructions on each step.


πŸ“‹ What You'll Need

ItemRequirement
πŸ“± DeviceZebra TC 26, TC 27
🌐 InternetWi-Fi or Mobile Data connection
πŸ“· CameraRequired for scanning QR codes
πŸ”‘ CredentialsUsername and password
πŸ“Š Excel/SheetsGoogle Sheets to view reports
πŸ“§ GmailGmail account to send reports to organizer

⏱️ Step 1: Screen Timeout

🎯 Why: Prevents your screen from locking while scanning badges.

πŸ“± Android Devices

Simple Steps:

  1. Open Settings on your device
  2. Tap Display (or Screen)
  3. Tap Screen timeout (or Sleep)
  4. Choose 30 minutes or Never (if available)

πŸ“ Can't find it?

Device TypePath
Zebra TC26, TC27Settings β†’ Display β†’ Screen timeout

πŸ’‘ Pro Tip: If you see "Keep screen on" option, turn it ON!


πŸ”Š Step 2: Sound & Volume Settings

🎯 Why: You need to hear confirmation sounds when badges are scanned successfully.

πŸ“± Quick Setup (All Devices)

Step 1: Turn Volume to Maximum

  • Press the Volume Up button until it reaches maximum
  • Or go to: Settings β†’ Sound β†’ Volume β†’ Set to maximum

Step 2: Turn OFF Do Not Disturb

  • Swipe down from top β†’ Look for "Do Not Disturb" icon β†’ Tap to turn OFF
  • Or: Settings β†’ Sound β†’ Do Not Disturb β†’ Turn OFF

Step 3: Turn OFF Silent Mode

  • Make sure your device is NOT in silent/vibration-only mode
  • Check the volume buttons

🌐 Step 3: Internet Connection

🎯 Why: The app needs internet to login, scan badges, and sync data.

βœ… Quick Internet Test (2 Minutes)

Test 1: YouTube Test

  1. Open YouTube app
  2. Play any video
  3. βœ… If video plays smoothly β†’ Internet is working!

Test 2: Browser Test

  1. Open Chrome browser
  2. Visit: www.google.com
  3. βœ… If page loads β†’ Internet is working!

Test 3: Backend Server Test (Optional but recommended)

  1. In browser, visit: https://registration.xporience.com
  2. βœ… If page loads β†’ Server is accessible!

πŸ“Ά Connection Status Guide

Connection TypeWhat to Check
Wi-Fiβœ… Connected to Wi-Fi (check top of screen)
βœ… Signal shows 2-3 bars minimum
βœ… Move closer to router if weak
Mobile Dataβœ… Mobile Data is ON (check settings)
βœ… Signal shows 2-3 bars minimum
βœ… Check you have data plan available

⚠️ Important Notes

Internet StatusWhat Happens
βœ… Good internetSmooth scanning and instant sync
⚠️ Poor internetApp saves badges offline, syncs later
❌ No internetCan't login, but can scan and save offline

πŸ’‘ Tip: Test internet BEFORE the event starts!


πŸ“· Step 4: App Permissions

🎯 Why: The app needs permission to use your camera and save files.

πŸ“· Camera Permission (REQUIRED)

When: App will ask when you first open the scanner screen.

What to do:

  1. Open the app
  2. Go to Scanner screen
  3. App will ask: "Allow camera access?"
  4. Tap Allow or OK

If you accidentally denied it:

  • Settings β†’ Apps β†’ Access Control App β†’ Permissions β†’ Camera β†’ Allow

πŸ’Ύ Storage Permission (Android Only - For Exports)

When: App will ask when you try to export data to Excel/CSV.

What to do:

  1. When app asks for storage permission
  2. Tap Allow

If you need to grant it manually:

  • Settings β†’ Apps β†’ Access Control App β†’ Permissions β†’ Storage β†’ Allow

βœ… Other Permissions (Automatic)

These are granted automatically - no action needed:

  • βœ… Internet Permission (for API calls)
  • βœ… Vibration Permission (for haptic feedback)

🌍 Step 5: Timezone Settings

🎯 Why: Scan times, "Today's Scans," and reports depend on the correct timezone. Wrong timezone = wrong dates and counts.

⚠️ Do This BEFORE the Event

Set the timezone for the country where the event is held β€” before the event starts.

Event Country ExampleSet Timezone To (examples)
IndiaAsia/Kolkata (IST, UTC+5:30)
UAE / DubaiAsia/Dubai (GST, UTC+4)
UKEurope/London (GMT/BST)
USA (East Coast)America/New_York (EST/EDT)
SingaporeAsia/Singapore (SGT, UTC+8)

Ask your event organizer if you are unsure which timezone to use.

πŸ“± Set Device Timezone

Android

  1. Open Settings
  2. Tap System β†’ Date & time (or General management β†’ Date and time)
  3. Turn OFF "Automatic date & time" / "Use network-provided time" if needed
  4. Tap Time zone (or Set time zone)
  5. Select the event country's region / city
  6. Confirm the clock shows the correct local time for that country

iOS

  1. Open Settings
  2. Tap General β†’ Date & Time
  3. Turn OFF "Set Automatically" if you need a specific zone
  4. Tap Time Zone
  5. Search and select the event country's city
  6. Confirm the clock shows the correct local time for that country

πŸ§‘β€πŸ’Ό Account / Event Timezone (Admin)

The app also uses the timezone returned at login for visit timestamps. Before the event:

  1. Confirm with your admin that the user/event timezone is set for the same country as the venue
  2. If the event moves to another country, the timezone must be updated again before scanning starts
  3. Do not start scanning until both device and account timezones match the event country

βœ… Verification Test

  1. Check the device clock against local time at the venue
  2. Login to the app and confirm the date on the Home Screen looks correct
  3. βœ… Success! You're ready for the next step.

Part 2: User Guide

🎯 Getting Started

Welcome to the Access Control Mobile App!

This app helps you scan and manage visitor badges at events. Follow this guide to learn how to use all features effectively.


🧭 Quick Flow Overview

Follow these six checkpoints and tap the section links if you need more detail:

  1. Launch & Splash β†’ wait for the purple Access Control splash screen to finish loading.
  2. Login β†’ enter username + password, tap LOGIN.
  3. Select Space β†’ search or tap the correct gate, confirm if prompted.
  4. Dashboard β†’ verify Online status, check stats, sync if needed.
  5. Scan β†’ tap the floating QR button, keep scanning (even offline).
  6. Export/Report β†’ Tap the email icon (envelope) in the top-right corner to send reports to the organizer.

πŸ–ΌοΈ Visual Walkthrough

Use these annotated screenshots to get familiar with each major screen before you head onsite. All images live in docs-site/public/assets/images.

Splash Screen

Purple splash screen with Access Control logo
App boot screen – indicates the bundle is loading.

  • Shows the branded purple gradient background and Access Control logo while the app initializes.
  • Confirms that the Access control bundle is loading correctly before navigation is available.

Login Screen

Login screen with username and password fields, Login button, and Scan to Login button
Enter credentials manually or scan QR code to login quickly.

  • Clean, minimal layout with rounded inputs for Username and Password.
  • Password field includes a visibility toggle, and the primary LOGIN button stays disabled until both fields contain text.
  • SCAN QR TO LOGIN button allows you to quickly scan a QR code containing your credentials instead of typing them manually.
  • Reminder text β€œLogin to Access Control App” matches the setup instructions in the guide.

Space Selection Screen

Space selection screen showing list of gates
Search or tap the correct gate, then continue to the dashboard.

  • Appears immediately after a successful login.
  • Search bar filters long space lists instantly; each card displays the space name with a soft shadow.
  • Selected space highlights with a purple border and check mark so operators can confirm before the scanning.

Password Prompt Modal

Password prompt modal with scan QR icon, Cancel, and Okay buttons
Shown when switching spaces or exportingβ€”you’ll need the shared password.

  • When exporting, switching spaces, or accessing restricted tools, the app shows this centered modal.
  • Eye icon toggles password visibility; Scan QR icon allows you to quickly scan a QR code to fill the password field.
  • Cancel (red) backs out, Okay (green) confirms.

Home Dashboard

Home dashboard with online status, stats card, and floating scan button
Live status, stats, sync/export/email actions, and the big scan button.

  • Displays online/offline badge in the top-left, real-time sync/export/email icons on the right, and live statistics (Today’s Scans, Total Unsynced, Total Scans).
  • The floating scan button opens the QR scanner; tapping the space name or arrow lets you switch spaces.
  • Bottom sheet shows the current date and selected space, mirroring the behavior described in the β€œHome Screen Overview” section.

πŸ” Login Process

Step-by-Step Login

  1. Open the App

    • Launch the Access Control Mobile App
    • You'll see the login screen
  2. Enter Credentials

    Option A: Manual Entry

    • Username: Enter your username (no spaces allowed)
    • Password: Enter your password
    • Tap the eye icon to show/hide password

    Option B: QR Scan (Quick Login)

    • Tap "SCAN QR TO LOGIN" button
    • Scan a QR code containing your credentials in format: {"username":"your@email.com","password":"yourpassword"} or username:password
    • App will automatically fill credentials and proceed with login
  3. Tap LOGIN Button (or wait for auto-login after QR scan)

    • Wait for authentication (spinner will show)
    • On success, you'll be taken to Space Selection screen

⚠️ Login Troubleshooting

ProblemSolution
"Credentials can not be left blank"Make sure both username and password are entered
"You're offline. Please connect to the internet"Check internet connection and try again
"Invalid Credentials"Verify credentials are correct

🏒 Space Selection

A Space is a specific area or location at the event where you'll be scanning badges. You must select a space before you can start scanning.

Selecting Your Space

  1. After Login

    • You'll see a list of available spaces
  2. Search for Space (if many spaces)

    • Use the search bar at the top
    • Type space name to filter
  3. Select Your Space

    • Tap on the space you want to work in
    • Wait for confirmation
  4. Success!

    • You'll be taken to the Home Screen
    • Your selected space name appears on Homescreen.

Understanding Space Types

Space TypeBehavior
Visitor (Type 1)Detects if someone already checked in today
Shows "Successful Re-checkin" if scanned again
Conference (Type 2)Always allows checkin
No duplicate detection

🏠 Home Screen Overview

Main Components

The Home Screen is your main dashboard. Here's what you'll see:

Top Section:

  • Logo/Header - Event branding
  • Sync Icon - Shows sync status (rotating = syncing)
  • Export Icon - User can export the data in Excel
  • Send Report - User can Send report to the Organiser.

Bottom Section:

  • Current Date - Shows today's date
  • Space Name - Your selected space (tap to change)
  • πŸ“Š Today's Scans - Badges scanned today
  • πŸ”„ Total Unsynced - Badges waiting to sync
  • πŸ“ˆ Total Scans - All-time scan count
  • SCAN BADGE Button - Opens camera scanner

Understanding the Sync Icon

Icon StateMeaning
πŸ”„ RotatingSync in progress - wait for it to finish
βœ… StaticSync complete - all badges synced

πŸ’‘ Tip: Tap the sync icon to manually trigger sync if needed.


πŸ“Έ Scanning Badges

Two Ways to Scan

The app supports two scanning methods:

  1. πŸ”΄ Laser Scanner - Uses QR code scanner (recommended)
  2. πŸ“· Camera Scanner - Uses device camera

Method 1: Laser Scanner

  1. Scanner will automatically detect when badge is scanned
  2. Same feedback sounds and messages apply

Method 2: Camera Scanner

Opening the Scanner

  1. From Home Screen, tap "SCAN BADGE" button
  2. Camera will open automatically
  3. Grant camera permission if asked (first time only)

How to Scan

  1. Wait for Scan

    • Camera will automatically detect QR code
    • You'll hear a success sound βœ… or error sound ❌
    • Device will vibrate for feedback
  2. Result Messages

    • βœ… "Successfully Checked in" - Badge scanned successfully
    • ❌ "Invalid Badge" - QR code format is wrong
    • πŸ”„ "Successfully Checked in" (offline) - Saved locally, will sync later
  3. Continue Scanning

    • Camera stays open for continuous scanning
    • No need to tap button again
    • Scan multiple badges quickly

Understanding Scan Results

ResultWhat It MeansWhat Happens
βœ… Successfully Checked inBadge is valid and approvedSaved to server (if online) or locally (if offline)
⚠️ Successful Re-checkinVisitor already checked in today (Type 1 spaces)Still recorded, but marked as re-checkin
❌ Invalid BadgeQR code format is wrongNot saved - try scanning again
πŸ”’ Restricted BadgeBadge has restrictionsNot saved - badge cannot be used
🌐 Offline ModeNo internet connectionSaved locally, will sync when online

πŸ”„ Understanding Sync Status

Syncing means uploading scanned badges from your device to the server.

Sync States

StateIconMeaningAction Needed
SyncingπŸ”„ RotatingUploading badges to serverWait for completion
Syncedβœ… StaticAll badges uploadedNone - ready to scan

⚠️ Important Notes

  • Don't scan during sync - Wait for sync to complete
  • Check internet - Sync requires internet connection
  • Offline badges are safe - They'll sync when internet returns

πŸ“Š Viewing Statistics

Statistics Cards on Home Screen

The Home Screen shows three important statistics:

1. Today's Scans

  • Shows count of badges scanned today
  • Resets at midnight
  • Includes both synced and unsynced badges

2. Total Unsynced

  • Shows count of badges waiting to sync
  • Should be 0 when fully synced

3. Total Scans

  • Shows all-time scan count
  • Includes all badges ever scanned
  • Never resets

Understanding the Numbers

StatisticWhat It IncludesWhen It Updates
Today's ScansAll badges scanned today (synced + unsynced)Immediately after each scan
Total UnsyncedBadges saved offline, not yet uploadedUpdates during sync
Total ScansAll badges ever scanned (all time)Immediately after each scan

πŸ“€ Exporting Data

Exporting Badge Data

You can export all scanned badge data to Excel/CSV files:

How to Export:

  1. From Home Screen, tap the email icon (envelope icon) in the top-right corner
  2. Password popup will appear
  3. Enter password manually or tap "Scan QR" icon to scan a QR code containing the password
  4. File will be generated and sent via email, or you can access it from your device

What Gets Exported:

  • βœ… All scanned badges (synced + unsynced)
  • βœ… Badge numbers, dates, times
  • βœ… Space information
  • βœ… Event details

Export File Format

  • Format: CSV
  • Naming: Includes date and space name

βš™οΈ Switching Spaces

When to Switch Spaces

You might need to switch spaces if:

  • You're moving to a different area
  • You're covering multiple spaces
  • You selected the wrong space initially

How to Switch

  1. From Home Screen, tap the space name at the bottom (or the arrow β€Ί)
  2. Enter password manually or tap "Scan QR" icon to scan a QR code containing the password
  3. Select new space from the list
  4. Wait for sync - App will sync offline badges before switching
  5. Confirm selection - You'll return to Home Screen with new space

⚠️ Important Notes

  • Statistics reset for the new space
  • Make sure sync completes before switching
  • You can switch back to previous spaces anytime

βœ… Complete Setup Checklist

⏱️ Device Settings (5 minutes)

  • Screen timeout β†’ Set to maximum (30 min or Never)
  • Volume β†’ Turn to maximum
  • Do Not Disturb β†’ Turn OFF
  • Silent Mode β†’ Turn OFF
  • Test sound β†’ Play a notification to verify

🌐 Internet Connection (2 minutes)

  • Wi-Fi or Mobile Data β†’ Connected and active
  • YouTube test β†’ Video plays smoothly
  • Browser test β†’ Google.com loads
  • Signal strength β†’ 2-3 bars minimum

πŸ“· App Permissions (1 minute)

  • Camera permission β†’ Granted (app will ask)
  • Storage permission β†’ Granted (Android only, when exporting)

🌍 Timezone Settings (1 minute)

  • Device timezone β†’ Set to the event country's timezone
  • Account/event timezone β†’ Confirmed with admin for the same country
  • Clock check β†’ Device time matches local venue time

πŸ“± App Testing (2 minutes)

  • Login β†’ Successfully logged in
  • Space selection β†’ Spaces loaded correctly
  • Camera scanner β†’ Opens without errors
  • Test scan β†’ Try scanning a QR code (if available)
  • Sound feedback β†’ Hear success/error sounds
  • Vibration β†’ Feel haptic feedback

πŸ”‹ Final Checks

  • Battery β†’ Charged or plugged in
  • Storage space β†’ At least 1 GB free
  • Login credentials β†’ Ready to use

❓ Troubleshooting

πŸ”’ Problem: Screen Keeps Locking

Quick Fix:

  1. Go back to Step 1 (Screen Timeout)
  2. Set to maximum time
  3. Look for "Keep screen on" option

Still locking?

  • Some devices have battery saver modes that override settings
  • Disable battery optimization for the app
  • Keep device plugged in if possible

πŸ”‡ Problem: No Sound When Scanning

Quick Fix:

  1. Press Volume Up button β†’ Set to maximum
  2. Turn OFF Do Not Disturb
  3. Turn OFF Silent Mode
  4. Test with a notification

Still no sound?

  • Restart the app
  • Restart your device
  • Check Settings β†’ Sound β†’ App Volume

🌐 Problem: Internet Not Working

Quick Fix:

  1. Test YouTube β†’ Does video play?
  2. Test Browser β†’ Does Google load?
  3. Check Wi-Fi/Mobile Data is ON
  4. Restart device

Still not working?

  • Forget Wi-Fi and reconnect
  • Turn Mobile Data OFF and ON
  • Check if other apps can use internet
  • Contact IT support if on corporate network

πŸ“· Problem: Camera Won't Open

Quick Fix:

  1. Grant camera permission (see Step 4)
  2. Close app completely
  3. Reopen app
  4. Try scanner again

Still not working?

  • Check if camera works in other apps
  • Restart device
  • Check for app updates

πŸ”„ Problem: Badges Not Syncing

Quick Fix:

  1. Check internet connection
  2. Look for sync icon (should be rotating)
  3. Wait for sync to complete
  4. Manually tap sync button

Still not syncing?

  • Check internet speed (may be too slow)
  • Restart app
  • Check device storage space
  • Try syncing one badge at a time

πŸ’₯ Problem: App Crashes or Freezes

Quick Fix:

  1. Close all other apps
  2. Restart the app
  3. Restart device

Still crashing?

  • Check device storage (need at least 1 GB free)
  • Clear app cache (Android: Settings β†’ Apps β†’ App β†’ Storage β†’ Clear Cache)
  • Update the app if available
  • Reinstall app (last resort)

πŸ” Problem: Can't Login

Quick Fix:

  1. Check internet connection
  2. Verify username and password are correct
  3. Make sure username has no spaces
  4. Try again

Still can't login?

  • Check if credentials work on another device
  • Contact administrator for account reset
  • Clear app data and try again (last resort)

πŸ“Š Problem: Statistics Not Updating

Quick Fix:

  1. Restart the app
  2. Check if scans are being saved
  3. Verify sync is working

Still not updating?

  • Check if badges are actually being scanned
  • Verify you're looking at the correct space
  • Contact support if issue persists

πŸ†˜ Need Help?

Before contacting support, try:

  1. βœ… Review this guide again
  2. βœ… Check Troubleshooting section above

When contacting support, provide:

  • πŸ“± Device model (e.g., TC 26, TC 27)
  • πŸ“² Operating system version
  • ❌ What problem you're experiencing
  • βœ… What you've already tried

πŸ“ Summary

Setup Steps (5-10 minutes):

  1. ⏱️ Screen timeout β†’ Maximum
  2. πŸ”Š Volume β†’ Maximum + DND OFF
  3. 🌐 Internet β†’ Test with YouTube/Browser
  4. πŸ“· Camera β†’ Grant permission
  5. 🌍 Timezone β†’ Set to the event country's timezone
  6. βœ… Test β†’ Login and scan

Using the App:

  1. πŸ” Login β†’ Enter username and password
  2. 🏒 Select Space β†’ Choose your working area
  3. πŸ“Έ Scan Badges β†’ Use camera or laser scanner
  4. πŸ”„ Monitor Sync β†’ Watch for sync completion
  5. πŸ“Š Check Stats β†’ View today's scans and totals
  6. πŸ“€ Export Data β†’ Tap the email icon to send reports to organizer

Time Required: 5-10 minutes setup + 10 minutes learning
Result: Smooth, uninterrupted badge scanning!


Document Version: 1.0

Last Updated: 24-11-2025

πŸ’‘ Remember: Taking 5-10 minutes to set up properly saves hours of troubleshooting during events!