Inspector by VieTicket

Important

This project is no longer maintained. It may contain outdated information and security risks due to potential vulnerabilities in its dependencies.

A streamlined e-ticket inspection Progressive Web App (PWA) built with React, designed to make event check-ins quick and efficient.

Key Features • Demo • How To Use • Why Inspector by Vieticket? • Technical highlights • Credits • License

Key Features

• Seamless QR Code Scanning: Instantly check in attendees by scanning their QR code tickets. If scanning fails, manual ticket number entry is supported.
• Informative Ticket Details: Clearly displays ticket validity status and relevant attendee information.
• Light/Dark Mode: Choose your preferred visual theme, with an option to match your system's settings.
• Fast load time: The app opens instantly, thanks to its PWA architecture.

Demo

Go to https://inspect.vieticket.io.vn/ to see the app in action. This demo runs fully on the client side with no real API calls, so you can test it without any server setup. Please refer to the guide on the demo page for more information. Source code for the demo is available in the live-demo branch.

How To Use

1. Prerequisites: Ensure you have Git and Node.js installed.
2. Clone & Install:

   git clone [https://github.com/isoamyl50/vieticket-inspector-pwa.git](https://github.com/isoamyl50/vieticket-inspector-pwa.git)
   cd vieticket-inspector-pwa
   npm install

3. Environment Setup:
   • Create a .env file in the project root.
   • Add your API URL: VITE_APP_API_BASE_URL=<API_URL>
4. Run:

   npm start

Why Inspector by VieTicket?

• Speed: Focuses on fast, reliable ticket validation to keep lines moving.
• Simplicity: Intuitive interface minimizes training time for staff.
• Flexibility: Works on various devices.

Technical Highlights

• Built with React for a modern, component-based approach.
• Leverages the power of PWAs for offline functionality and app-like experience.
• Utilizes libraries like nimiq/qr-scanner for optimized QR code handling.

Credits

This software uses the following open source packages and projects:

• TypeScript
• React
• Node.js
• nimiq/qr-scanner
• SurajanShrestha/qr-scanner-in-react
• workbox
• Vite
• PWA Plugin for Vite
• react-bootstrap

and more.

License

MIT

---

GitHub @isoamyl50