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.md16-gap-analysis-against-mobile-app.md17-coverage-analysis-against-mobile-frontend.md18-api-endpoint-coverage-against-mobile-frontend.md19-mobile-frontend-implementation-guide.md20-mobile-frontend-execution-plan.md
Current Flow Docs¶
- Authentication, onboarding, and legal
- Dashboard, navigation, and app shell
- Properties, leases, tenants, and invitations
- Payments, subscriptions, and Stripe
- Messaging, notifications, and push
- Assets, handovers, calendar, and audit
- Account, settings, support, and admin-adjacent flows
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.