NestKeeper App - Full Featured Tenant Application

NestKeeper Tenant – Full Featured Tenant Application

Login – Dashboard (Demo credentials)

Role / User	Email / Username	Password
Tenant	tenant12@example.com	12345678

Give residents and tenants a single mobile app to manage their tenancy: view summaries and activity, browse properties, open agreements, pay and track transactions, raise maintenance requests, read notices, contact support, and leave reviews. Built with Flutter for Android & iOS, using Provider for state and Dio for a configurable REST API (Bearer token auth, interceptors, session handling).

Core experience

• Authentication & security — Sign-in flow with OTP support, password recovery / set new password, change password, and token-based API access.
• Dashboard — At-a-glance totals, purchase/transaction history, and quick paths into key areas; notifications inbox.
• Bottom navigation — Fast access to Home, Payments, Maintenance requests, and Profile.
• Side drawer — Agreements, property list, notice board, reviews & feedback, support tickets, and logout.

Tenant & property features

• Properties — Listing with filters; detail views with gallery, floor plan, facilities, and booking/lease-related flows.
• Agreements — List and detail views tied to tenancy documents.
• Bookings — Booking list experience aligned with your backend.
• Renewal & termination — Flows for renewal and termination where applicable.
• Payments — Payment screens with transaction history styling and file attachments where supported.
• Maintenance — Create requests, lists, notes, and status presentation (active, in progress, cancelled, etc.).
• Support tickets — Create and track tickets with priorities/details from API.
• Notice board — HTML-friendly content where configured.
• Reviews & feedback — Submit and browse feedback.

# Changelog

## 2.0.0 – Major Conversion release

- Improved Profile UI with cleaner personal, contact, and address sections.
- Updated profile image handling so the selected image is shown only in the avatar area, not inside form fields.
- Added loading indicators for profile update and change password actions.
- Added Booking List screen with API integration and shimmer loading.
- Added navigation from Home dashboard summary cards to Booking, Agreement, Maintenance, and Support list pages.
- Improved Create Ticket and Create Maintenance Request flows with proper button loading states.
- Fixed maintenance list shimmer showing unnecessarily after creating a maintenance request.
- Removed unwanted circular loaders from Home purchase history images.
- Added Property List filter system using bottom sheet UI.
- Integrated property filter options and city search APIs.
- Added searchable city picker for property filters.
- Added active filter chips on the Property List screen.
- Improved Property List refresh behavior, including empty filtered result handling.
- Fixed Property List empty state refresh and filter reset behavior.
- Added shimmer loading to Support Ticket Details screen.
- Added loading state for Add Review and Feedback submission.
- Fixed Review and Feedback search behavior.
- Added warning dialog when creating a review without available properties.
- Updated bottom navigation inactive icon UI with circular light-gray background.
- Fixed bottom navigation transition crash and drawer route visibility issues.
- Improved Home page pull-to-refresh behavior.
- Ensured Review and Feedback API is called when entering the Review and Feedback list page.
- Cleaned unnecessary debug logs, emoji logs, raw print statements, and commented dead code.
- Removed unused dead widget file.
- Resolved Dart analyzer issues across the app.
- General UI, loading state, and stability improvements for client delivery.