Cross-platform Flutter attendance app scaffold for Android and iOS.
- 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
AmsAttendanceApiplus explicit demo-onlyMockAttendanceApi - Setup docs and one-command setup script
cd attendance_app
./scripts/setup.shManual commands:
flutter pub get
flutter analyze
flutter test
flutter build apk --debug
flutter run- 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
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.
flutter analyze
flutter test
flutter build apk --debugAndroid debug APK output:
build/app/outputs/flutter-apk/app-debug.apk
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.