zuhak5/homepilot

Purpose and Entry Points

HomePilot is an Android-focused Flutter app for home-asset tracking and recurring maintenance. Supabase is authoritative; Drift/SQLite is an authenticated cache and offline mutation queue. Flutter starts at lib/main.dart, with splash handling in lib/homepilot_animated_splash_screen.dart. Android hosts Flutter through android/app/src/main/kotlin/com/homepilot/app/MainActivity.kt.

App Composition and Domain

Core domain contracts, models, selectors, and feature models establish the application’s data vocabulary and repository boundaries. UI foundations provide theme and shared composition; localization supports English and Arabic.

• lib/src/core/domain/contracts.dart

• lib/src/core/domain/models.dart

• lib/src/core/data/repositories.dart

• lib/src/ui/app_theme.dart

• lib/l10n/app_en.arb

Authentication and Account Boundary

Production access is gated by Google sign-in and Supabase Auth; unsupported local/guest flows are excluded. Authentication state determines whether the app shell is reachable, and account cleanup handles user-local data lifecycle.

• lib/src/features/auth/presentation/authentication_gate.dart

• lib/src/features/auth/data/native_google_sign_in.dart

• lib/src/features/auth/data/supabase_auth_repository.dart

• lib/src/features/auth/data/local_account_data_cleaner.dart

Local Persistence, Offline Work, and Sync

Drift provides local snapshots plus queued mutations. The sync coordinator orchestrates session/connectivity recovery, outgoing changes, remote refreshes, conflict preservation, and background/foreground scheduling. Supabase Realtime triggers cache invalidation across devices rather than treating local data as canonical.

• lib/src/core/database/app_database.dart

• lib/src/core/sync/sync_coordinator.dart

• lib/src/core/sync/supabase_sync_gateway.dart

• lib/src/core/sync/local_sync_store.dart

• lib/src/core/sync/background_sync_scheduler.dart

Supabase Cloud Platform

Supabase supplies Auth, Postgres with RLS, Realtime, private Storage, and server-side RPC/schema behavior. Versioned migrations define cloud schema evolution, synchronization protocol, maintenance completion, account deletion, notifications, and points monetization. Edge Functions isolate privileged account deletion and AdMob server-side-verification processing.

• supabase/migrations/20260628000100_create_homepilot_cloud_schema.sql

• supabase/migrations/20260629150852_enable_realtime_sync.sql

• supabase/migrations/20260728042000_enable_maintenance_completion_rpc.sql

• supabase/functions/delete-account/index.ts

• supabase/functions/admob-ssv-handler/index.ts

Device Services and Monetization

Services translate domain changes into local notifications/reminder reconciliation, permissions, feedback, backup/diagnostic export, weather, and health scoring. Monetization is represented as a feature and backed by Supabase points/reward schema plus native Android ad presentation.

• lib/src/core/services/reminder_schedule_reconciler.dart

• lib/src/core/services/notification_service.dart

• lib/src/features/monetization/monetization.dart

• android/app/src/main/kotlin/com/homepilot/app/HomePilotNativeAdFactory.kt

• supabase/migrations/20260801124625_create_points_rpc_and_reward_claims.sql

Configuration, Observability, and Delivery

Runtime configuration injects public Supabase, Google OAuth, and Sentry settings by environment; secure storage protects Supabase session material. Sentry is privacy-restricted through explicit bootstrap, event scrubbing, and tracing boundaries. GitHub Actions is the only supported signed production-build path; a separate static download site publishes releases.

• lib/src/core/config/app_config.dart

• lib/src/core/supabase/supabase_bootstrap.dart

• lib/src/core/observability/sentry_bootstrap.dart

• lib/src/core/observability/sentry_event_scrubber.dart

• .github/workflows/build-production-android.yml

• download-site/index.html