Mobile SDK Integration

The Easyteam React Native SDK enables you to add comprehensive workforce management features into your mobile application.

Installation

Prerequisites

Install the two React Native libraries react-native-safe-area-context and react-native-url-polyfill

Add the following import at the top of your entry-point file, the polyfill will be automatically applied:

Access npm

Set up access to our private npm registry:

Your Easyteam integration manager will provide you with the required NPM_TOKEN

Authentication

Follow the Authentication Guide to generate a valid JWT. The SDK's components handle all subsequent authentication and server communication.

Basic Initialization

Wrap your application with the EasyTeamProvider:

💡

The provider needs fresh data on every initialization and every time data changes - Easyteam does not store any PII (Personally Identifiable Information). Read more.

Parameters

Property	Type	Required	Description
`jwt`	`string`	Yes	Authentication token for the session. See Authentication docs.
`employees`	`Array<Employee>`	Yes	Employee data (IDs, names, roles, locations). No PII is stored. See Passing Data docs.
`locations`	`Array<Location>`	No	List of work locations. Used to define organizational structure.
`organization`	`Organization`	No	Metadata about the company using the platform.
`roles`	`Array<Role>`	No	Custom permission structures to apply to users. See Passing Data.
`theme`	`object`	No	UI customization object. See Theme Configuration docs.
`fonts`	`object`	No	Custom fonts mapping, e.g. `regular, bold, semiBold`.
`baseURL`	`string`	No	The iframe source base URL (e.g., Easyteam sandbox or production endpoint).
`apiBaseURL`	`string`	No	Base URL for API calls (matches the iframe base or separate endpoint).
`onEvent`	`(event: Event) => void`	No	Callback for user actions like clock-in, break start, or export.

Available Components

Easyteam's SDK includes ready-to-use components for key workforce management functionalities:

Time Clock - Employee clock-in/out interface

Timesheet - Individual and team time tracking reports

Settings - Workforce management configuration

For detailed implementation of each component, see our React Native Components Reference.

Examples

Time Clock Implementation

Employee Timesheet

Next Steps

Review the complete React Native Components Reference

Set up Authentication

Test your integration using the Sandbox Environment

💡

Need help with mobile integration? Contact our support team for implementation guidance.

Installation#

Prerequisites#

Access npm#

Authentication#

Basic Initialization#

Parameters#

Available Components#

Examples#

Time Clock Implementation#

Employee Timesheet#

Next Steps#