Platforms
Product Lines
Platforms Safecrete Safewall Mine Operating System (Coming Soon)
© 2026 IndustryOS
On this page

Dashboard access

The IndustryOS Mobile Application provides full access to IndustryOS dashboards optimised for mobile devices, enabling users to monitor and control their IoT infrastructure whilst on the move.

Overview

Mobile dashboard access allows users to:

  • View Dashboards: Access all dashboards configured in IndustryOS
  • Interact with Widgets: Use interactive widgets (charts, controls, maps, etc.)
  • Real-Time Updates: Receive live telemetry updates via WebSocket
  • Responsive Layout: Automatic layout adjustments for mobile screens
  • Offline Access: View cached dashboards when offline (limited functionality)

Accessing Dashboards

Default Dashboard

When users log in to the mobile app, they are presented with a default dashboard configured in Mobile Centre:

  1. Log in to IndustryOS as System Administrator
  2. Navigate to Mobile Centre → Applications
  3. Select your mobile application
  4. Click Edit (pencil icon)
  5. Set Default Dashboard to your preferred dashboard
  6. Click Save

The default dashboard is displayed immediately after user authentication.

Dashboard Navigation

Users can navigate between dashboards using:

  • Dashboard Menu: Hamburger menu (☰) shows all available dashboards
  • Dashboard States: Navigate through dashboard states using configured transitions
  • Entity Aliases: Click on entities to navigate to their detail dashboards
  • Mobile Actions: Use custom mobile actions for navigation

Dashboard Permissions

Dashboard visibility in the mobile app respects IndustryOS permissions:

  • User Role: Dashboards visible based on user’s assigned role
  • Customer Hierarchy: Tenant users see only their customer’s dashboards
  • Public Dashboards: Shared dashboards available to authorised users
  • Private Dashboards: Personal dashboards visible only to the owner

Supported Widget Types

The mobile app supports most IndustryOS widgets with mobile-optimised rendering:

Visualisation Widgets

  • Time-Series Charts: Line charts, bar charts, area charts
  • Latest Values: Current telemetry values with formatting
  • Gauges: Radial gauges, linear gauges, compass
  • Cards: Simple cards, HTML cards, entity cards
  • Maps: OpenStreetMap, Google Maps, Image Map
  • Tables: Entities table, alarms table, time-series table

Control Widgets

  • Knob Control: Rotary control for adjusting values
  • Slider: Horizontal slider for value input
  • Switch: Toggle switches for boolean attributes
  • Button: Action buttons for RPC calls or navigation
  • Input Widgets: Text input, number input, date picker
  • Entities Hierarchy: Tree view of entity relationships
  • Entity List: Scrollable list of devices, assets, or customers
  • Alarm List: Real-time alarm monitoring

Unsupported or Limited Widgets

Some widgets have limitations on mobile:

  • Complex HTML: Custom HTML widgets may not render correctly on small screens
  • External Iframes: Third-party embedded content may have compatibility issues
  • Large Data Tables: Tables with many columns may require horizontal scrolling

Mobile-Specific Features

Responsive Layout

Dashboards automatically adapt to mobile screen sizes:

  • Widget Resizing: Widgets resize to fit mobile screen width
  • Vertical Stacking: Widgets stack vertically for better scrolling
  • Touch Optimisation: Larger touch targets for buttons and controls
  • Portrait/Landscape: Layout adjusts based on device orientation

Touch Gestures

Mobile users can interact with dashboards using touch gestures:

  • Tap: Select widgets, click buttons, open entity details
  • Scroll: Navigate through dashboard content vertically
  • Pinch-to-Zoom: Zoom in/out on map widgets and images
  • Swipe: Navigate between dashboard states (if configured)
  • Long-Press: Show additional widget options or context menu

Real-Time Data Updates

Mobile dashboards receive real-time telemetry updates:

  • WebSocket Connection: Persistent connection for live data streaming
  • Automatic Reconnection: Reconnects after network disruptions
  • Subscription Management: Subscribes only to visible widgets’ data
  • Battery Optimisation: Reduces update frequency when app is backgrounded

Optimising Dashboards for Mobile

Layout Best Practices

Single Column Layout:

  • Design dashboards with a single column of widgets
  • Widgets stack vertically for natural mobile scrolling
  • Avoid multi-column layouts that require horizontal scrolling

Widget Sizing:

  • Use larger widgets that are easier to read on small screens
  • Minimum recommended widget height: 200px
  • Ensure text is readable without zooming (minimum 14px font size)

Limit Widget Count:

  • Use fewer widgets per dashboard (5-10 recommended)
  • Too many widgets increase load time and battery consumption
  • Use dashboard states or navigation to split content across multiple views

Mobile-Friendly Widgets

Choose widgets that work well on mobile devices:

Good for Mobile:

  • Latest value widgets (large, clear values)
  • Simplified charts (2-3 series max)
  • Card widgets with clear headings
  • Simple tables (3-4 columns max)
  • Control widgets with large touch targets

Avoid on Mobile:

  • Complex multi-series charts (hard to read)
  • Wide tables with many columns (requires scrolling)
  • Tiny gauges or indicators (too small to see)
  • Dense HTML content (hard to interact with)

Colour and Contrast

Ensure dashboards are readable in various lighting conditions:

  • High Contrast: Use sufficient contrast between text and background
  • Daylight Readable: Test dashboards in bright sunlight
  • Dark Mode: Consider dark theme for low-light environments
  • Colour Blindness: Use colour schemes accessible to colour-blind users

Creating Mobile-Specific Dashboards

Dedicated Mobile Dashboards

Create separate dashboards specifically for mobile users:

  1. Navigate to Dashboards → + to create a new dashboard
  2. Name it clearly (e.g., “Mobile - Overview Dashboard”)
  3. Design with mobile constraints in mind (single column, fewer widgets)
  4. Configure in Mobile Centre as the default mobile dashboard
  5. Assign appropriate permissions for mobile users

Dashboard States for Mobile

Use dashboard states to create multi-page mobile experiences:

Main State:

  • Overview with key metrics (temperature, status, alarms)
  • Navigation buttons to drill-down states

Detail States:

  • Entity-specific details (selected device, asset, customer)
  • Historical charts and telemetry
  • Control widgets for entity actions

Alarm State:

  • Alarm list filtered by severity
  • Alarm details and acknowledgement controls

Mobile Actions

Add mobile actions to enable advanced functionality:

  • Navigation: Navigate to other dashboards or external apps
  • RPC Calls: Trigger device commands or server-side actions
  • Scan QR Code: Launch device scanner for quick device access
  • Share: Share dashboard content or data via messaging apps

See Mobile Actions for configuration details.

Testing Mobile Dashboards

Browser Testing

Test dashboards on desktop browsers with mobile emulation:

  1. Open dashboard in Chrome or Firefox
  2. Open Developer Tools (F12)
  3. Toggle Device Toolbar (Ctrl+Shift+M)
  4. Select mobile device profile (iPhone, Pixel, etc.)
  5. Test responsiveness, layout, and interactions

Physical Device Testing

Always test on actual mobile devices:

  • Multiple Screen Sizes: Test on small (4”), medium (5-6”), and large (6.5+”) screens
  • Both Platforms: Test on both Android and iOS devices
  • Portrait and Landscape: Verify layout in both orientations
  • Different Network Conditions: Test on WiFi, 4G, and slow 3G connections

Performance Testing

Monitor dashboard performance on mobile:

  • Load Time: Dashboard should load in under 3 seconds
  • Frame Rate: Smooth scrolling at 60 FPS
  • Battery Usage: Monitor battery drain during extended use
  • Data Usage: Track network data consumption

Dashboard Caching and Offline Access

Automatic Caching

The mobile app automatically caches recently accessed dashboards:

  • Dashboard Configuration: Layout, widgets, and settings cached
  • Latest Data: Most recent telemetry values cached
  • Cache Duration: Cached data valid for 24 hours (configurable)
  • Cache Size: Limited by device storage (typically 50-100 MB)

Offline Behaviour

When the device is offline:

  • Cached Dashboards: Users can view previously loaded dashboards
  • Cached Data: Last known telemetry values displayed
  • No Real-Time Updates: Live data updates unavailable
  • Limited Interactions: Control widgets disabled (cannot send commands)
  • Offline Indicator: Visual indicator shows offline status

Data Synchronisation

When the device reconnects:

  1. Automatic Sync: App automatically reconnects to IndustryOS
  2. Data Refresh: Widgets refresh with latest telemetry
  3. Subscription Renewal: WebSocket subscriptions re-established
  4. Queued Actions: Pending actions (if any) executed

Troubleshooting

Dashboard Not Loading

Check Permissions:

  • Verify user has access to the dashboard
  • Check that the dashboard is assigned to the user’s customer

Check Network:

  • Ensure device has internet connectivity
  • Verify IndustryOS server is accessible
  • Check firewall rules allow mobile app traffic

Clear Cache:

  • Clear app cache in mobile app settings
  • Log out and log back in
  • Reinstall the app if issue persists

Widgets Not Updating

Check WebSocket Connection:

  • Verify WebSocket connection is established (check app logs)
  • Ensure firewall allows WebSocket traffic (port 443 or 80)

Check Data Sources:

  • Verify entities are sending telemetry
  • Check that widget datasources are correctly configured

Refresh Dashboard:

  • Pull down to refresh dashboard
  • Navigate away and return to the dashboard
  • Restart the app

Layout Issues

Widget Overlapping:

  • Dashboard layout may not be optimised for mobile
  • Create a dedicated mobile dashboard with single-column layout

Text Too Small:

  • Increase widget title and value font sizes
  • Use larger widgets for better readability

Horizontal Scrolling:

  • Reduce widget width to fit screen
  • Use mobile-friendly widget types

Performance Issues

Slow Loading:

  • Reduce number of widgets on dashboard
  • Simplify complex widgets (fewer chart series)
  • Optimise network connection

High Battery Drain:

  • Reduce real-time update frequency
  • Close unused dashboards
  • Disable background refresh when not needed

Best Practices Summary

Dashboard Design

  • Create dedicated mobile dashboards with single-column layouts
  • Use 5-10 widgets maximum per dashboard
  • Ensure text is readable (minimum 14px font size)
  • Test on multiple devices and screen sizes

Widget Selection

  • Choose mobile-friendly widget types (cards, gauges, simple charts)
  • Avoid complex tables and multi-series charts
  • Use large touch targets for controls (minimum 44x44 pixels)
  • Ensure high contrast between text and background

Performance

  • Limit number of real-time subscriptions
  • Use pagination for large data tables
  • Optimise image sizes for mobile
  • Monitor battery and data usage

User Experience

  • Set appropriate default dashboard in Mobile Centre
  • Use dashboard states for multi-page experiences
  • Add mobile actions for common tasks
  • Provide offline access to critical dashboards