Mobile App Guide
Install and use DojoMaster as a Progressive Web App (PWA) on your mobile device for a native app-like experience with offline support and home screen access.
1. Overview
DojoMaster is built as a Progressive Web App (PWA), which means you can install it on your mobile device and use it just like a native app from the App Store or Google Play. The PWA provides a fast, reliable, and engaging mobile experience with offline support and home screen access.
Key Features
- •Install to Home Screen: Add DojoMaster to your device's home screen for quick access
- •Native App Experience: Full-screen mode without browser UI for an immersive experience
- •Offline Support: Access key features even without an internet connection
- •Fast Performance: Optimized loading and smooth animations for mobile devices
- •Mobile-First Design: Responsive interface optimized for touch interactions
- •Bottom Navigation: Easy-to-reach navigation bar at the bottom of the screen
- •Dark Mode Support: Automatic theme switching based on system preferences
- •No App Store Required: Install directly from your browser without downloading from app stores
2. Prerequisites
Before installing the DojoMaster mobile app, ensure you have:
- •A compatible mobile device (iOS 11.3+ or Android 5.0+)
- •A modern web browser (Safari on iOS, Chrome on Android)
- •An active DojoMaster account
- •Internet connection for initial installation (offline features work after installation)
3. Installing on iOS (iPhone/iPad)
Follow these steps to install DojoMaster on your iPhone or iPad:
- 1.Open Safari Browser
Launch Safari on your iOS device (PWA installation only works in Safari on iOS)
- 2.Navigate to DojoMaster
Go to your DojoMaster URL (e.g., https://dojomaster.app) and sign in to your account
- 3.Tap the Share Button
Tap the Share icon (square with an arrow pointing up) at the bottom of the Safari browser
- 4.Select "Add to Home Screen"
Scroll down in the share menu and tap "Add to Home Screen"
- 5.Customize the Name (Optional)
You can edit the app name if desired (default is "DojoMaster")
- 6.Tap "Add"
Tap "Add" in the top-right corner to complete the installation
- 7.Launch the App
Find the DojoMaster icon on your home screen and tap it to launch the app
iOS Tip
The DojoMaster app will open in full-screen mode without the Safari browser UI, providing a native app-like experience. You can switch between apps using the standard iOS app switcher.
4. Installing on Android
Follow these steps to install DojoMaster on your Android device:
- 1.Open Chrome Browser
Launch Google Chrome on your Android device (recommended for best PWA support)
- 2.Navigate to DojoMaster
Go to your DojoMaster URL (e.g., https://dojomaster.app) and sign in to your account
- 3.Look for the Install Prompt
Chrome will automatically show an "Add to Home screen" banner at the bottom of the screen
- 4.Tap "Add to Home screen" or "Install"
Tap the prompt to begin installation. If you don't see the prompt, tap the menu (three dots) and select "Add to Home screen"
- 5.Confirm Installation
Tap "Add" or "Install" in the confirmation dialog
- 6.Launch the App
Find the DojoMaster icon on your home screen or app drawer and tap it to launch
Android Tip
Once installed, DojoMaster will appear in your app drawer alongside other apps. You can also find it in your device's Settings → Apps list, where you can manage permissions and storage.
5. Using Mobile Features
DojoMaster's mobile app includes several features optimized for mobile devices:
📱 Mobile Bottom Navigation
The mobile app features a bottom navigation bar for easy thumb-reach access to key sections:
- • Dashboard - Quick overview of club activity
- • Students - Manage student profiles and progress
- • Classes - View and manage class schedules
- • Grading - Access grading events and results
- • Settings - Configure app preferences
👆 Touch-Optimized Interface
All interactive elements are sized for easy touch interaction:
- • Large tap targets (minimum 44x44 pixels)
- • Swipe gestures for navigation
- • Pull-to-refresh on list views
- • Touch-friendly form controls
🌙 Automatic Dark Mode
The app automatically switches between light and dark themes based on your device's system settings. You can also manually toggle the theme using the theme switcher in the app.
📡 Offline Support
Access key features even without an internet connection:
- • View previously loaded student profiles
- • Access cached class schedules
- • Review grading history
- • Changes sync automatically when you're back online
⚡ Fast Performance
Optimized for mobile devices with:
- • Sub-3-second load times
- • Smooth 60fps animations
- • Optimized images (AVIF/WebP formats)
- • Efficient data caching
6. Managing the App
Learn how to manage the DojoMaster app on your mobile device.
Updating the App
Unlike traditional apps, PWAs update automatically:
- •Updates are downloaded automatically when you open the app
- •No manual updates required from app stores
- •Always running the latest version with newest features and security updates
- •Refresh the app if you notice any issues after an update
Clearing App Data
If you experience issues, you can clear the app's cached data:
On iOS:
- 1. Go to Settings → Safari → Advanced → Website Data
- 2. Find DojoMaster in the list
- 3. Swipe left and tap "Delete"
- 4. Relaunch the DojoMaster app
On Android:
- 1. Go to Settings → Apps → DojoMaster
- 2. Tap "Storage"
- 3. Tap "Clear Data" or "Clear Cache"
- 4. Relaunch the DojoMaster app
Uninstalling the App
To remove DojoMaster from your device:
On iOS:
- 1. Long-press the DojoMaster icon on your home screen
- 2. Tap "Remove App"
- 3. Tap "Delete App" to confirm
On Android:
- 1. Long-press the DojoMaster icon
- 2. Drag to "Uninstall" or tap "App info" → "Uninstall"
- 3. Confirm the uninstallation
7. Common Pitfalls and Troubleshooting
Here are solutions to common issues users encounter with the mobile app.
Issue 1: Can't find the "Add to Home Screen" option
Symptoms: The installation option doesn't appear in your browser.
Solutions:
- •iOS: Make sure you're using Safari browser (not Chrome or other browsers)
- •Android: Use Chrome browser for best PWA support
- •Ensure you're signed in to DojoMaster before attempting installation
- •Try refreshing the page and waiting a few seconds
- •Check that your browser is up to date
Issue 2: App opens in browser instead of standalone mode
Symptoms: The app shows browser UI (address bar, navigation buttons).
Solutions:
- •Make sure you're launching from the home screen icon, not a browser bookmark
- •Try uninstalling and reinstalling the app
- •On iOS, ensure you used Safari's "Add to Home Screen" feature
- •On Android, use the "Install" prompt from Chrome
Issue 3: App is slow or unresponsive
Symptoms: Pages load slowly or the app freezes.
Solutions:
- •Check your internet connection—slow connections affect performance
- •Clear the app's cached data (see Section 6)
- •Close other apps running in the background
- •Restart your device
- •Ensure your device has sufficient storage space
Issue 4: Offline features don't work
Symptoms: Can't access any content when offline.
Solutions:
- •Offline features only work for previously loaded content
- •Make sure you've accessed the content while online first
- •The app needs to be installed as a PWA for offline support
- •Some features require an internet connection (e.g., creating new records)
- •Clear cache and reload content while online
Issue 5: Bottom navigation bar is missing
Symptoms: Can't see the mobile navigation bar at the bottom.
Solutions:
- •The bottom navigation only appears on mobile devices (screens under 1024px)
- •On tablets in landscape mode, you may see the sidebar instead
- •Try rotating your device to portrait orientation
- •Refresh the app if the navigation doesn't appear
Issue 6: Dark mode doesn't work correctly
Symptoms: Theme doesn't match system settings or won't change.
Solutions:
- •Check your device's system theme settings
- •Use the theme toggle in the app to manually switch themes
- •Clear the app's cached data and reload
- •The app stores theme preference in local storage—clearing data resets it
Issue 7: App icon doesn't appear on home screen
Symptoms: Installation seems successful but no icon appears.
Solutions:
- •Check other home screen pages—the icon may have been added to a different page
- •On Android, check the app drawer
- •Try the installation process again
- •Restart your device and check again
Issue 8: Changes don't sync after going back online
Symptoms: Data entered offline doesn't appear after reconnecting.
Solutions:
- •Most write operations require an internet connection
- •Offline mode is primarily for viewing previously loaded content
- •Try refreshing the app after reconnecting
- •Check for any error messages that may have appeared
- •Re-enter the data while online if it didn't sync
8. Related Features
Explore these related features to get the most out of DojoMaster on mobile:
📊 Dashboard Overview
Learn how to use the mobile-optimized dashboard for quick insights
📱 Kiosk Mode
Set up a dedicated tablet for student check-ins
✅ Attendance Tracking
Mark attendance on the go with mobile-friendly controls
📈 Student Progress Tracking
View and update student progress from your mobile device
📅 Class Scheduling
Manage class schedules with mobile-responsive calendar views
🔔 Notifications
Stay informed with mobile push notifications
👨👩👧👦 Parent Portal
Parents can access student information on their mobile devices
🔐 User Roles & Permissions
Understand mobile access levels for different user roles
9. Next Steps
Now that you've installed the DojoMaster mobile app, here's what to do next:
- 1.Explore the Mobile Interface
Familiarize yourself with the mobile bottom navigation and touch-optimized controls
- 2.Configure Notifications
Set up mobile push notifications to stay informed about club activities
- 3.Test Offline Features
Load key content while online, then test offline access to ensure it works as expected
- 4.Customize Your Theme
Choose between light and dark mode based on your preference and lighting conditions
- 5.Set Up Kiosk Mode (Optional)
If you have a dedicated tablet, configure kiosk mode for student check-ins
- 6.Share with Your Team
Help other instructors and staff install the mobile app for consistent access across your team
Pro Tip
The mobile app automatically updates in the background, so you'll always have the latest features and security improvements without needing to manually update from an app store. Just refresh the app if you notice any issues after an update.