Skip to content

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

feat(ui): shared Podroid composable primitives

ExTv71ab69daf0b9
diff --git a/app/src/main/java/com/excp/podroid/ui/components/PodroidButtons.kt b/app/src/main/java/com/excp/podroid/ui/components/PodroidButtons.kt
new file mode 100644
index 0000000..6074201
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/PodroidButtons.kt
@@ -0,0 +1,99 @@
+package com.excp.podroid.ui.components
+
+import androidx.compose.foundation.BorderStroke
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.material3.Button
+import androidx.compose.material3.ButtonDefaults
+import androidx.compose.material3.Icon
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedButton
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.dp
+import com.excp.podroid.ui.theme.PodroidTokens
+
+@Composable
+fun PodroidPrimaryButton(
+ text: String,
+ onClick: () -> Unit,
+ modifier: Modifier = Modifier,
+ icon: ImageVector? = null,
+ enabled: Boolean = true,
+) {
+ Button(
+ onClick = onClick,
+ enabled = enabled,
+ modifier = modifier.fillMaxWidth().height(44.dp),
+ shape = RoundedCornerShape(PodroidTokens.Radius.Button),
+ colors = ButtonDefaults.buttonColors(
+ containerColor = PodroidTokens.Accent,
+ contentColor = PodroidTokens.AccentInk,
+ ),
+ ) {
+ if (icon != null) {
+ Icon(icon, contentDescription = null, modifier = Modifier.size(18.dp))
+ Spacer(Modifier.width(PodroidTokens.Spacing.SM))
+ }
+ Text(text, style = MaterialTheme.typography.titleMedium, fontWeight = FontWeight.Medium)
+ }
+}
+
+@Composable
+fun PodroidGhostButton(
+ text: String,
+ onClick: () -> Unit,
+ modifier: Modifier = Modifier,
+ icon: ImageVector? = null,
+ enabled: Boolean = true,
+) {
+ OutlinedButton(
+ onClick = onClick,
+ enabled = enabled,
+ modifier = modifier.fillMaxWidth().height(44.dp),
+ shape = RoundedCornerShape(PodroidTokens.Radius.Button),
+ border = BorderStroke(1.dp, MaterialTheme.colorScheme.outline),
+ colors = ButtonDefaults.outlinedButtonColors(
+ contentColor = MaterialTheme.colorScheme.onSurface,
+ ),
+ ) {
+ if (icon != null) {
+ Icon(icon, contentDescription = null, modifier = Modifier.size(18.dp))
+ Spacer(Modifier.width(PodroidTokens.Spacing.SM))
+ }
+ Text(text, style = MaterialTheme.typography.titleMedium, fontWeight = FontWeight.Medium)
+ }
+}
+
+@Composable
+fun PodroidDestructiveButton(
+ text: String,
+ onClick: () -> Unit,
+ modifier: Modifier = Modifier,
+ icon: ImageVector? = null,
+ enabled: Boolean = true,
+) {
+ OutlinedButton(
+ onClick = onClick,
+ enabled = enabled,
+ modifier = modifier.fillMaxWidth().height(44.dp),
+ shape = RoundedCornerShape(PodroidTokens.Radius.Button),
+ border = BorderStroke(1.dp, PodroidTokens.Red.copy(alpha = 0.5f)),
+ colors = ButtonDefaults.outlinedButtonColors(
+ contentColor = PodroidTokens.Red,
+ ),
+ ) {
+ if (icon != null) {
+ Icon(icon, contentDescription = null, modifier = Modifier.size(18.dp))
+ Spacer(Modifier.width(PodroidTokens.Spacing.SM))
+ }
+ Text(text, style = MaterialTheme.typography.titleMedium, fontWeight = FontWeight.Medium)
+ }
+}
diff --git a/app/src/main/java/com/excp/podroid/ui/components/PodroidChip.kt b/app/src/main/java/com/excp/podroid/ui/components/PodroidChip.kt
new file mode 100644
index 0000000..4d861ac
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/PodroidChip.kt
@@ -0,0 +1,31 @@
+package com.excp.podroid.ui.components
+
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.FilterChipDefaults
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.SelectableChipColors
+import androidx.compose.runtime.Composable
+import com.excp.podroid.ui.theme.PodroidTokens
+
+/**
+ * Shared FilterChip color scheme. Used wherever Material3 FilterChip appears so
+ * every selection chip in the app behaves identically:
+ *
+ * - Unselected: filled surface fill (button-like, not outline-only), neutral text
+ * - Selected: lime accent fill, accent-ink text — pops at a glance
+ * - Disabled: same shapes, just dimmer — keeps the selection still recognizable
+ * (M3's default disabled state nukes the accent entirely, which
+ * makes a "selected but locked" chip indistinguishable from the
+ * others)
+ */
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun podroidChipColors(): SelectableChipColors = FilterChipDefaults.filterChipColors(
+ containerColor = MaterialTheme.colorScheme.surfaceVariant,
+ labelColor = MaterialTheme.colorScheme.onSurface,
+ selectedContainerColor = PodroidTokens.Accent,
+ selectedLabelColor = PodroidTokens.AccentInk,
+ disabledContainerColor = MaterialTheme.colorScheme.surfaceVariant,
+ disabledLabelColor = MaterialTheme.colorScheme.onSurfaceVariant,
+ disabledSelectedContainerColor = PodroidTokens.Accent.copy(alpha = 0.45f),
+)
diff --git a/app/src/main/java/com/excp/podroid/ui/components/PodroidInlineAction.kt b/app/src/main/java/com/excp/podroid/ui/components/PodroidInlineAction.kt
new file mode 100644
index 0000000..ac2380d
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/PodroidInlineAction.kt
@@ -0,0 +1,38 @@
+package com.excp.podroid.ui.components
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.dp
+import com.excp.podroid.ui.theme.PodroidTokens
+
+/**
+ * Small filled pill — used as the right-side action affordance inside a
+ * PodroidListRow when the row hosts a CTA (e.g. "+ Add" for port forwards).
+ * Reads as a button, not as a chevron or static text.
+ */
+@Composable
+fun PodroidInlineAction(
+ label: String,
+ onClick: () -> Unit,
+ modifier: Modifier = Modifier,
+) {
+ Text(
+ text = label,
+ style = MaterialTheme.typography.labelMedium,
+ color = PodroidTokens.AccentInk,
+ fontWeight = FontWeight.SemiBold,
+ modifier = modifier
+ .clip(RoundedCornerShape(PodroidTokens.Radius.Chip))
+ .background(PodroidTokens.Accent)
+ .clickable(onClick = onClick)
+ .padding(horizontal = 12.dp, vertical = 6.dp),
+ )
+}
diff --git a/app/src/main/java/com/excp/podroid/ui/components/PodroidListRow.kt b/app/src/main/java/com/excp/podroid/ui/components/PodroidListRow.kt
new file mode 100644
index 0000000..1e08332
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/PodroidListRow.kt
@@ -0,0 +1,80 @@
+package com.excp.podroid.ui.components
+
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.width
+import androidx.compose.material3.HorizontalDivider
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.text.font.FontFamily
+import androidx.compose.ui.unit.dp
+import com.excp.podroid.ui.theme.PodroidTokens
+
+/**
+ * Canonical horizontal row used across Home, Settings, Setup, drawer, picker.
+ * label = left, value = right, 1 px bottom divider drawn unless `divider = false`.
+ *
+ * `mono = true` renders the value in JetBrains Mono — for IPs, ports, paths.
+ * `onClick` makes the row tappable (Settings rows that open a sub-screen pass
+ * `value = "Dracula"` + `trailing = "›"`).
+ */
+@Composable
+fun PodroidListRow(
+ label: String,
+ modifier: Modifier = Modifier,
+ value: String? = null,
+ trailing: String? = null,
+ mono: Boolean = false,
+ onClick: (() -> Unit)? = null,
+ divider: Boolean = true,
+ rightSlot: @Composable (() -> Unit)? = null,
+) {
+ val rowMod = modifier
+ .fillMaxWidth()
+ .then(if (onClick != null) Modifier.clickable(onClick = onClick) else Modifier)
+ .padding(vertical = PodroidTokens.Spacing.MD)
+
+ Row(
+ modifier = rowMod,
+ verticalAlignment = Alignment.CenterVertically,
+ horizontalArrangement = Arrangement.SpaceBetween,
+ ) {
+ Text(
+ text = label,
+ style = MaterialTheme.typography.bodyMedium,
+ color = MaterialTheme.colorScheme.onSurface,
+ modifier = Modifier.weight(1f),
+ )
+ if (rightSlot != null) {
+ rightSlot()
+ } else if (value != null) {
+ Text(
+ text = value,
+ style = MaterialTheme.typography.bodyMedium,
+ color = MaterialTheme.colorScheme.onSurfaceVariant,
+ fontFamily = if (mono) PodroidTokens.mono() else FontFamily.Default,
+ )
+ if (trailing != null) {
+ Spacer(Modifier.width(PodroidTokens.Spacing.SM))
+ Text(
+ text = trailing,
+ style = MaterialTheme.typography.bodyMedium,
+ color = MaterialTheme.colorScheme.onSurfaceVariant,
+ )
+ }
+ }
+ }
+ if (divider) {
+ HorizontalDivider(
+ color = MaterialTheme.colorScheme.outline,
+ thickness = 1.dp,
+ )
+ }
+}
diff --git a/app/src/main/java/com/excp/podroid/ui/components/PodroidSectionLabel.kt b/app/src/main/java/com/excp/podroid/ui/components/PodroidSectionLabel.kt
new file mode 100644
index 0000000..9b22126
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/PodroidSectionLabel.kt
@@ -0,0 +1,29 @@
+package com.excp.podroid.ui.components
+
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.text.font.FontWeight
+import com.excp.podroid.ui.theme.PodroidTokens
+
+/**
+ * Tiny uppercase tracked label used as a section heading throughout the app.
+ * Pairs naturally with PodroidListRow groups.
+ */
+@Composable
+fun PodroidSectionLabel(
+ text: String,
+ modifier: Modifier = Modifier,
+) {
+ Text(
+ text = text.uppercase(),
+ style = MaterialTheme.typography.labelMedium,
+ color = MaterialTheme.colorScheme.onSurfaceVariant,
+ fontFamily = PodroidTokens.ui(),
+ fontWeight = FontWeight.Medium,
+ modifier = modifier
+ .padding(top = PodroidTokens.Spacing.LG, bottom = PodroidTokens.Spacing.XS),
+ )
+}
diff --git a/app/src/main/java/com/excp/podroid/ui/components/PodroidStatus.kt b/app/src/main/java/com/excp/podroid/ui/components/PodroidStatus.kt
new file mode 100644
index 0000000..fad14c1
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/PodroidStatus.kt
@@ -0,0 +1,55 @@
+package com.excp.podroid.ui.components
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.shape.CircleShape
+import androidx.compose.material3.MaterialTheme
+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.graphics.Color
+import androidx.compose.ui.unit.dp
+import com.excp.podroid.ui.theme.PodroidTokens
+
+/**
+ * Colored dot + label — used in Home meta row, top bars, anywhere status
+ * needs to be conveyed at a glance. The dot color is decoupled from the
+ * accent so a stopped state stays grey even on a lime-themed app.
+ */
+@Composable
+fun PodroidStatus(
+ label: String,
+ dotColor: Color,
+ modifier: Modifier = Modifier,
+) {
+ Row(
+ modifier = modifier,
+ verticalAlignment = Alignment.CenterVertically,
+ ) {
+ Box(
+ modifier = Modifier
+ .size(6.dp)
+ .clip(CircleShape)
+ .background(dotColor),
+ )
+ Spacer(Modifier.width(PodroidTokens.Spacing.SM))
+ Text(
+ text = label,
+ style = MaterialTheme.typography.bodyMedium,
+ color = MaterialTheme.colorScheme.onSurfaceVariant,
+ )
+ }
+}
+
+object PodroidStatusColors {
+ val Running = PodroidTokens.Accent
+ val Starting = PodroidTokens.Amber
+ val Stopped = Color(0xFF737373)
+ val Error = PodroidTokens.Red
+}
diff --git a/app/src/main/java/com/excp/podroid/ui/components/PodroidSwitch.kt b/app/src/main/java/com/excp/podroid/ui/components/PodroidSwitch.kt
new file mode 100644
index 0000000..a2440c4
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/PodroidSwitch.kt
@@ -0,0 +1,36 @@
+package com.excp.podroid.ui.components
+
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Switch
+import androidx.compose.material3.SwitchDefaults
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import com.excp.podroid.ui.theme.PodroidTokens
+
+/**
+ * Switch wrapper that locks the colors to the Podroid palette. Material 3's
+ * default Switch picks up `colorScheme.primary` already — this is mostly for
+ * the muted-track look in the "off" state.
+ */
+@Composable
+fun PodroidSwitch(
+ checked: Boolean,
+ onCheckedChange: (Boolean) -> Unit,
+ modifier: Modifier = Modifier,
+ enabled: Boolean = true,
+) {
+ Switch(
+ checked = checked,
+ onCheckedChange = onCheckedChange,
+ enabled = enabled,
+ modifier = modifier,
+ colors = SwitchDefaults.colors(
+ checkedThumbColor = PodroidTokens.AccentInk,
+ checkedTrackColor = PodroidTokens.Accent,
+ checkedBorderColor = PodroidTokens.Accent,
+ uncheckedThumbColor = MaterialTheme.colorScheme.onSurfaceVariant,
+ uncheckedTrackColor = MaterialTheme.colorScheme.surfaceVariant,
+ uncheckedBorderColor = MaterialTheme.colorScheme.outline,
+ ),
+ )
+}
diff --git a/app/src/main/java/com/excp/podroid/ui/components/PodroidTopBar.kt b/app/src/main/java/com/excp/podroid/ui/components/PodroidTopBar.kt
new file mode 100644
index 0000000..6b6cd25
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/PodroidTopBar.kt
@@ -0,0 +1,53 @@
+package com.excp.podroid.ui.components
+
+import androidx.compose.foundation.layout.Column
+import androidx.compose.material3.ExperimentalMaterial3Api
+import androidx.compose.material3.HorizontalDivider
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Text
+import androidx.compose.material3.TopAppBar
+import androidx.compose.material3.TopAppBarColors
+import androidx.compose.material3.TopAppBarDefaults
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.unit.dp
+
+/**
+ * Material3 TopAppBar wrapped with the Podroid palette: surface background,
+ * 1-px bottom border, medium-weight title. Keeps the standard Compose-Nav
+ * navigationIcon + actions slots.
+ */
+@OptIn(ExperimentalMaterial3Api::class)
+@Composable
+fun PodroidTopBar(
+ title: String,
+ modifier: Modifier = Modifier,
+ navigationIcon: @Composable () -> Unit = {},
+ actions: @Composable androidx.compose.foundation.layout.RowScope.() -> Unit = {},
+ colors: TopAppBarColors = TopAppBarDefaults.topAppBarColors(
+ containerColor = MaterialTheme.colorScheme.surface,
+ navigationIconContentColor = MaterialTheme.colorScheme.onSurface,
+ titleContentColor = MaterialTheme.colorScheme.onSurface,
+ actionIconContentColor = MaterialTheme.colorScheme.onSurfaceVariant,
+ ),
+) {
+ Column(modifier = modifier) {
+ TopAppBar(
+ title = {
+ Text(
+ text = title,
+ style = MaterialTheme.typography.titleMedium,
+ fontWeight = FontWeight.Medium,
+ )
+ },
+ navigationIcon = navigationIcon,
+ actions = actions,
+ colors = colors,
+ )
+ HorizontalDivider(
+ color = MaterialTheme.colorScheme.outline,
+ thickness = 1.dp,
+ )
+ }
+}