Migrate home screen drawer to Compose

CONTRIBUTING.md

@@ -137,7 +137,6 @@ to the base repository using a pull request.
 
 ## Initial build configuration
 
-### Add Google Maps API Key(s)
 
 ### Set up Firebase
 
@@ -157,15 +156,17 @@ to the base repository using a pull request.
 
 4. Download the config file for the Android app to `app/src/debug/google-services.json`
 
-5. Create a file named `secrets.properties` in the root of the project with the following contents:
+### Add Google Maps API Key(s)
 
-   ```
-   MAPS_API_KEY=<Your Maps SDK API key>
-   ```
+Create a file named `secrets.properties` in the root of the project with the following contents:
+
+```
+MAPS_API_KEY=<Your Maps SDK API key>
+```
 
-   You can find the Maps SDK key for your Firebase project at 
-   http://console.cloud.google.com/google/maps-apis/credentials under 
-   "Android key (auto created by Firebase)". 
+You can find the Maps SDK key for your Firebase project at 
+http://console.cloud.google.com/google/maps-apis/credentials under 
+"Android key (auto created by Firebase)". 
 
 ### Troubleshooting
 

app/build.gradle

@@ -89,8 +89,6 @@ android {
         buildConfigField "int", "AUTH_EMULATOR_PORT", "9099"
         buildConfigField "String", "SIGNUP_FORM_LINK", "\"\""
         manifestPlaceholders.usesCleartextTraffic = true
-
-        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
     }
 
     // Use flag -PtestBuildType with desired variant to change default behavior.
@@ -385,3 +383,4 @@ secrets {
     // checked in version control.
     defaultPropertiesFileName = "local.defaults.properties"
 }
+

app/src/main/java/org/groundplatform/android/ui/home/HomeDrawer.kt

@@ -0,0 +1,281 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.groundplatform.android.ui.home
+
+import androidx.compose.foundation.Image
+import androidx.compose.foundation.background
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.layout.systemBarsPadding
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.rememberScrollState
+import androidx.compose.foundation.shape.CircleShape
+import androidx.compose.foundation.verticalScroll
+import androidx.compose.material.icons.Icons
+import androidx.compose.material.icons.automirrored.filled.ExitToApp
+import androidx.compose.material.icons.filled.Build
+import androidx.compose.material.icons.filled.Settings
+import androidx.compose.material3.HorizontalDivider
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.NavigationDrawerItem
+import androidx.compose.material3.NavigationDrawerItemDefaults
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.platform.testTag
+import androidx.compose.ui.res.painterResource
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.text.style.TextOverflow
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.dp
+import androidx.compose.ui.unit.sp
+import org.groundplatform.android.R
+import org.groundplatform.android.model.Survey
+import org.groundplatform.android.model.User
+import org.groundplatform.android.ui.theme.AppTheme
+
+@Composable
+fun HomeDrawer(
+  user: User,
+  survey: Survey?,
+  versionText: String,
+  onAction: (HomeDrawerAction) -> Unit,
+) {
+  Column(
+    modifier =
+      Modifier.fillMaxWidth()
+        .background(MaterialTheme.colorScheme.surface)
+        .systemBarsPadding()
+        .verticalScroll(rememberScrollState())
+  ) {
+    AppInfoHeader(user = user, onAction = onAction)
+    SurveySelector(survey = survey, onSwitchSurvey = { onAction(HomeDrawerAction.OnSwitchSurvey) })
+    HorizontalDivider()
+    DrawerItems(onAction, versionText)
+  }
+}
+
+private val NAV_ITEMS =
+  listOf(
+    DrawerItem(
+      labelId = R.string.offline_map_imagery,
+      icon = IconSource.Drawable(R.drawable.ic_offline_pin),
+      action = HomeDrawerAction.OnNavigateToOfflineAreas,
+    ),
+    DrawerItem(
+      labelId = R.string.sync_status,
+      icon = IconSource.Drawable(R.drawable.ic_sync),
+      action = HomeDrawerAction.OnNavigateToSyncStatus,
+    ),
+    DrawerItem(
+      labelId = R.string.settings,
+      icon = IconSource.Vector(Icons.Default.Settings),
+      action = HomeDrawerAction.OnNavigateToSettings,
+    ),
+    DrawerItem(
+      labelId = R.string.about,
+      icon = IconSource.Drawable(R.drawable.info_outline),
+      action = HomeDrawerAction.OnNavigateToAbout,
+    ),
+    DrawerItem(
+      labelId = R.string.terms_of_service,
+      icon = IconSource.Drawable(R.drawable.feed),
+      action = HomeDrawerAction.OnNavigateToTerms,
+    ),
+    DrawerItem(
+      labelId = R.string.sign_out,
+      icon = IconSource.Vector(Icons.AutoMirrored.Filled.ExitToApp),
+      action = HomeDrawerAction.OnSignOut,
+    ),
+  )
+
+@Composable
+private fun DrawerItems(onAction: (HomeDrawerAction) -> Unit, versionText: String) {
+  NAV_ITEMS.forEach { item -> DrawerNavigationItem(item, onAction) }
+
+  DrawerVersionFooter(versionText)
+}
+
+@Composable
+private fun DrawerNavigationItem(item: DrawerItem, onAction: (HomeDrawerAction) -> Unit) {
+  val label = stringResource(item.labelId)
+  NavigationDrawerItem(
+    label = { Text(label) },
+    selected = false,
+    onClick = { onAction(item.action) },
+    icon = {
+      val description = null
+      when (item.icon) {
+        is IconSource.Vector -> Icon(item.icon.imageVector, contentDescription = description)
+        is IconSource.Drawable ->
+          Icon(painterResource(item.icon.id), contentDescription = description)
+      }
+    },
+    modifier = Modifier.padding(NavigationDrawerItemDefaults.ItemPadding).testTag(label),
+  )
+}
+
+@Composable
+private fun DrawerVersionFooter(versionText: String) {
+  Row(
+    modifier =
+      Modifier.fillMaxWidth()
+        .padding(NavigationDrawerItemDefaults.ItemPadding)
+        .padding(start = 16.dp, end = 24.dp, top = 12.dp, bottom = 12.dp),
+    verticalAlignment = Alignment.CenterVertically,
+  ) {
+    Icon(
+      imageVector = Icons.Default.Build,
+      contentDescription = null,
+      tint = MaterialTheme.colorScheme.onSurfaceVariant,
+    )
+    Spacer(Modifier.width(12.dp))
+    Text(
+      text = versionText,
+      style = MaterialTheme.typography.labelLarge,
+      color = MaterialTheme.colorScheme.onSurfaceVariant,
+    )
+  }
+}
+
+private data class DrawerItem(
+  @androidx.annotation.StringRes val labelId: Int,
+  val icon: IconSource,
+  val action: HomeDrawerAction,
+)
+
+@Composable
+private fun AppInfoHeader(user: User, onAction: (HomeDrawerAction) -> Unit) {
+  Column(
+    modifier =
+      Modifier.fillMaxWidth()
+        .background(MaterialTheme.colorScheme.surfaceVariant)
+        .padding(vertical = 24.dp, horizontal = 16.dp)
+  ) {
+    Row(verticalAlignment = Alignment.CenterVertically, modifier = Modifier.fillMaxWidth()) {
+      Image(
+        painter = painterResource(R.drawable.ground_logo),
+        contentDescription = null,
+        modifier = Modifier.size(24.dp),
+      )
+      Spacer(Modifier.width(8.dp))
+      Column(modifier = Modifier.weight(1f)) {
+        Text(
+          text = stringResource(R.string.app_name),
+          fontSize = 18.sp,
+          fontWeight = FontWeight.Medium,
+        )
+      }
+      if (user.photoUrl != null) {
+        coil.compose.AsyncImage(
+          model = user.photoUrl,
+          contentDescription = null,
+          modifier =
+            Modifier.size(32.dp).clip(CircleShape).clickable {
+              onAction(HomeDrawerAction.OnUserDetails)
+            },
+          contentScale = androidx.compose.ui.layout.ContentScale.Crop,
+        )
+      }
+    }
+  }
+}
+
+@Composable
+private fun SurveySelector(survey: Survey?, onSwitchSurvey: () -> Unit) {
+  Column(modifier = Modifier.fillMaxWidth().padding(16.dp)) {
+    Row(verticalAlignment = Alignment.CenterVertically) {
+      Icon(
+        painter = painterResource(R.drawable.ic_content_paste),
+        contentDescription = stringResource(R.string.current_survey),
+        modifier = Modifier.size(14.dp),
+        tint = MaterialTheme.colorScheme.onSurfaceVariant,
+      )
+      Spacer(Modifier.width(4.dp))
+      Text(
+        text = stringResource(R.string.current_survey),
+        style = MaterialTheme.typography.labelSmall,
+        color = MaterialTheme.colorScheme.onSurfaceVariant,
+      )
+    }
+    Spacer(Modifier.height(8.dp))
+
+    if (survey == null) {
+      Text(stringResource(R.string.no_survey_selected))
+    } else {
+      Text(
+        text = survey.title,
+        style = MaterialTheme.typography.titleMedium,
+        fontWeight = FontWeight.Bold,
+        maxLines = 3,
+        overflow = TextOverflow.Ellipsis,
+      )
+      if (survey.description.isNotEmpty()) {
+        Text(
+          text = survey.description,
+          style = MaterialTheme.typography.bodyMedium,
+          maxLines = 4,
+          overflow = TextOverflow.Ellipsis,
+          modifier = Modifier.padding(top = 8.dp),
+        )
+      }
+    }
+
+    Spacer(Modifier.height(16.dp))
+
+    Text(
+      text = stringResource(R.string.switch_survey),
+      style = MaterialTheme.typography.labelLarge,
+      color = MaterialTheme.colorScheme.primary,
+      fontWeight = FontWeight.Bold,
+      modifier = Modifier.padding(vertical = 8.dp).clickable(onClick = onSwitchSurvey),
+    )
+  }
+}
+
+private sealed interface IconSource {
+  data class Vector(val imageVector: androidx.compose.ui.graphics.vector.ImageVector) : IconSource
+
+  data class Drawable(@androidx.annotation.DrawableRes val id: Int) : IconSource
+}
+
+@Preview(showBackground = true)
+@Composable
+private fun HomeDrawerPreview() {
+  val mockUser =
+    User(id = "1", email = "test@example.com", displayName = "Jane Doe", photoUrl = null)
+  val mockSurvey =
+    Survey(
+      id = "1",
+      title = "Tree Survey",
+      description = "A comprehensive survey for mapping urban tree canopy and assessing health.",
+      jobMap = emptyMap(),
+      generalAccess = org.groundplatform.android.proto.Survey.GeneralAccess.PUBLIC,
+    )
+  AppTheme {
+    HomeDrawer(user = mockUser, survey = mockSurvey, versionText = "1.0.0-preview", onAction = {})
+  }
+}

app/src/main/java/org/groundplatform/android/ui/home/HomeDrawerAction.kt

@@ -0,0 +1,34 @@
+/*
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.groundplatform.android.ui.home
+
+sealed interface HomeDrawerAction {
+  data object OnSwitchSurvey : HomeDrawerAction
+
+  data object OnNavigateToOfflineAreas : HomeDrawerAction
+
+  data object OnNavigateToSyncStatus : HomeDrawerAction
+
+  data object OnNavigateToSettings : HomeDrawerAction
+
+  data object OnNavigateToAbout : HomeDrawerAction
+
+  data object OnNavigateToTerms : HomeDrawerAction
+
+  data object OnSignOut : HomeDrawerAction
+
+  data object OnUserDetails : HomeDrawerAction
+}