Skip to content

Mobile Frontend Flows

Last audited: 2026-06-26.

This folder documents the current mobile-frontend implementation. It is based on the Expo route tree under mobile-frontend/app, the route helpers in mobile-frontend/utils/routes/index.ts, and the React Query/API hooks under mobile-frontend/hooks.

This is not a backlog. Removed planning files from the previous docs set:

  • 15-remaining-work.md
  • 16-gap-analysis-against-mobile-app.md
  • 17-coverage-analysis-against-mobile-frontend.md
  • 18-api-endpoint-coverage-against-mobile-frontend.md
  • 19-mobile-frontend-implementation-guide.md
  • 20-mobile-frontend-execution-plan.md

Current Flow Docs

Current Route Inventory

Public/root routes:

  • /
  • /callback
  • /logout
  • /support
  • not-found route

Auth routes:

  • /auth/sign-in
  • /auth/sign-up
  • /auth/forgot-password
  • /auth/invitation-code
  • /auth/terms-of-service
  • /auth/privacy-policy
  • /auth/support

Authenticated app routes:

  • /dashboard
  • /onboarding
  • /role-assign
  • /legal-accept
  • /property
  • /property/create-property
  • /property/kinds/[propertyKind]
  • /property/[propertyId]
  • /property/[propertyId]/edit-property
  • /property/[propertyId]/rent
  • /property/[propertyId]/costs
  • /property/[propertyId]/costs/add
  • /property/[propertyId]/costs/[costId]
  • /property/[propertyId]/audit-logs
  • /property/[propertyId]/leases
  • /property/[propertyId]/leases/[leaseId]
  • /property/[propertyId]/leases/[leaseId]/edit
  • /property/[propertyId]/leases/[leaseId]/renew
  • /property/[propertyId]/leases/[leaseId]/documents
  • /property/[propertyId]/leases/[leaseId]/final-settlement
  • /property/[propertyId]/leases/[leaseId]/final-settlement/details
  • /property/[propertyId]/leases/[leaseId]/final-settlement/evidence
  • /property/[propertyId]/leases/[leaseId]/payments
  • /property/[propertyId]/leases/[leaseId]/payments/add
  • /property/[propertyId]/leases/[leaseId]/payments/[requestId]
  • /property/[propertyId]/leases/[leaseId]/payments/[requestId]/edit
  • /property/[propertyId]/leases/[leaseId]/schedules/[scheduleId]/edit
  • /property/[propertyId]/leases/[leaseId]/tenants
  • /property/[propertyId]/leases/[leaseId]/tenants/create
  • /property/[propertyId]/leases/[leaseId]/tenants/[leaseTenantId]
  • /property/[propertyId]/leases/[leaseId]/invitations
  • /property/[propertyId]/leases/[leaseId]/invitations/create
  • /property/[propertyId]/leases/[leaseId]/invitations/[invitationId]
  • /property/[propertyId]/leases/[leaseId]/handovers
  • /property/[propertyId]/leases/[leaseId]/handovers/create
  • /property/[propertyId]/leases/[leaseId]/handovers/[protocolId]
  • /property/[propertyId]/leases/[leaseId]/handovers/[protocolId]/edit
  • /property/[propertyId]/leases/[leaseId]/handovers/[protocolId]/items/create
  • /property/[propertyId]/leases/[leaseId]/handovers/[protocolId]/items/[itemId]
  • /lease/[leaseId]
  • /invitations/[invitationId]
  • /invitations/enter-code
  • /invitations/accept/[code]
  • /messaging
  • /messaging/[leaseId]
  • /notifications
  • /calendar
  • /calendar/create
  • /calendar/[eventId]
  • /calendar/[eventId]/edit
  • /audit-logs
  • /handover/[protocolId]
  • /rent-payment/success
  • /rent-payment/cancel
  • /connect/return
  • /connect/refresh
  • /subscription
  • /subscription/plans
  • /subscription/[...slug]
  • /account
  • /account/profile
  • /account/address
  • /account/preferences
  • /account/payment
  • /account/bank-account
  • /account/bank-account/add
  • /account/bank-account/[accountId]
  • /account/legal
  • /account/terms-of-service
  • /account/privacy-policy
  • /account/support
  • /account/data-export
  • /account/delete-account
  • /report-problem

Current API Coverage In Mobile Hooks

Current hooks call these backend API families:

  • /v1/users/current, /v1/users/init, /v1/users/current/settings, /v1/users/current/data-export
  • /v1/dashboard/owner, /v1/dashboard/tenant
  • /v1/legal/terms-of-service, /v1/legal/privacy-policy, /v1/legal/accept
  • /v1/properties, /v1/properties/{propertyId}, /v1/properties/{propertyId}/costs
  • /v1/leases, /v1/leases/{leaseId}, /v1/leases/property/{propertyId}/current, /v1/leases/{leaseId}/renew, /v1/leases/{leaseId}/final-settlement, /v1/leases/{leaseId}/final-settlement/statement, /v1/leases/{leaseId}/final-settlement/evidence, /v1/leases/{leaseId}/payment-compliance
  • /v1/leases/{leaseId}/tenants
  • /v1/leases/{leaseId}/invitations, /v1/invitations/{invitationId}, /v1/invitations/{code}/accept
  • /v1/leases/{leaseId}/payment-schedules
  • /v1/leases/{leaseId}/payment-requests, /v1/leases/{leaseId}/payment-requests/{requestId}, deferral and mark-paid actions
  • /v1/leases/{leaseId}/payment-requests/{requestId}/receipts
  • /v1/rent-payments/checkout
  • /v1/connect-accounts, /v1/connect-accounts/status, /v1/connect-accounts/refresh-link
  • /v1/subscriptions/plans, /v1/subscriptions/current, /v1/subscriptions/checkout, /v1/subscriptions/store/confirm, /v1/subscriptions/change-plan, /v1/subscriptions/portal
  • /v1/chats, /v1/chats/{leaseId}/messages, message actions and read state
  • /v1/notifications, /v1/notifications/unread-count, read and snooze actions
  • /v1/push-tokens
  • /v1/assets, /v1/assets/{parentType}/{parentId}, /v1/storage/uploads/file
  • /v1/handover-protocols, /v1/handover-items
  • /v1/calendar-events
  • /v1/audit-logs, /v1/audit-logs/my-activity
  • /v1/bank-accounts
  • /v1/problem-reports

Notes

  • Screen telemetry is mounted inside the authenticated app shell and records route changes after app bootstrap.
  • Required-app-update handling is native-focused and can block the app before the normal app shell is mounted.
  • Public auth and legal routes exist both inside auth flow and account/settings flow.
  • Subscription routes mostly redirect to account payment or plan purchase surfaces.
  • Native push registration currently obtains Firebase Messaging tokens and posts them to /v1/push-tokens.
  • 2026-06-26 integration QA verified in-app notification list/unread/read-all behavior, message/payment/handover/final-settlement notification routing, owner/tenant handover confirmations for move-in and move-out, and owner/tenant final-settlement confirmation to Zakończone.