Flow: Your Community Safety Companion

Flow is a minimalist safety and connection app designed to turn isolation into connection. It uses a daily check-in loop to keep you connected with your loved ones and your community.

---

🚀 PROJECT STATUS

Flow is currently in Phase 9: App Store Review & Launch. Local development and real-world data verification are 100% complete. App version 1.0.0 (2) is under review.

For detailed progress, see:

• STATUS.md: Current phase, release gates, and completed objectives.
• PRODUCT.md: Vision, user journey, and feature scope.
• TECH_STACK.md: Architecture, tools, and testing strategy.
• DISTRIBUTION.md: Release environments and migration strategy.

---

🛠️ QUICK START

Prerequisites

1. Flutter SDK: stable channel.
2. Supabase CLI: For local backend.
3. Docker: Required by Supabase local development.

Local Development

1. Start Backend: supabase start
2. Install Deps: flutter pub get
3. Run App: flutter run --flavor dev

---

🧪 TESTING

Flow uses a robust testing strategy across all platforms:

Local Sanity Check

flutter analyze && flutter test

Integration Tests (E2E)

To verify the full journey (Auth -> DB):

# Verify on macOS Desktop (No hardware network issues)
flutter test integration_test/app_test.dart -d macos

To verify physical hardware persistence:

# Run on physical device (Ensure LAN IP is set in .env.dev)
flutter test integration_test/supabase_persistence_test.dart --flavor dev