What is Incidents App?
Incidents App is a comprehensive hotel incident management system designed to streamline communication between guests, staff, and administrators. Built with modern technologies including React Native, Next.js, and Supabase, it provides a seamless experience across mobile and web platforms.The Problem
Traditional hotel incident reporting often involves:- Phone calls to the front desk
- Paper-based work orders
- Delayed communication between departments
- Lack of visibility into incident status
- Manual tracking and reporting
The Solution
Incidents App modernizes this workflow with:QR Code Integration
Guests scan a QR code in their room to instantly report incidents
Real-Time Tracking
All stakeholders see incident status updates instantly via Supabase
Role-Based Access
Custom interfaces for guests, employees, and administrators
Mobile-First Design
Staff can manage incidents from anywhere on the property
How It Works
Guest Reports Incident
A guest scans the QR code in their room and fills out a simple form describing the issue with priority level
Staff Receives Notification
The appropriate department receives a push notification with incident details
Technology Stack
Incidents App is built with modern, production-ready technologies:Mobile App
- React Native 0.81 - Cross-platform mobile framework
- Expo 54 - Development platform and build service
- Expo Router 6 - File-based navigation
- Supabase - Backend and real-time database
- TypeScript - Type-safe development
Web Dashboard
- Next.js 16 - React framework with App Router
- React 19 - Latest React features
- Supabase SSR - Server-side auth and data fetching
- Tailwind CSS 4 - Utility-first styling
- shadcn/ui - Component library
Backend
- Supabase - PostgreSQL database, authentication, and real-time subscriptions
- Expo Secure Store - Encrypted credential storage on mobile
- Row Level Security - Database-level authorization
Key Features
For Guests
- Scan QR code to identify room automatically
- Report incidents with priority levels
- Track incident status in real-time
- Simple, intuitive interface
For Employees
- View assigned incidents in personal task list
- Access “buzon” (inbox) of unassigned incidents by area
- Resolve incidents with notes
- Receive push notifications
For Administrators
- Create and manage guest check-in sessions
- Manage user accounts and permissions
- View analytics and incident metrics
- Generate QR codes for rooms
- Monitor all incidents across the property
Use Cases
Guest Room Maintenance
Guest Room Maintenance
A guest notices the air conditioning isn’t cooling properly. They scan the QR code, select “Alta” priority, choose “Climatización” area, and describe the issue. Maintenance staff receives an instant notification and resolves it within the hour.
Housekeeping Requests
Housekeeping Requests
A guest needs extra towels. They report a low-priority incident under “Housekeeping”. The housekeeping team sees it in their mobile app and delivers towels within minutes.
Facility Issues
Facility Issues
An employee notices a light out in the hallway. They open their employee app, create an incident for the maintenance area, and facilities staff is automatically notified.
Operations Analytics
Operations Analytics
Hotel management reviews the web dashboard analytics to identify recurring issues, measure response times, and optimize staffing for each department.
Next Steps
Quick Start
Set up your development environment and run the app
Architecture
Understand the system architecture and data flow
Mobile App Guide
Learn about the React Native mobile application
Web Dashboard
Explore the Next.js admin dashboard