FaceAttend is a comprehensive Flutter-based attendance management system that leverages AI-powered face recognition technology to automate student attendance tracking. The application provides both traditional manual attendance methods and cutting-edge facial recognition capabilities.

• AI-Powered Face Recognition: Real-time face detection and student identification
• Manual Attendance: Traditional tap-to-mark attendance system
• Multi-Platform Support: Android, iOS, Web, and Desktop compatibility
• Real-time Data Sync: Firebase Cloud Firestore integration
• User Authentication: Secure login/registration with Firebase Auth
• Attendance Reports: Comprehensive reporting and analytics
• Student Management: Complete student data management
• Document Generation: Export attendance data to Word documents

• Welcome Screen: App introduction and navigation
• Authentication: Login, Registration, and Password Recovery
• Dashboard: Main navigation hub with bottom navigation
• Home: Overview and quick access to features
• Attendance: Face recognition and manual attendance marking
• Reports: Attendance analytics and data visualization
• Profile: User profile management
• Student Data: Student information management

Screenshots would be added here showing the main app interface

• Flutter: Cross-platform mobile development framework
• Dart: Programming language
• GetX: State management and navigation
• Material Design: UI/UX framework

• Firebase Authentication: User authentication and authorization
• Cloud Firestore: NoSQL database for real-time data
• Firebase Dynamic Links: Deep linking capabilities

• TensorFlow Lite: On-device face recognition model (mobilefacenet.tflite)
• Camera Integration: Real-time camera feed processing
• Face Detection: Advanced facial feature recognition

• fl_chart: Data visualization and charts
• table_calendar: Calendar widget for date selection
• image_picker: Image capture and selection
• docx_template: Document generation
• webview_flutter: WebView integration for face recognition
• permission_handler: Device permissions management

Before running this application, ensure you have:

• Flutter SDK (3.5.4 or higher)
• Dart SDK (included with Flutter)
• Android Studio or VS Code with Flutter extensions
• Firebase Project with Authentication and Firestore enabled
• Node.js (for face recognition server - optional)

git clone <repository-url> cd FaceAttend

flutter pub get

1. Download google-services.json from your Firebase project
2. Place it in android/app/google-services.json
3. Ensure Firebase project has Authentication and Firestore enabled

1. Download GoogleService-Info.plist from your Firebase project
2. Add it to your iOS project in Xcode
3. Configure Firebase for iOS in your project

If you want to use the advanced face recognition features:

# Install Node.js dependencies npm install # Start the face recognition server npm start

The server will run on http://localhost:3000

# For Android flutter run # For iOS flutter run -d ios # For Web flutter run -d web

lib/ ├── main.dart # App entry point ├── firebase_options.dart # Firebase configuration └── src/ ├── user/ # User-facing features │ ├── main_screen/ # Authentication screens │ │ ├── welcome.dart │ │ ├── login.dart │ │ ├── register.dart │ │ └── forgot_password.dart │ ├── dashboard/ # Main app dashboard │ │ ├── dashboard.dart # Bottom navigation │ │ └── list_screen/ # Feature screens │ │ ├── home/ # Home screen │ │ ├── attendance/ # Attendance management │ │ ├── report/ # Reports and analytics │ │ ├── profile/ # User profile │ │ └── student_data/ # Student management │ └── api_services/ # API service classes └── widgets/ # Reusable UI components ├── color_constant.dart ├── reusable_function.dart └── snackbar_utils.dart 

1. Login: Authenticate using email/password
2. Create Attendance: Set up attendance session with date and subject
3. Mark Attendance: Use face recognition or manual tap-to-mark
4. View Reports: Analyze attendance data and generate reports
5. Export Data: Generate Word documents with attendance records

1. Start Recognition: Tap the face recognition button
2. Camera Access: Grant camera permissions when prompted
3. Real-time Detection: View live camera feed with face detection
4. Automatic Marking: Students are automatically marked present when recognized
5. Manual Override: Option to manually mark students if recognition fails

• Firebase Authentication: Secure user authentication
• Role-based Access: Different access levels for users
• Data Encryption: Secure data transmission and storage
• Permission Management: Proper handling of device permissions

• Users: User profiles and authentication data
• Students: Student information and enrollment data
• Attendance: Attendance records with timestamps
• Subjects: Course and subject information
• Reports: Generated attendance reports

• Word Documents: Export attendance sheets as .docx files
• CSV Format: Structured data export for analysis
• PDF Reports: Formatted attendance reports

flutter build apk --release # or flutter build appbundle --release

flutter build ios --release

flutter build web --release

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

If you encounter any issues or have questions:

1. Check the Issues page
2. Create a new issue with detailed information
3. Contact the development team

• Multi-language support
• Advanced analytics dashboard
• Integration with school management systems
• Offline mode capabilities
• Enhanced face recognition accuracy
• Biometric authentication
• Push notifications for attendance alerts

Development Team

• Email: [your-email@domain.com]
• Project Link: [https://github.com/your-repo/FaceAttend]

Made with ❤️ using Flutter