Skip to content

Ranjesh2002/AttenQR_frontend

Repository files navigation

QR-Based Attendance System – Admin Dashboard

The mobile app for the QR-Based Attendance System allows students and teachers to interact with the system seamlessly. Students scan QR codes to mark attendance, while teachers can generate and manage classes.

🚀 Features

📷 QR Code Scanning – Scan dynamically generated QR codes for instant attendance marking. 🔐 User Authentication – Login/Sign-up with role-based access (Student/Teacher). 📊 Attendance History – View past attendance records. 🔔 Low Attendance Alerts – Get notified when attendance drops below a set threshold. 🌐 Real-time API Integration – Communicates with the Django backend hosted on Azure.

🛠️ Tech Stack

  • React Native (Expo) (Vite)
  • Tailwind CSS
  • Axios – For backend communication
  • React Navigation for routing
  • AsyncStorage for session management**
  • QR Scanner Library

⚙️ Setup Instructions (Local)

Prerequisites

  • Node.js >= 16.x
  • npm or yarn

1. Clone the Repository

git clone https://github.com/Ranjesh2002/AttenQR_frontend.git
cd frontend

2. Install Dependencies

npm install

3. Configure Environment Variables

  • Create a .env file in the project root:
VITE_API_BASE_URL=https://<your-backend-domain>/api

4. Start Development Server

npx expo start

Testing the App

  • Ensure the backend and admin panel are running and accessible.
  • Test scanning a QR code generated by the teacher dashboard.
  • Verify attendance history and notifications.

Security Notes

  • Never commit .env files.
  • Use HTTPS in production.
  • Validate all QR data before marking attendance.

Future Improvements

  • Offline QR scanning with sync on reconnect.
  • Dark mode
  • Push notifications for announcements.
  • Multi-language support.

Contributions

Feel free to fork the repo and submit pull requests to contribute.

License

This project is licensed under the MIT License.

Author

Ranjesh Thakur 3rd-year BSc. Computing student | Passionate about full-stack & mobile development

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors