luridarmawan / beetlehr-mobile

The open source HR system

---

Features

• Attendance System
• Employee Management
• Resign Management
• Leave Management
• Notice board
• Multi Approval System
• Payroll

Table Of Content

1. Getting Started
2. Mobile App Demo
3. Flavor Type
4. Building App
5. Structure Module
6. Detail Structure Item Feature Module

Getting Started

1. Clone this repo
2. Getting packages with running flutter pub get
3. Register app to your firebase account (https://firebase.flutter.dev/docs/manual-installation/android)
4. Run/Debug with Flavor

Mobile App Demo

Android: https://play.google.com/store/apps/details?id=io.qerja.mobile
iOS: https://apps.apple.com/id/app/qerja-io/id1614218184

Flavor Type

Dev

Run in dev mode:

flutter run -t lib/main_dev.dart --flavor dev

 git fetch --prune

STAGING

Run in staging mode:

flutter run -t lib/main_staging.dart --flavor staging

PROD

This flavor only for Production. Don't test in this flavor.

Run in prod mode:

flutter run -t lib/main_prod.dart --flavor prod

Building App

Requirement

1. Dart SDK Versions : >=2.12.0 <3.0.0 (recommand 2.16.2)
2. Flutter versions : >2.0.0 (recommand 2.10.15)

Android

For build APK

flutter build apk -t lib/main_prod.dart --flavor prod

For build AppBundle

flutter build appbundle -t lib/main_prod.dart --flavor prod

IOS

flutter build ipa -t lib/main_prod.dart --flavor prod

Structure Modules

Shared Module Module

Module	Description
core	Basic common
dependencies	Global Dependencies
l10n	Translation & Localization
component	Component App
preferences	All Prefences style app (Theme, Color, Dimens, Fonts, etc)
routes	Routing screen module

Feature Module

Module	Description
auth	Authentication Module (Login, Register, Logout, Reset)
home	Home Features
profile	Profile Page, Edit Profile, View Profile, etc..
apps	List mini apps features
notice	Notification, alert, etc..
settings	Setting preferences: theme, language, ...
attendance	Attendance module clock in, clock out, ...
payroll	Payroll list, salary slip, ...

Detail Structure Item Module Feature

Generate Icon Launcher

All launcher icon configurations are in the flutter_launcher_icons-*.yaml file, and to generate use the following command:

flutter pub run flutter_launcher_icons:main -f flutter_launcher_icons*

Note: Only for IOS