SMS Sync is a Flutter app for Android that discovers a local sync server over mDNS and forwards SMS metadata over Wi-Fi. It supports background sync scheduling, Wi-Fi network whitelisting, location permission handling, and persistent status notifications.
- Background SMS sync using Android WorkManager
- Local mDNS discovery
- Wi-Fi SSID whitelist protection
- Manual sync and sync status display
- Persistent low-priority foreground notification while sync is active
- Custom sync service path and interval settings
lib/main.dart— app entrypoint, launchesHomeScreenwith dark themelib/services/sync_service.dart— app state manager, foreground sync control, settings persistencelib/services/background_sync_service.dart— background task registration and sync runnerlib/services/notification_service.dart— foreground sync notification handlinglib/services/wifi_whitelist_service.dart— SSID whitelist persistence and validationlib/ui/screens/home_screen.dart— primary status/controls UIlib/ui/screens/settings_screen.dart— sync configuration and whitelist managementlib/theme/app_theme.dart— app styling
- Android device or emulator with SMS and location permissions
- Wi-Fi access to the same local network as the sync server
READ_SMS,ACCESS_FINE_LOCATION, and network permissions granted
flutter pub getflutter runflutter build apk --releaseThe app stores the following settings in SharedPreferences:
sync_service_type— mDNS service type (default_sms-sync._tcp)sync_path— HTTP path used when posting SMS sync datasync_interval_minutes— periodic sync interval in minutes
The app requests location permission to read the current Wi-Fi SSID. It also requires SMS permission to access message data and WorkManager support for background scheduling.
The sync service uses WorkManager and foreground notifications to keep background sync active.
flutter_local_notifications— foreground notification supporthttp— HTTP client for POST sync requestsmulticast_dns— local service discoverynetwork_info_plus— current Wi-Fi SSID lookuppermission_handler— runtime permission requestsshared_preferences— settings persistencetelephony— SMS inbox accessworkmanager— periodic background task scheduling
This project is intended for Android, where SMS access and WorkManager are available. It is not designed as a general-purpose cross-platform Flutter app.