Getting Started with the Mobile App
Learn how to set up your Care Workers on the Maica Mobile App
This article explains the administrative setup required to get started on the Mobile App, prepare Care Workers, and ensure correct Permissions and Settings are in place for designed usage.
The setup is broken down into sections, please refer each section in more detail below.
Lightning App & Navigation
The Maica: Care Mobile Lightning app must be published to Care Worker profiles so that it appears in Salesforce Mobile navigation.
Hence, first add the Maica: Care Mobile Lightning app to the Profiles your Care Workers use (the Admin profile already has visibility enabled).
Note:
The Mobile App ships with a single Home tab that launches the Planner experience.
The Home flexipage embeds the
Maica: Planner
Aura component, which hosts the Planner LWC.
No further component setup is required once the App has been assigned to users.
This configuration ensures the mobile app provides a direct, consistent entry point into the Planner experience.
Resource Preparation
Every Mobile User must be linked to an active Resource record to enable mobile planner behaviour.
Resource linkage
Each User must be connected to an active Resource__c
record via the User__c
lookup field.
Active flag
The Active__c
field must be set to TRUE.
Primary Experience
This can be left blank. Then, the User experience will become contextual, meaning, if a User is on a Mobile then Mobile Experience will be applied & if they are on Desktop the Desktop Primary Experience will be used. Note: if you set a value the, UX will be applicable to any devices
Planner & Global Settings
The Planner service relies on configuration values stored in the Maica Setting records, it is important that:
You ensure your Maica Maps Settings records stay up to date (Google API Key) to allow Google related processes (such as Travel Calculations) to run.
Additionally, populate the Support Phone and Email fields in the Maica General Settings to allow the Support button to display for Care Workers.
Other than the above listed, no additional action is required as when a user qualifies as a Mobile Worker:
The planner automatically loads in Agenda view. The planner component forces the Agenda View and calendar mode whenever the logged-in Resource’s Primary Experience equals
Mobile
, while keeping other views for desktop-first users.
Minimum Permission Sets (Object-Focused)
Each Maica Care Mobile user requires specific Permission Sets or Permission Set Groups to use the minimum required functionality of the Mobile App. These are:
Maica – Base & Object Permissions
Baseline access to core Maica components.
Maica – Planner – Planner Access & Object Permissions
Grants access to the Planner tab and read rights to Appointments, Resources, Schedules, and Unavailability.
Maica – Global – View Appointment & Object Permissions
Allows reading appointment modals and related schedule/service data.
Maica – Global – View Shift & Object Permissions
Grants equivalent access for Shifts so workers can open shift records in the planner.
Maica – Planner – Manage Appointment – Check In/Out & Object Permissions
Enables the Check In/Out actions and provides Timesheet and Timesheet Entry access.
Maica – Planner – Manage Shift – Check In/Out & Object Permissions
Required if staff check in/out of Shifts rather than Appointments.
These groups provide the baseline object-level permissions required for:
Viewing planner content.
Interacting with Appointments and Shifts.
Additional functional permissions — such as creating appointments, managing unavailability, or appointment/shift actions — can be assigned as required. To learn more about additional permissions, click here.
Validate the Experience
If you wish to test the above experience before issuing it out to your Care Workers, please follow the steps below:
Log in as a templated Care Worker whose an active Resource, and set to Primary Experience = Mobile.
Open the Maica: Care Mobile app in Salesforce mobile; the Planner Home tab should load automatically, reflecting the new mobile-first experience.
Switch the Resource to Primary Experience = Desktop and confirm they still see the multi-view Desktop Planner when using the standard Salesforce App on Mobile.
Following these steps ensures Care Workers receive the tailored workflow in the Care Mobile app while Administrators retain full control over who uses the Mobile or Desktop scheduling interfaces.
Summary
To deploy the Maica Care Mobile App successfully:
Publish the Maica: Care Mobile app to worker profiles.
Verify every user has an active
Resource__c
record withPrimary Experience = Mobile
.Maintain Maica Setting records for Planner and General Settings.
Assign the listed permission set groups to ensure planner and attendance access.
Once configured, the mobile planner automatically adapts for care workers, delivering an optimised experience with Agenda view, swipe-ready quick actions, and compact layouts.
Last updated
Was this helpful?