OrangeHRM Open Source Mobile Application

OrangeHRM is a comprehensive Human Resource Management (HRM) System that captures all the essential functionalities required for any enterprise. Copyright (C) 2006 OrangeHRM Inc., http://www.orangehrm.com/

OrangeHRM is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

OrangeHRM is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

How to setup development environment

Prerequisites

• React Native development environment
• Yarn
• JDK 17

Check whether the environment is ready

npx react-native doctor

Install dependancies

yarn install

Start dev server

yarn start

Run on Android device or emulator

Start emulator or connect device before run below command

yarn run android

Run on iOS device

cd ios
pod install
yarn run ios

Testing

# run full test suite
yarn test

# run only specific test case
yarn test -- --t "<describe> <test>"
# e.g.
yarn test -- --t "lib/helpers/attendance calculateDurationBasedOnTimezone"

Linting

yarn run lint

Prettier

yarn prettier src --write
# or
yarn run format

Release versions

Use one of the following commands to increase the version in package.json

yarn version --no-git-tag-version --minor
# or
yarn version --no-git-tag-version --patch

And run following node scripts to sync package.json version to Android project and iOS project.

node ./scripts/sync-version.js
node ./scripts/increment-build-number.js

Run git diff and review changes before commit version changes.