Android mapping app for OpenStreetMap field surveys with GPS tracking and POI notifications.

• JDK 17+
• Android Studio Hedgehog (2023.1.1) or later
• Android SDK (API 34)
• Android Device/Emulator (API 23+)

1. Clone repository

git clone https://github.com/yourusername/survey-me.git
cd survey-me

2. Open in Android Studio
3. Sync Gradle files
4. Update local.properties with your SDK path:

sdk.dir=C:\\Users\\YourName\\AppData\\Local\\Android\\Sdk

• Run: Click green play button or Shift+F10
• Debug: Click bug icon or Shift+F9
• Build APK: Build → Build Bundle(s)/APK(s) → Build APK(s)

# Debug build
./gradlew assembleDebug

# Install on device
./gradlew installDebug

# Run tests
./gradlew test

# Clean build
./gradlew clean build

To view app logs and crash reports:

./show-logs.ps1

See SCRIPTS.md for details on available PowerShell scripts for building, testing, and GPS simulation.

app/
├── src/main/java/com/surveyme/
│   ├── core/          # Utilities, constants
│   ├── data/          # Repositories, data sources
│   ├── domain/        # Business logic, models
│   └── presentation/  # UI (Activities, Fragments)
└── src/main/res/      # Resources (layouts, values)

See FEATURES_ROADMAP.md for development phases.

• MVVM with Clean Architecture
• Navigation Component
• Kotlin Coroutines
• View Binding

GPL-3.0