Finding a clean public washroom in Dhaka is hard.
Dead apps, outdated listings, zero community input.
Loo fixes that — open-source, OSM-powered, built by the community for the city.

graph TD
 A([App Launch]) --> B[looApp]
 B --> C[ContentView]
 C --> D[NavigationStack\nAppRouter]
 D --> E[🗺 MapView]
 D --> F[🔍 DetailView]
 D --> G[🧭 FinderView]
 D --> H[👤 ProfileView]
 E --> E1[OSMMapView\nMapLibre]
 E --> E2[NearbySheet]
 E --> E3[TopBar Search + Filter]
 E --> E4[SubmitView]
 F --> F1[PhotoGallery]
 F --> G
 G --> G1[ArrowView\nCompass]
 G --> G2[FinderViewModel\nHeading + GPS]
 subgraph Core Services
 S1[LocationService\nGPS + Compass]
 S2[SwiftData\nLocal Cache]
 S3[Supabase\nBackend]
 end
 E1 -.->|washrooms| S2
 G2 -.->|location + heading| S1
 E4 -.->|submit| S3
 style A fill:#00A86B,color:#fff
 style Core Services fill:#f0f0f0

sequenceDiagram
 participant U as User
 participant MV as MapView
 participant LS as LocationService
 participant SD as SwiftData
 participant SB as Supabase
 U->>MV: App opens
 MV->>LS: requestPermission()
 LS-->>MV: location + heading stream
 MV->>SD: SeedData.injectIfNeeded()
 SD-->>MV: [Washroom] array
 MV->>MV: Sort by real GPS distance
 MV-->>U: Map + NearbySheet rendered
 U->>MV: Tap washroom marker
 MV->>U: Navigate → DetailView
 U->>U: Tap "Find It"
 U->>MV: Navigate → FinderView
 MV->>LS: poll heading @ 10Hz
 LS-->>MV: arrowRotation updated
 MV-->>U: Rotating compass arrow

┌────────────────────────────────────────────────────┐
│ SwiftUI Views │
│ MapView · DetailView · FinderView · SubmitView │
├────────────────────────────────────────────────────┤
│ ViewModels / State │
│ MapViewModel · FinderViewModel · AppRouter │
├──────────────────────┬─────────────────────────────┤
│ Core Services │ Repositories │
│ LocationService │ WashroomRepository │
│ HeadingService │ SubmissionRepository │
│ Geo · Formatting │ AuthRepository │
├──────────────────────┼─────────────────────────────┤
│ SwiftData (Local) │ Supabase (Remote) │
│ Washroom @Model │ PostgreSQL + Auth + CDN │
├──────────────────────┴─────────────────────────────┤
│ MapLibre GL Native │
│ OpenFreeMap OSM Vector Tiles │
└────────────────────────────────────────────────────┘

The Finder screen gives you a real-time pointing arrow — no map needed, just walk.

arrowRotation = bearing(userLocation → target) [radians, true north]
 − deviceHeading [radians, from CLHeading]

graph LR
 GPS[GPS Fix\nCLLocation] --> BRG[Haversine\nBearing]
 CMP[Compass\nCLHeading.trueHeading] --> LPF[Low-pass Filter\nα = 0.15]
 LPF --> HDG[Smoothed\nHeading °→rad]
 BRG --> SUB[−]
 HDG --> SUB
 SUB --> ROT[rotationEffect\nArrowView]
 ROT --> HAP[Haptic\nevery 10m < 100m]

• Single CLLocationManager handles both GPS and compass — trueHeading is accurate because the same manager has location context for magnetic declination
• Low-pass filter smooths compass jitter without introducing noticeable lag
• Haptic feedback fires every 10 m bucket when within 100 m of the target

• Xcode 26+
• iOS 26+ device (Liquid Glass UI; map tiles + compass need real hardware)
• Swift 6

# 1. Clone
git clone https://github.com/siraajul/Loo.git
cd Loo
# 2. Open in Xcode — MapLibre SPM resolves automatically
open loo.xcodeproj

3. Add location permission in the target's Build Settings:

INFOPLIST_KEY_NSLocationWhenInUseUsageDescription = Used to show washrooms near your location.

4. (Optional) Supabase backend — add your credentials to:

// loo/Core/Network/SupabaseClient.swift
let supabaseURL = URL(string: "https://your-project.supabase.co")!
let supabaseKey = "your-anon-key"

5. Run on device — the app seeds 10 real Dhaka washrooms on first launch so it works immediately, even without a backend.

The app ships with 12 Dhaka washrooms so it's usable from day one — each with realistic hours, freshness dates, and amenity flags:

• OSM map with MapLibre GL Native
• GPS blue dot + auto-center on user
• Locate-me FAB (Liquid Glass) for re-centering
• Custom washroom markers (color-coded by gender/type)
• Nearby sheet sorted by real GPS distance
• Compass Finder with smooth arrow + haptics
• Submit a washroom form with map preview
• 12 seed washrooms (incl. hijra + family) for offline-first experience

• iOS 26 Liquid Glass top bar (search, filter, profile, locate-me)
• Three-page onboarding with permission priming and inclusivity showcase
• Women-friendly badge (pink/grey pill at-a-glance)
• Hijra (third-gender) category with own marker color
• Wudu area attribute on mosques
• Baby changing + menstrual products amenities
• Cleanliness sub-rating (separate from overall)
• Freshness signal ("Verified recently / aging / stale / unverified")
• Open-now status — parses 24/7 and HH:mm-HH:mm windows
• Filter sheet wired to map + nearby list (was decorative before)
• Search bar filters by name / Bangla name
• Open in Maps deep-link from detail view

• Live Supabase sync — fetch real washroom data from backend
• Submit washroom → Supabase review queue (currently no-ops)
• Star ratings + written reviews
• Photo upload via Supabase Storage (gallery currently always empty)
• Moderator approval flow
• Real "Open in Maps" deep-link from DetailView (currently dead)
• Phone OTP auth via Supabase (currently stubbed)

• Full-text search across washroom names and areas (search bar currently decorative)
• Search suggestions as you type
• Sort by rating, distance, or price
• Cluster markers at low zoom levels

• Offline tile caching (MapLibre offline packs)
• Push notifications for nearby new submissions
• Expand to Chittagong and Sylhet
• Android version (React Native or Kotlin Multiplatform)
• Import from OpenStreetMap amenity=toilets tag

• App icon + launch screen
• Bangla language support (বাংলা UI)
• Accessibility — VoiceOver labels on all map markers
• TestFlight public beta

Dhaka has thousands of washrooms not yet on the map. This is a community project — every contribution matters.

# 1. Fork the repo on GitHub
# 2. Clone your fork
git clone https://github.com/YOUR_USERNAME/Loo.git
# 3. Create a branch
git checkout -b feature/your-feature-name
# 4. Make your changes, then commit
git commit -m "feat: add your feature"
# 5. Push and open a PR against siraajul/Loo main
git push origin feature/your-feature-name

• SwiftUI views in Features/<FeatureName>/
• New data fields go on the Washroom SwiftData model
• Follow existing naming: PascalCase types, camelCase properties
• No force unwraps — use guard let or if let
• No comments explaining what code does — only why if non-obvious

Look for issues tagged good first issue — these are intentionally scoped and well-described.

MIT © siraajul

You're free to use, modify, and distribute this code. If you build something with it, a shoutout or star ⭐ is always appreciated.