Skip to content

About

Flutter attendance application demonstrating cross-platform UI, state handling and tested mobile workflows.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Attendance Management Flutter App

Cross-platform Flutter attendance app scaffold for Android and iOS.

Included

  • Animated splash screen inspired by the original attendance app flow
  • Employee login screen
  • Dashboard with today's shift, punch status, monthly summary, salary and updates
  • Punch attendance screen with animated face scanner, location, mock-location and integrity validation states
  • Attendance history
  • Leave request and approval tracking
  • Complaint/ticket creation and tracking
  • Profile, roster, PDF/admin/policy module shortcuts
  • Android permissions for internet, camera, location, notifications and microphone
  • iOS privacy descriptions for camera, Face ID, location and microphone
  • Live AmsAttendanceApi plus explicit demo-only MockAttendanceApi
  • Setup docs and one-command setup script

Quick Setup

cd attendance_app
./scripts/setup.sh

Manual commands:

flutter pub get
flutter analyze
flutter test
flutter build apk --debug
flutter run

Project Files

  • App entry point: lib/main.dart
  • App modules: lib/src/
  • Android permissions: android/app/src/main/AndroidManifest.xml
  • iOS privacy permissions: ios/Runner/Info.plist
  • API integration guide: docs/API_SETUP.md
  • Runbook: docs/RUNBOOK.md
  • Environment sample: .env.example
  • Setup script: scripts/setup.sh

API Integration

The app calls the live NHM endpoints by default. It does not silently replace failed live requests with demo users.

The backend requires a valid Firebase App Check token. The Firebase project owner must register this app's package/bundle and signing credentials before real user login can succeed. See docs/API_SETUP.md.

Verified

flutter analyze
flutter test
flutter build apk --debug

Android debug APK output:

build/app/outputs/flutter-apk/app-debug.apk

iOS Note

The iOS project is generated and configured, but local build verification needs the matching Xcode iOS platform installed. On this machine, Xcode reported that iOS 26.5 is not installed.

About

Flutter attendance application demonstrating cross-platform UI, state handling and tested mobile workflows.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages