How kraamecnal/boarding-house works
InKeeper is a property-management app for boarding-house owners. The main workflow is owner sign-in, house and room management, tenant and tenancy registration, then monthly billing and payment tracking. Supporting capabilities include meter readings and tenant-document storage, owner notifications and optional push, and server-side bill-reminder email. The graph combines sampled code references with README-documented behavior; unsampled screens and database-side wiring are represented only where the README supports the relationship.
Main entry points: supabase.ts Supabase client · RoomsContext.tsx Rooms and tenancies · [roomId].tsx Monthly bill · BillsContext.tsx Bill records
Components 26
Identity and access
- Email OTP sign-in
src/app/sign-in.tsx - Auth session
src/contexts/AuthContext.tsx - Supabase client
src/utils/supabase.ts
Property management
- Manage dashboard
src/app/(tabs)/manage.tsx - House records
src/contexts/BoardingHousesContext.tsx - House overview
src/app/bh/[id]/index.tsx
Tenancy operations
- Rooms and tenancies
src/contexts/RoomsContext.tsx - Room management
src/app/bh/[id]/room/[roomId]/index.tsx - Tenant registration
src/app/bh/[id]/room/[roomId]/tenant.tsx - Tenant documents
src/data/tenantDocuments.ts - Document capture
src/components/ImageField.tsx - Meter entry and history
src/app/bh/[id]/room/[roomId]/meter-reading.tsx - Meter readings
src/utils/meterReadings.ts
Billing and payments
- Charge settings
src/app/billing-charges.tsx - Bill records
src/contexts/BillsContext.tsx - Bill calculations
src/utils/billing.ts - Meter billing
src/utils/meterBilling.ts - Monthly bill
src/app/bill/[roomId].tsx - Bill statement
src/components/BillStatement.tsx
Notifications
- In-app notifications
src/contexts/NotificationsContext.tsx - Notification services
src/utils/notifications.ts - Push delivery function
supabase/functions/send-notification-push/index.ts - Bill reminder function
supabase/functions/send-bill-reminders/index.ts - Expo Push Service
- Email delivery
Other components
- House owner
Connections 28
- House owner → Email OTP sign-in: starts session
src/app/sign-in.tsx - Email OTP sign-in → Auth session: requests OTP
src/app/sign-in.tsx - Auth session → Supabase client: verifies OTP
src/contexts/AuthContext.tsx - Manage dashboard → House records: shows houses
- House records → Supabase client: reads and writes
src/contexts/BoardingHousesContext.tsx - Manage dashboard → House overview: opens house
- House overview → House records: loads house data
src/app/bh/[id]/index.tsx - House overview → Rooms and tenancies: loads rooms
src/app/bh/[id]/index.tsx - Room management → Rooms and tenancies: manages room
src/app/bh/[id]/room/[roomId]/index.tsx - Tenant registration → Rooms and tenancies: registers tenancy
- Rooms and tenancies → Supabase client: stores tenancy data
src/contexts/RoomsContext.tsx - Room management → Document capture: captures documents
src/app/bh/[id]/room/[roomId]/index.tsx - Document capture → Tenant documents: uses document rules
src/components/ImageField.tsx - Rooms and tenancies → Tenant documents: uploads and signs URLs
src/contexts/RoomsContext.tsx - Meter entry and history → Meter readings: records readings
- Meter readings → Supabase client: reads and writes
src/utils/meterReadings.ts - Charge settings → Supabase client: stores charges
src/app/billing-charges.tsx - Monthly bill → Bill records: loads bill data
src/app/bill/[roomId].tsx - Bill records → Rooms and tenancies: uses occupied rooms
src/contexts/BillsContext.tsx - Bill records → Bill calculations: calculates totals
src/contexts/BillsContext.tsx - Bill records → Supabase client: reads and updates bills
src/contexts/BillsContext.tsx - Monthly bill → Meter billing: loads meter charges
src/app/bill/[roomId].tsx - Monthly bill → Meter readings: loads readings
src/app/bill/[roomId].tsx - Monthly bill → Bill statement: renders statement
src/app/bill/[roomId].tsx - In-app notifications → Notification services: loads notifications
src/contexts/NotificationsContext.tsx - Notification services → Supabase client: accesses notification data
src/utils/notifications.ts - Push delivery function → Expo Push Service: sends push
README.md - Bill reminder function → Email delivery: sends reminders
README.md