QTick - Smart QR Attendance Tracking 📱

QTick is a modern, intuitive QR code-based attendance tracking application built with Flutter. Designed for educational institutions, workplaces, and events, QTick provides a seamless way to track attendance with QR code scanning technology.

✨ Features

🎯 Core Functionality

• QR Code Scanning: Fast and accurate QR code detection using the device's camera
• Dual Mode Tracking: Support for both arrival and departure attendance
• Real-time Processing: Instant attendance recording with immediate feedback
• Offline Only: Works without internet connection. Currently no online features exist in the app.

🎨 User Experience

• Modern UI Design: Clean, intuitive interface with smooth animations
• Audio Feedback: Success and error sounds for better user interaction
• Visual Feedback: Lottie animations for enhanced user experience
• Responsive Design: Optimized for both phones and tablets

📊 Data Management

• Local Database: SQLite database for reliable data storage
• Export Functionality: Export attendance data to CSV format
• Admin Panel: Comprehensive view and management of attendance records

⚙️ Advanced Features

• Customizable Settings: Personalize app behavior and preferences
• Battery Monitoring: Built-in battery status indicator
• Update System: In-app update notifications and management
• Permission Handling: Camera permission management
• Debug Tools: Advanced debugging and troubleshooting options(only in debug mode)

🚀 Getting Started

System Requirements

• Android: 7.0 (API level 24) or higher
• RAM: Minimum 1GB recommended
• Storage: App size around 5-15MB depending on device. Data may take another 10-15MB.
• Camera: Currently only front camera. Other camera/rear camera may work if there is no front camera.
• Permissions: Camera access required for QR scanning

Installation

Option 1: Play Store (Recommended)

https://play.google.com/store/apps/details?id=com.aadishsamir.qr_attendance

Option 2: Build from Source

# Clone the repository
git clone https://github.com/aadishsamir123/asdev-qtick.git
cd qr_attendance

# Install dependencies
flutter pub get

# Run the app
flutter run

📋 How to Use

Basic Usage

1. Launch the App: Open QTick from your app drawer
2. Choose Mode: Select "Arrival" or "Departure"
3. Scan QR Code: Point camera at the QR code
4. Confirm: Wait for audio/visual confirmation
5. View Records: Access admin panel to view all records

Admin Functions

• View All Records: See complete attendance history
• Export Data: Generate CSV reports
• Delete Records: Remove individual entries
• Manage Settings: Customize app behavior

🛠️ Built With

• Flutter - Cross-platform UI framework
• SQLite - Local database storage
• Mobile Scanner - QR code scanning
• Lottie - Smooth animations
• Provider - State management
• AudioPlayers - Audio feedback

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

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

📄 License

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

📞 Support

• Email: [email protected]
• Issues: GitHub Issues

🎉 Acknowledgments

• Contributors and beta testers
• Open source community for the packages used

---

Made with ❤️ by Aadish Samir

⭐ Star this repo if you find it helpful!