evento is a Progressive Web App (PWA) that digitizes university event attendance, replacing slow pen-and-paper methods with a faster, more efficient solution.

Features

• Progressive Web App (PWA): Installable on any device, providing a seamless user experience similar to native apps.
• QR Code Scanning: Quickly scan student ID QR codes to log attendance instantly.
• Real-Time Data: Immediate updates and data synchronization for accurate and up-to-date attendance records.
• User Roles and Permissions: Different access levels for main admin, secondary admin, and officers with restricted features to ensure security and proper data management.
• Responsive Design: Fully responsive design to ensure usability on any device, including desktops, tablets, and smartphones.

Read the Case Study here

https://www.danodoms.xyz/case-studies/evento

Screenshots

MONOREPO

Installation

To install and use Evento, follow these steps:

1. Clone the Repository:

   git clone https://github.com/domsdano/events-attendance.git

2. Navigate to the Project Directory:

   cd evento

3. Install Dependencies:

   npm install

4. Run the App:

   npm start

5. Build the App for Production:

   npm run build

6. Deploy the App: Follow your preferred method to deploy the built app to your web server or hosting service.

Usage

1. Login: Admins and officers log in using their credentials.
2. Scan QR Code: Use the built-in QR code scanner to scan student IDs for attendance.
3. View Attendance Records: Access and manage real-time attendance data.
4. Notifications: Receive alerts and notifications for attendance-related events.
5. User Management: Manage users and assign appropriate roles and permissions.

Technologies Used

• React: For building the user interface.
• Tailwind CSS: For styling the application.
• shadcn: For accessible components.
• Zustand: For state management.
• React Query: For data fetching and caching.
• Html5Qrcode: For QR code scanning.
• React Toastify: For notifications and alerts.
• TypeScript: For type safety and better developer experience.
• Framer Motion: For smooth animations and transitions.

Contributing

Contributions to improve Evento are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.

1. Fork the Repository:

   git fork https://github.com/domsdano/events-attendance.git

2. Create a New Branch:

   git checkout -b feature/your-feature-name

3. Commit Your Changes:

   git commit -m "Add your commit message"

4. Push to Your Branch:

   git push origin feature/your-feature-name

5. Open a Pull Request: Describe your changes and submit a pull request for review.