Merge pull request #13 from Coding-Meet/feature/analytics

Refactor UI components and enhance documentation and marketing copy

Author: Coding-Meet

README.md

@@ -85,7 +85,7 @@ Privacy is a core design principle of DevAnalyzer:
 * **Local Processing**: All analysis runs locally. Your code, project names, and file paths are never uploaded.
 * **Optional Analytics**: You can opt in or out of anonymous analytics at any time.
 * **Zero PII**: No email addresses, personal details, or sensitive metadata are tracked.
-* **SDK Configuration**: We use `PersonProfiles.IDENTIFIED_ONLY` internally in the PostHog SDK configuration. Since we never call `PostHog.identify`, all users remain completely anonymous.
+* **SDK Configuration**: We configure the analytics client to keep all metrics completely anonymous. Since we never call identification methods, all users remain completely anonymous.
 
 ---
 

composeApp/src/jvmMain/kotlin/com/meet/dev/analyzer/main.kt

@@ -139,6 +139,24 @@ fun main() {
                     isDarkMode = appUiState.isDarkMode,
                     onThemeChange = {
                         appViewModel.handleIntent(AppUiIntent.ChangeTheme(appUiState.isDarkMode))
+                    },
+                    updateDialogWithNavigation = { currentNavigationItem ->
+                        val updateState = appViewModel.updateDialogState
+                        if (updateState is UpdateDialogState.Available && currentNavigationItem != null) {
+                            LaunchedEffect(updateState) {
+                                appViewModel.trackUpdateDialogShown()
+                            }
+                            UpdateDialog(
+                                state = updateState,
+                                onDismiss = {
+                                    appViewModel.trackUpdateDismissed()
+                                    appViewModel.closeUpdateDialog()
+                                },
+                                onUpdateClicked = {
+                                    appViewModel.trackUpdateClicked()
+                                }
+                            )
+                        }
                     }
                 )
 
@@ -157,22 +175,6 @@ fun main() {
                             )
                         }
                 }
-                val updateState = appViewModel.updateDialogState
-                if (updateState is UpdateDialogState.Available) {
-                    LaunchedEffect(updateState) {
-                        appViewModel.trackUpdateDialogShown()
-                    }
-                    UpdateDialog(
-                        state = updateState,
-                        onDismiss = {
-                            appViewModel.trackUpdateDismissed()
-                            appViewModel.closeUpdateDialog()
-                        },
-                        onUpdateClicked = {
-                            appViewModel.trackUpdateClicked()
-                        }
-                    )
-                }
             }
         }
     }

composeApp/src/jvmMain/kotlin/com/meet/dev/analyzer/presentation/components/EmptyStateCardLayout.kt

@@ -86,7 +86,7 @@ fun EmptyStateCardLayout(
                     )
                 ) {
                     Icon(
-                        Icons.Default.Search,
+                        icon,
                         contentDescription = null,
                         modifier = Modifier.size(18.dp)
                     )

composeApp/src/jvmMain/kotlin/com/meet/dev/analyzer/presentation/navigation/AppNavigation.kt

@@ -28,6 +28,7 @@ import com.meet.dev.analyzer.presentation.screen.workspace.WorkspaceScreen
 fun AppNavigation(
     isDarkMode: Boolean,
     onThemeChange: () -> Unit,
+    updateDialogWithNavigation: @Composable (NavigationItem?)  -> Unit
 ) {
     val navController = rememberNavController()
     val navBackStackEntry by navController.currentBackStackEntryAsState()
@@ -137,4 +138,5 @@ fun AppNavigation(
             }
         }
     }
+    updateDialogWithNavigation(currentNavigationItem)
 }

composeApp/src/jvmMain/kotlin/com/meet/dev/analyzer/presentation/screen/cleanbuild/CleanBuildScreen.kt

@@ -264,8 +264,10 @@ fun CleanBuildScreenContent(
                 }
             } else {
                 EmptyStateCardLayout(
-                    title = "No Projects Selected",
-                    description = "Browse and select Android Studio projects to clean",
+                    title = "Select a Project Directory",
+                    description = "Choose a folder containing your Android Studio projects to scan for build folders and safely remove them to reclaim disk space.",
+                    actionText = "Select Folder",
+                    onAction = onBrowseClick,
                     icon = Icons.Default.FolderOpen,
                     modifier = Modifier.padding(10.dp).fillMaxSize()
                 )

composeApp/src/jvmMain/kotlin/com/meet/dev/analyzer/presentation/screen/project/ProjectAnalyzerScreen.kt

@@ -220,8 +220,10 @@ fun ProjectAnalyzerContent(
                 }
             } else {
                 EmptyStateCardLayout(
-                    title = "No Project Selected",
-                    description = "Browse and select an Android Studio project folder, then click Analyze to view modules, plugins, and dependencies.",
+                    title = "Select an Android Project",
+                    description = "Choose an Android Studio project to analyze its modules, Gradle configuration, plugins, dependencies, SDK versions, and build files.",
+                    actionText = "Select Project",
+                    onAction = onBrowseClick,
                     icon = Icons.Default.FolderOpen,
                     modifier = Modifier.padding(10.dp).fillMaxSize()
                 )

composeApp/src/jvmMain/kotlin/com/meet/dev/analyzer/presentation/screen/project/components/ModulesTabContent.kt

@@ -24,9 +24,11 @@ import androidx.compose.foundation.shape.CircleShape
 import androidx.compose.foundation.shape.RoundedCornerShape
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.filled.AccountTree
+import androidx.compose.material.icons.filled.DataObject
 import androidx.compose.material.icons.filled.ExpandLess
 import androidx.compose.material.icons.filled.ExpandMore
 import androidx.compose.material.icons.filled.Extension
+import androidx.compose.material.icons.filled.Folder
 import androidx.compose.material.icons.filled.Plumbing
 import androidx.compose.material3.CardDefaults
 import androidx.compose.material3.HorizontalDivider
@@ -47,13 +49,15 @@ import androidx.compose.ui.graphics.vector.ImageVector
 import androidx.compose.ui.input.pointer.PointerIcon
 import androidx.compose.ui.input.pointer.pointerHoverIcon
 import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.text.style.TextDecoration
 import androidx.compose.ui.text.style.TextOverflow
 import androidx.compose.ui.unit.dp
 import com.meet.dev.analyzer.data.models.project.Dependency
 import com.meet.dev.analyzer.data.models.project.ModuleBuildFileInfo
 import com.meet.dev.analyzer.data.models.project.Plugin
 import com.meet.dev.analyzer.presentation.components.EmptyStateCardLayout
 import com.meet.dev.analyzer.presentation.components.VerticalScrollBarLayout
+import com.meet.dev.analyzer.utility.platform.FolderFileUtils
 import java.awt.Cursor
 
 
@@ -66,12 +70,18 @@ fun ModulesTabContent(
         val scrollState = rememberLazyGridState()
         LazyVerticalGrid(
             state = scrollState,
-            columns = GridCells.Adaptive(minSize = 400.dp),
+            columns = GridCells.Adaptive(minSize = 360.dp),
             modifier = Modifier.fillMaxSize(),
             contentPadding = PaddingValues(16.dp),
-            verticalArrangement = Arrangement.spacedBy(16.dp),
-            horizontalArrangement = Arrangement.spacedBy(16.dp)
+            verticalArrangement = Arrangement.spacedBy(12.dp),
+            horizontalArrangement = Arrangement.spacedBy(12.dp)
         ) {
+            if (moduleBuildFileInfos.isNotEmpty()) {
+                item(span = { GridItemSpan(maxLineSpan) }) {
+                    ModulesSummaryCard(moduleBuildFileInfos = moduleBuildFileInfos)
+                }
+            }
+
             items(
                 items = moduleBuildFileInfos,
                 key = { module -> module.uniqueId }
@@ -82,7 +92,9 @@ fun ModulesTabContent(
                     plugins = module.plugins,
                     fileName = module.type.fileName,
                     dependencies = module.dependencies,
-                    projectName = projectName
+                    projectName = projectName,
+                    modulePath = module.modulePath,
+                    isRootBuildFile = module.isRootBuildFile
                 )
             }
 
@@ -100,6 +112,126 @@ fun ModulesTabContent(
     }
 }
 
+@Composable
+private fun ModulesSummaryCard(moduleBuildFileInfos: List<ModuleBuildFileInfo>) {
+    val totalSize = FolderFileUtils.formatSize(moduleBuildFileInfos.sumOf { it.sizeBytes })
+    val pluginCount = moduleBuildFileInfos.sumOf { it.plugins.size }
+    val dependencyCount = moduleBuildFileInfos.sumOf { it.dependencies.size }
+    val configurationCount = moduleBuildFileInfos
+        .flatMap { module -> module.plugins.map { it.configuration } + module.dependencies.map { it.configuration } }
+        .distinct()
+        .size
+
+    OutlinedCard(
+        modifier = Modifier.fillMaxWidth(),
+        colors = CardDefaults.outlinedCardColors(
+            containerColor = MaterialTheme.colorScheme.surface
+        )
+    ) {
+        Column(
+            modifier = Modifier.padding(16.dp),
+            verticalArrangement = Arrangement.spacedBy(12.dp)
+        ) {
+            Row(
+                modifier = Modifier.fillMaxWidth(),
+                verticalAlignment = Alignment.CenterVertically,
+                horizontalArrangement = Arrangement.spacedBy(10.dp)
+            ) {
+                Icon(
+                    Icons.Default.AccountTree,
+                    contentDescription = null,
+                    tint = MaterialTheme.colorScheme.primary,
+                    modifier = Modifier.size(24.dp)
+                )
+                Text(
+                    "Modules Overview",
+                    style = MaterialTheme.typography.titleLarge,
+                    fontWeight = FontWeight.Bold
+                )
+            }
+
+            Row(
+                modifier = Modifier.fillMaxWidth(),
+                horizontalArrangement = Arrangement.spacedBy(10.dp)
+            ) {
+                ModuleSummaryTile(
+                    label = "Modules",
+                    value = moduleBuildFileInfos.size.toString(),
+                    icon = Icons.Default.AccountTree,
+                    modifier = Modifier.weight(1f)
+                )
+                ModuleSummaryTile(
+                    label = "Total Size",
+                    value = totalSize,
+                    icon = Icons.Default.Folder,
+                    modifier = Modifier.weight(1f)
+                )
+                ModuleSummaryTile(
+                    label = "Plugins",
+                    value = pluginCount.toString(),
+                    icon = Icons.Default.Plumbing,
+                    modifier = Modifier.weight(1f)
+                )
+                ModuleSummaryTile(
+                    label = "Dependencies",
+                    value = dependencyCount.toString(),
+                    icon = Icons.Default.DataObject,
+                    modifier = Modifier.weight(1f)
+                )
+                ModuleSummaryTile(
+                    label = "Configurations",
+                    value = configurationCount.toString(),
+                    icon = Icons.Default.Extension,
+                    modifier = Modifier.weight(1f)
+                )
+            }
+        }
+    }
+}
+
+@Composable
+private fun ModuleSummaryTile(
+    label: String,
+    value: String,
+    icon: ImageVector,
+    modifier: Modifier = Modifier
+) {
+    Surface(
+        modifier = modifier,
+        color = MaterialTheme.colorScheme.surfaceVariant,
+        shape = MaterialTheme.shapes.medium
+    ) {
+        Row(
+            modifier = Modifier.padding(horizontal = 12.dp, vertical = 10.dp),
+            verticalAlignment = Alignment.CenterVertically,
+            horizontalArrangement = Arrangement.spacedBy(8.dp)
+        ) {
+            Icon(
+                icon,
+                contentDescription = null,
+                tint = MaterialTheme.colorScheme.primary,
+                modifier = Modifier.size(18.dp)
+            )
+            Column {
+                Text(
+                    value,
+                    style = MaterialTheme.typography.titleMedium,
+                    fontWeight = FontWeight.Bold,
+                    maxLines = 1,
+                    overflow = TextOverflow.Ellipsis
+                )
+                Text(
+                    label,
+                    style = MaterialTheme.typography.labelSmall,
+                    color = MaterialTheme.colorScheme.onSurfaceVariant,
+                    maxLines = 1,
+                    overflow = TextOverflow.Ellipsis
+                )
+            }
+        }
+    }
+}
+
 
 @Composable
 fun DetailedModuleCard(
@@ -109,6 +241,8 @@ fun DetailedModuleCard(
     plugins: List<Plugin>,
     dependencies: List<Dependency>,
     projectName: String,
+    modulePath: String,
+    isRootBuildFile: Boolean,
 ) {
 
     OutlinedCard(
@@ -119,9 +253,8 @@ fun DetailedModuleCard(
     ) {
         Column(
             modifier = Modifier.padding(20.dp),
-            verticalArrangement = Arrangement.spacedBy(12.dp)
+            verticalArrangement = Arrangement.spacedBy(10.dp)
         ) {
-            // Module header
             Row(
                 modifier = Modifier.fillMaxWidth(),
                 verticalAlignment = Alignment.CenterVertically
@@ -131,7 +264,14 @@ fun DetailedModuleCard(
                     imageVector = getModuleIcon(moduleName = moduleName, projectName = projectName),
                     contentDescription = moduleName,
                     tint = getModuleColor(moduleName = moduleName, projectName = projectName),
-                    modifier = Modifier.size(24.dp)
+                    modifier = Modifier
+                        .size(34.dp)
+                        .background(
+                            getModuleColor(moduleName = moduleName, projectName = projectName)
+                                .copy(alpha = 0.12f),
+                            CircleShape
+                        )
+                        .padding(7.dp)
                 )
                 Spacer(modifier = Modifier.width(12.dp))
                 Column(modifier = Modifier.weight(1f)) {
@@ -140,27 +280,48 @@ fun DetailedModuleCard(
                             .replaceFirstChar { it.uppercase() },
                         style = MaterialTheme.typography.titleMedium,
                         fontWeight = FontWeight.Bold,
+                        maxLines = 1,
+                        overflow = TextOverflow.Ellipsis
                     )
                     Text(
-                        text = fileName.replaceFirstChar { it.uppercase() },
-                        style = MaterialTheme.typography.bodyMedium,
-                        color = getModuleColor(moduleName = moduleName, projectName = projectName)
+                        text = modulePath.ifBlank { fileName }.replaceFirstChar { it.uppercase() },
+                        style = MaterialTheme.typography.bodySmall,
+                        color = MaterialTheme.colorScheme.onSurfaceVariant,
+                        maxLines = 1,
+                        overflow = TextOverflow.Ellipsis,
+                        textDecoration = TextDecoration.Underline,
+                        modifier = Modifier.pointerHoverIcon(
+                            PointerIcon(
+                                Cursor.getPredefinedCursor(
+                                    Cursor.HAND_CURSOR
+                                )
+                            )
+                        )
                     )
                 }
-                Surface(
-                    color = MaterialTheme.colorScheme.primaryContainer,
-                    shape = MaterialTheme.shapes.medium
-                ) {
-                    Text(
-                        text = sizeReadable,
-                        style = MaterialTheme.typography.labelLarge,
-                        fontWeight = FontWeight.Bold,
-                        modifier = Modifier.padding(horizontal = 12.dp, vertical = 6.dp)
-                    )
+                Column(horizontalAlignment = Alignment.End) {
+                    Surface(
+                        color = MaterialTheme.colorScheme.primaryContainer,
+                        shape = MaterialTheme.shapes.medium
+                    ) {
+                        Text(
+                            text = sizeReadable,
+                            style = MaterialTheme.typography.labelLarge,
+                            fontWeight = FontWeight.Bold,
+                            modifier = Modifier.padding(horizontal = 10.dp, vertical = 5.dp)
+                        )
+                    }
+                    if (isRootBuildFile) {
+                        Text(
+                            "Root",
+                            style = MaterialTheme.typography.labelSmall,
+                            color = MaterialTheme.colorScheme.primary,
+                            modifier = Modifier.padding(top = 4.dp)
+                        )
+                    }
                 }
             }
 
-            // Module stats in grid
             if (plugins.isNotEmpty() || dependencies.isNotEmpty()) {
                 Row(
                     modifier = Modifier.fillMaxWidth(),
@@ -437,4 +598,4 @@ fun ModuleRow(
             color = MaterialTheme.colorScheme.onSurfaceVariant
         )
     }
-}
+}