How nguyenvantai12/vkuroombooking works
VKU Room Booking is a React Native app for finding study rooms, checking availability, reserving time slots, and managing bookings. Users browse and filter rooms, open room details, choose a date and conflict-free time range, review the reservation, then view or cancel bookings. Room data is served through a simulated service and cached with TanStack Query; filters and persisted bookings use Zustand. README capabilities include dynamic availability, conflict prevention, responsive browsing, and animated booking-list interactions. Some screen implementations were not excerpted, so their documented or indexed connections are shown only where supported.
Main entry points: useRooms.ts Room query and filters · useBookingStore.ts Booking state · BrowseRoomsScreen.tsx Browse rooms · BookingScreen.tsx Select time
Components 23
App navigation
- App entry
App.tsx - Root stack
src/navigation/RootStack.tsx - Main tabs
src/navigation/MainTabs.tsx
Room discovery
- Browse rooms
src/screens/BrowseRoomsScreen.tsx - Room details
src/screens/RoomDetailScreen.tsx - Room query and filters
src/hooks/useRooms.ts
Booking lifecycle
- Select time
src/screens/BookingScreen.tsx - Booking review
src/screens/BookingConfirmationScreen.tsx - My bookings
src/screens/MyBookingsScreen.tsx - Profile
src/screens/ProfileScreen.tsx
Data and state
- Query provider
src/providers/QueryProvider.tsx - Room service
src/services/roomService.ts - Room catalog
src/data/rooms.ts - Filter state
src/store/useFilterStore.ts - Booking state
src/store/useBookingStore.ts
Shared UI and logic
- Booking rules
src/utils/bookingUtils.ts - Date and time rules
src/utils/dateUtils.ts - Room cards and filters
src/components/RoomCard.tsx - Loading indicators
src/components/SkeletonLoader.tsx - Empty and error states
src/components/EmptyState.tsx - Design tokens
src/theme/index.ts
Other components
- Room seeker
- AsyncStorage
Connections 39
- Room seeker → App entry: opens
- App entry → Query provider: wraps
App.tsx - App entry → Root stack: renders
App.tsx - Root stack → Main tabs: routes to
src/navigation/RootStack.tsx - Root stack → Room details: routes to
src/navigation/RootStack.tsx - Root stack → Select time: routes to
src/navigation/RootStack.tsx - Root stack → Booking review: routes to
src/navigation/RootStack.tsx - Main tabs → Browse rooms: routes to
src/navigation/MainTabs.tsx - Main tabs → My bookings: routes to
src/navigation/MainTabs.tsx - Main tabs → Profile: routes to
src/navigation/MainTabs.tsx - Browse rooms → Room query and filters: queries rooms
src/screens/BrowseRoomsScreen.tsx - Browse rooms → Filter state: updates filters
src/screens/BrowseRoomsScreen.tsx - Browse rooms → Room cards and filters: renders
src/screens/BrowseRoomsScreen.tsx - Browse rooms → Loading indicators: renders
src/screens/BrowseRoomsScreen.tsx - Browse rooms → Empty and error states: renders
src/screens/BrowseRoomsScreen.tsx - Room details → Room query and filters: loads room
src/screens/RoomDetailScreen.tsx - Room details → Loading indicators: renders
src/screens/RoomDetailScreen.tsx - Select time → Room query and filters: loads room
src/screens/BookingScreen.tsx - Select time → Booking state: reads bookings
src/screens/BookingScreen.tsx - Select time → Booking rules: checks conflicts
src/screens/BookingScreen.tsx - Select time → Date and time rules: checks slot dates
src/screens/BookingScreen.tsx - Select time → Booking review: navigates to review
src/screens/BookingScreen.tsx - Booking review → Booking state: adds booking
src/screens/BookingConfirmationScreen.tsx - Booking review → Booking rules: checks conflicts
src/screens/BookingConfirmationScreen.tsx - Booking review → Date and time rules: formats dates
src/screens/BookingConfirmationScreen.tsx - My bookings → Booking state: reads and cancels
src/screens/MyBookingsScreen.tsx - My bookings → Room query and filters: loads room data
src/screens/MyBookingsScreen.tsx - My bookings → Booking rules: derives status
src/screens/MyBookingsScreen.tsx - My bookings → Empty and error states: renders empty state
src/screens/MyBookingsScreen.tsx - Profile → Booking state: reads bookings
src/screens/ProfileScreen.tsx - Profile → Booking rules: derives status
src/screens/ProfileScreen.tsx - Room query and filters → Room service: fetches rooms
src/hooks/useRooms.ts - Room query and filters → Filter state: reads filters
src/hooks/useRooms.ts - Room query and filters → Booking state: reads bookings
src/hooks/useRooms.ts - Room query and filters → Booking rules: derives availability
src/hooks/useRooms.ts - Room query and filters → Date and time rules: gets current date
src/hooks/useRooms.ts - Room service → Room catalog: loads catalog
src/services/roomService.ts - Booking state → Booking rules: validates conflicts
src/store/useBookingStore.ts - Booking state → AsyncStorage: persists bookings
src/store/useBookingStore.ts