Wafi | وافي

Arabic-first property operations for Saudi portfolios.
Manage properties, leases, collections, maintenance, finance, communication, and risk analysis from one offline-first Flutter app.

Beta Releases · Development Guide · Architecture · Code Map

Why Wafi?

Wafi is designed for operators who need a practical Saudi property-management app, not just a demo dashboard. It keeps the workflow local, bilingual, and operationally focused.

• Arabic-first UX with English support across forms, flows, and operational copy.
• Offline-first local storage built on Drift/SQLite for day-to-day reliability.
• Saudi-ready workflows for leases, invoices, VAT, SADAD references, and Ejar-linked operations.
• One app surface for portfolio visibility, collections, maintenance, finance, and tenant communication.
• Current release track: 1.0.0-beta.1 for beta testing and validation.

See It In Action

Dashboard	Properties
Morning Brief with monthly collections, occupancy, vacancies, and net income cards.	Arabic-first property listing with clear status, portfolio codes, and quick creation actions.

Maintenance	Navigation
Maintenance workspace with empty states, fast actions, and workflow entry points.	App drawer covering contracts, owners, residents, maps, communication, contractors, Kanban, and finance.

Core Workflows

Area	What it handles
Portfolio	Properties, units, occupancy, vacancies, owner relationships
Leasing	Lease creation, renewals, schedules, and lifecycle tracking
Collections	Invoices, aging, payments, VAT-aware finance workflows
Maintenance	Work orders, PM plans, contractors, and Kanban operations
Communication	WhatsApp-oriented reminders, tenant follow-up, operational outreach
Risk	Weighted risk analysis for portfolio health and decision support

Stack

Layer	Technology
App	Flutter + Dart
State	Riverpod
Routing	GoRouter
Storage	Drift + SQLite
Localization	easy_localization
Charts	fl_chart
Security	flutter_secure_storage, local_auth, crypto

Validated Build Flow

These commands were used during the current beta-validation pass:

flutter pub get
flutter test test/core/database/work_order_dao_test.dart test/core/database/risk_dao_test.dart
flutter build apk --release

Validated outputs:

• Release APK builds successfully at build/app/outputs/flutter-apk/app-release.apk.
• Current beta artifact size is about 72.9 MB.
• Android launcher icons now use the Wafi brand assets instead of the default Flutter icon.
• Release builds currently use the debug signing config in android/app/build.gradle.kts for beta sharing only.

Local Setup

git clone https://github.com/wa1939/wafi.git
cd wafi
flutter pub get
dart run build_runner build --delete-conflicting-outputs
flutter analyze
flutter test
flutter run -d <device_id>

Platform Notes

• Android is the primary supported target for the current beta.
• Windows desktop smoke testing is blocked until Windows Developer Mode is enabled because Flutter plugin builds require symlink support.
• Web is intentionally unsupported right now because Drift/sqlite relies on dart:ffi.
• Google Maps features require a valid Android Maps API key before production rollout.

Documentation

• docs/DEVELOPMENT.md - local setup, validation steps, and build notes
• docs/ARCHITECTURE.md - application structure and technical design
• docs/CODEMAP.md - repository map for rapid onboarding and maintenance
• docs/PLAN.md - roadmap and implementation phases

Built With Purpose

Wafi was made by Waleed Alhamed and built in honor of his father, Hamed Alghamdi.

That dedication sits at the heart of the project: make property operations clearer, calmer, and more dependable for real people doing real work.