How iotile/iotile-companion-mobile-app works
IOTile-M is a hybrid Ionic mobile app for customers to interact with IOTile devices and the IOTile.cloud Dashboard. The main workflow takes a user through app navigation and project/device screens, where they can discover devices, collect device data, and synchronize project information; report handling and upload support that workflow. Other major branches include account access, firmware updates, device-specific pages and settings, and local persistence. The graph uses sampled source and README statements; unsampled features are grouped at their existing directories, and unverified links are omitted.
Main entry points: main.ts Main module · active-project-ctrl.ts Project screens · controllers Device interaction · report-serv.ts Report handling
Components 23
App shell
- App entry
app/app.ts - Main module
app/main/main.ts - Navigation and routes
app/main/main.route.ts - Startup and session guard
app/main/main.run.ts
Projects and devices
- Account access
app/main/controllers - Project screens
app/main/controllers/active-project-ctrl.ts - Project setup
app/main/controllers/setup-claim-ctrl.ts - Device interaction
app/main/pages/controllers - Device notes
app/main/controllers/modals/note-modal.ts
Device and data services
- Device abstraction
app/packages/ng-iotile-app/classes/device-base.ts - IOTile adapter
app/main/main.ts - Firmware updates
app/packages/ng-iotile-app/firmware/firmware-serv.ts - Report handling
app/packages/ng-iotile-app/report-serv.ts - Device data upload
app/packages/ng-iotile-app/uploader-service.ts - Project and device cache
app/packages/ng-iotile-app/cache-serve.ts - Local filesystem
app/packages/ng-iotile-app/filesystem-serv.ts
Device features
- Device settings
app/main/pages/controllers/settings - Device widgets
app/main/directives/widgets - Geolocation
app/main/controllers/device-geolocate-ctrl.ts - WebSocket server
app/packages/ng-iotile-app/classes/websocket-server.ts
Other components
- Customer
- IOTile.cloud
- IOTile devices
Connections 22
- Customer → App entry: uses
- App entry → Main module: loads
app/app.ts - Main module → Navigation and routes: imports
app/main/main.ts - Main module → Startup and session guard: imports
app/main/main.ts - Main module → IOTile adapter: registers
app/main/main.ts - Startup and session guard → Account access: guards access
app/main/main.run.ts - Customer → Project screens: uses
- Project screens → IOTile devices: scans
app/main/controllers/active-project-ctrl.ts - Project screens → IOTile.cloud: syncs project
app/main/controllers/active-project-ctrl.ts - Project setup → IOTile.cloud: sets up project
- Device notes → IOTile.cloud: posts note
app/main/controllers/modals/note-modal.ts - Device notes → Geolocation: captures location
app/main/controllers/modals/note-modal.ts - Device abstraction → Project and device cache: uses
app/packages/ng-iotile-app/classes/device-base.ts - Device abstraction → Report handling: uses
app/packages/ng-iotile-app/classes/device-base.ts - Firmware updates → Local filesystem: reads and writes
app/packages/ng-iotile-app/firmware/firmware-serv.ts - Report handling → Local filesystem: reads and writes
app/packages/ng-iotile-app/report-serv.ts - Device data upload → Report handling: uses reports
app/packages/ng-iotile-app/uploader-service.ts - Device data upload → Project and device cache: uses cache
app/packages/ng-iotile-app/uploader-service.ts - Customer → Device interaction: uses
- Device interaction → Device settings: configures
- Device interaction → Device widgets: views
- IOTile adapter → IOTile devices: connects