ruby_everywhere 0.3.0 → 0.4.0

data/support/mobile/android/app/src/main/res/drawable/ic_tab_placeholder.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  A deliberately blank 24dp drawable, and the only reason it exists:
+  `HotwireBottomTab.iconResId` is an `@DrawableRes Int`, so there is no way to
+  hand the controller the bitmap IconFont renders. `loadMenu()` calls
+  `setIcon(iconResId)` before we can intervene and an invalid id throws, so
+  every tab is built with this placeholder and MainActivity overwrites
+  `bottomNav.menu.getItem(i).icon` immediately after each `load()`.
+
+  It draws nothing rather than a fallback glyph because it is never meant to be
+  seen: if it ever shows up on a tab, the icon re-apply pass was skipped.
+
+  The transparent path below is REQUIRED, not decoration. A <vector> with no
+  <path> compiles cleanly through aapt2 and then throws
+  `XmlPullParserException: no path defined` when the device inflates it — which
+  means the crash lands in MainActivity.applyTabs at launch, on every app that
+  declares a tab, with a stack trace that names VectorDrawable rather than this
+  file. Keep a path here.
+-->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,0h24v24h-24z" />
+</vector>

data/support/mobile/android/app/src/main/res/layout/activity_main.xml

@@ -0,0 +1,116 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  FROZEN, and the reason MainTabs exists.
+
+  A HotwireBottomTab needs a real FragmentContainerView id, and NavigatorHost
+  resolves its configuration once in onCreate. Tabs, however, arrive at runtime
+  from the server's path configuration and are auth-gated, so the shell cannot
+  know how many there will be. The answer is a fixed pool: five hosts declared
+  here (Material bottom navigation tops out at five items anyway), with the
+  resolved tabs mapped onto them and every unused slot expressed as
+  `isVisible = false`.
+
+  Two rules follow from that and are enforced in MainTabs/MainActivity:
+    * navigatorConfigurations() must return a configuration for ALL FIVE hosts
+      on every launch, or NavigatorHost.onCreate throws IllegalStateException
+      for each slot it can't find one for.
+    * `lazyLoadTabs = true` is mandatory, or all five hosts cold-boot a WebView
+      and fetch their start location at launch — including the hidden,
+      auth-gated ones.
+
+  The splash overlay is a sibling of the hosts rather than a separate window
+  (iOS uses a second UIWindow): an Activity has one content view, and the
+  bottom navigation is rebuilt underneath the overlay, not around it.
+-->
+<androidx.constraintlayout.widget.ConstraintLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:id="@+id/root"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    tools:context=".MainActivity">
+
+    <androidx.fragment.app.FragmentContainerView
+        android:id="@+id/navigator_host_1"
+        android:name="dev.hotwire.navigation.navigator.NavigatorHost"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        app:defaultNavHost="false"
+        app:layout_constraintBottom_toTopOf="@id/bottom_nav"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <androidx.fragment.app.FragmentContainerView
+        android:id="@+id/navigator_host_2"
+        android:name="dev.hotwire.navigation.navigator.NavigatorHost"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        app:defaultNavHost="false"
+        app:layout_constraintBottom_toTopOf="@id/bottom_nav"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <androidx.fragment.app.FragmentContainerView
+        android:id="@+id/navigator_host_3"
+        android:name="dev.hotwire.navigation.navigator.NavigatorHost"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        app:defaultNavHost="false"
+        app:layout_constraintBottom_toTopOf="@id/bottom_nav"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <androidx.fragment.app.FragmentContainerView
+        android:id="@+id/navigator_host_4"
+        android:name="dev.hotwire.navigation.navigator.NavigatorHost"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        app:defaultNavHost="false"
+        app:layout_constraintBottom_toTopOf="@id/bottom_nav"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <androidx.fragment.app.FragmentContainerView
+        android:id="@+id/navigator_host_5"
+        android:name="dev.hotwire.navigation.navigator.NavigatorHost"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        app:defaultNavHost="false"
+        app:layout_constraintBottom_toTopOf="@id/bottom_nav"
+        app:layout_constraintTop_toTopOf="parent" />
+
+    <com.google.android.material.bottomnavigation.BottomNavigationView
+        android:id="@+id/bottom_nav"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        app:labelVisibilityMode="labeled"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent" />
+
+    <!--
+      Continues the themed launch background over the first page load, so the
+      app never shows a white gap while the first request is in flight. Sits
+      above everything, including the bottom navigation, and is removed by
+      MainActivity.dismissSplash().
+    -->
+    <FrameLayout
+        android:id="@+id/splash"
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        android:background="?android:attr/colorBackground"
+        android:clickable="true"
+        android:focusable="true"
+        android:elevation="16dp"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent">
+
+        <ProgressBar
+            android:id="@+id/splash_progress"
+            style="?android:attr/progressBarStyle"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:layout_gravity="center" />
+
+    </FrameLayout>
+
+</androidx.constraintlayout.widget.ConstraintLayout>

data/support/mobile/android/app/src/main/res/layout/bridge_menu_sheet.xml

@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Action sheet for the `everywhere` menu bridge component: both the `menu`
+  event (Everywhere.menu / data-everywhere-menu) and a nav item's pull-down.
+
+  Deliberately built from framework widgets and theme attributes only — no
+  colors.xml, no dimens.xml, no styles of its own. The rest of res/ belongs to
+  the shell template and is stamped per app, so anything this file referenced
+  there would be a second place a brand colour has to be right. Every colour
+  below comes from the running theme, which makes light and dark automatic.
+-->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:paddingTop="8dp"
+    android:paddingBottom="8dp">
+
+    <LinearLayout
+        android:id="@+id/bridge_menu_header"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:orientation="vertical"
+        android:paddingStart="24dp"
+        android:paddingEnd="24dp"
+        android:paddingTop="12dp"
+        android:paddingBottom="12dp">
+
+        <TextView
+            android:id="@+id/bridge_menu_title"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:textColor="?android:attr/textColorPrimary"
+            android:textSize="16sp"
+            android:textStyle="bold" />
+
+        <TextView
+            android:id="@+id/bridge_menu_message"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="4dp"
+            android:textColor="?android:attr/textColorSecondary"
+            android:textSize="14sp" />
+    </LinearLayout>
+
+    <ScrollView
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:scrollbarStyle="outsideOverlay">
+
+        <LinearLayout
+            android:id="@+id/bridge_menu_items"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical" />
+    </ScrollView>
+
+    <View
+        android:layout_width="match_parent"
+        android:layout_height="1dp"
+        android:layout_marginTop="8dp"
+        android:layout_marginBottom="8dp"
+        android:background="?android:attr/listDivider" />
+
+    <!--
+      Always present, like the cancel action iOS adds to every action sheet.
+      A pull-down menu simply ignores the resulting dismiss.
+    -->
+    <TextView
+        android:id="@+id/bridge_menu_cancel"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:background="?android:attr/selectableItemBackground"
+        android:clickable="true"
+        android:focusable="true"
+        android:gravity="center_vertical"
+        android:minHeight="56dp"
+        android:paddingStart="24dp"
+        android:paddingEnd="24dp"
+        android:text="@android:string/cancel"
+        android:textColor="?android:attr/textColorSecondary"
+        android:textSize="16sp" />
+</LinearLayout>

data/support/mobile/android/app/src/main/res/layout/bridge_menu_sheet_item.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  One row of the `everywhere` menu action sheet. The icon slot is kept (and
+  hidden rather than removed) whenever any sibling row has an icon, so a mixed
+  list still lines its titles up — the same alignment a UIMenu gives on iOS.
+
+  Theme attributes only; see bridge_menu_sheet.xml for why.
+-->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:background="?android:attr/selectableItemBackground"
+    android:clickable="true"
+    android:focusable="true"
+    android:gravity="center_vertical"
+    android:minHeight="56dp"
+    android:orientation="horizontal"
+    android:paddingStart="24dp"
+    android:paddingEnd="24dp">
+
+    <ImageView
+        android:id="@+id/bridge_menu_item_icon"
+        android:layout_width="24dp"
+        android:layout_height="24dp"
+        android:layout_marginEnd="24dp"
+        android:importantForAccessibility="no"
+        android:visibility="gone" />
+
+    <TextView
+        android:id="@+id/bridge_menu_item_title"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:textColor="?android:attr/textColorPrimary"
+        android:textSize="16sp" />
+</LinearLayout>

data/support/mobile/android/app/src/main/res/layout/tab_more_sheet.xml

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  The "More" tab's contents: every tab past the fourth, which Android's
+  BottomNavigationView has no room for and, unlike iOS's UITabBarController,
+  synthesises no home for. MainActivity fills this in from the arrangement.
+
+  Framework widgets and theme attributes only, no colors.xml and no styles of
+  its own. The rest of res/ belongs to the shell template and is stamped per
+  app, so anything referenced from here would be a second place a brand colour
+  has to be right. Every colour below comes from the running theme, which makes
+  light and dark automatic.
+-->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="vertical"
+    android:paddingTop="8dp"
+    android:paddingBottom="8dp">
+
+    <TextView
+        android:id="@+id/tab_more_sheet_title"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:paddingStart="24dp"
+        android:paddingEnd="24dp"
+        android:paddingTop="12dp"
+        android:paddingBottom="12dp"
+        android:textColor="?android:attr/textColorPrimary"
+        android:textSize="16sp"
+        android:textStyle="bold" />
+
+    <!--
+      Scrolls because the overflow has no upper bound: five tabs fit the bar,
+      and everything after that arrives here however many there are.
+    -->
+    <ScrollView
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:scrollbarStyle="outsideOverlay">
+
+        <LinearLayout
+            android:id="@+id/tab_more_sheet_items"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical" />
+    </ScrollView>
+
+</LinearLayout>

data/support/mobile/android/app/src/main/res/layout/tab_more_sheet_item.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  One overflow tab in the More sheet: its icon and its title, the same two
+  things it would have shown in the bar.
+
+  The icon slot is always present, never hidden, because every tab has an icon
+  (MainTabs defaults a missing one to `circle`, and the builder rejects a name
+  the font doesn't carry). Theme attributes only; see tab_more_sheet.xml.
+-->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:background="?android:attr/selectableItemBackground"
+    android:clickable="true"
+    android:focusable="true"
+    android:gravity="center_vertical"
+    android:minHeight="56dp"
+    android:orientation="horizontal"
+    android:paddingStart="24dp"
+    android:paddingEnd="24dp">
+
+    <ImageView
+        android:id="@+id/tab_more_sheet_item_icon"
+        android:layout_width="24dp"
+        android:layout_height="24dp"
+        android:layout_marginEnd="24dp"
+        android:importantForAccessibility="no" />
+
+    <TextView
+        android:id="@+id/tab_more_sheet_item_title"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:textColor="?android:attr/textColorPrimary"
+        android:textSize="16sp" />
+</LinearLayout>

data/support/mobile/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  minSdk 28 means every device that can install this app understands adaptive
+  icons, so there are no legacy mipmap-<dpi>/ic_launcher.png fallbacks to
+  generate — the two layers below are the whole launcher icon. The builder
+  stamps the layers, never this file.
+-->
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+    <monochrome android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

data/support/mobile/android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background" />
+    <foreground android:drawable="@drawable/ic_launcher_foreground" />
+    <monochrome android:drawable="@drawable/ic_launcher_foreground" />
+</adaptive-icon>

data/support/mobile/android/app/src/main/res/values/colors.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  STAMPED by `every build` for Android from `appearance.tint_color` and
+  `appearance.background_color`. The light half lives here, the dark half in
+  values-night/colors.xml — an app that gives a single hex gets the same value
+  written to both, which is exactly how iOS's ThemedColor collapses.
+
+  Everything else in the theme derives from these two, so branding an app is
+  two colours and nothing more.
+-->
+<resources>
+    <color name="everywhere_tint">#5321FC</color>
+    <color name="everywhere_background">#FFFFFF</color>
+
+    <color name="everywhere_on_tint">#FFFFFF</color>
+    <color name="everywhere_on_background">#000000</color>
+    <color name="everywhere_error">#B00020</color>
+    <color name="everywhere_on_error">#FFFFFF</color>
+
+    <color name="everywhere_transparent">#00000000</color>
+</resources>

data/support/mobile/android/app/src/main/res/values/ic_launcher_background.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- STAMPED: the adaptive icon's background layer. -->
+<resources>
+    <color name="ic_launcher_background">#5321FC</color>
+</resources>

data/support/mobile/android/app/src/main/res/values/strings.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  FROZEN. The app's own name is NOT here: it arrives as the
+  `everywhereLabel` manifest placeholder from everywhere.properties, so
+  renaming an app never touches a resource file. Only shell-owned UI strings
+  live here.
+-->
+<resources>
+    <string name="everywhere_auth_failed_title">Sign-in didn\'t finish</string>
+    <string name="everywhere_auth_failed_message">Something went wrong on the way back to the app. Please try again.</string>
+    <string name="everywhere_ok">OK</string>
+    <!--
+      The fifth bar item when an app declares more than five tabs, and the
+      heading of the sheet listing the rest. Matches what UITabBarController
+      names its own overflow tab on iOS.
+    -->
+    <string name="everywhere_more_tab">More</string>
+</resources>

data/support/mobile/android/app/src/main/res/values/styles.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- FROZEN. Component styles; all colour comes from the theme attributes. -->
+<resources>
+
+    <style name="Widget.Everywhere.BottomNavigationView" parent="Widget.MaterialComponents.BottomNavigationView">
+        <item name="android:background">?colorSurface</item>
+        <item name="itemBackground">?colorSurface</item>
+        <item name="backgroundTint">@null</item>
+        <item name="elevation">8dp</item>
+        <!-- Tab icons are runtime-rendered bitmaps (IconFont), so the tint has
+             to come from a ColorStateList the widget applies to whatever
+             Drawable it is handed — that is what makes a font-drawn glyph
+             respond to selection and to dark mode at all. -->
+        <item name="itemIconTint">@color/bottom_navigation_item</item>
+        <item name="itemTextColor">@color/bottom_navigation_item</item>
+        <item name="itemActiveIndicatorStyle">@style/Widget.Everywhere.BottomNavigationView.ActiveIndicator</item>
+    </style>
+
+    <style name="Widget.Everywhere.BottomNavigationView.ActiveIndicator" parent="">
+        <item name="android:width">64dp</item>
+        <item name="android:height">32dp</item>
+        <item name="marginHorizontal">4dp</item>
+        <item name="android:color">@color/bottom_navigation_active_indicator</item>
+    </style>
+
+    <style name="Widget.Everywhere.Toolbar" parent="Widget.MaterialComponents.Toolbar.Surface">
+        <item name="android:background">?colorSurface</item>
+        <item name="colorControlNormal">?colorOnSurface</item>
+        <item name="titleTextColor">?colorOnSurface</item>
+    </style>
+
+</resources>

data/support/mobile/android/app/src/main/res/values/themes.xml

@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  FROZEN. Everything visible derives from the two stamped colours in
+  colors.xml, so branding never edits a theme.
+
+  Parent is Theme.MaterialComponents, not Theme.Material3, on purpose:
+  navigation-fragments 1.3.0's own layouts style themselves with
+  TextAppearance.MaterialComponents.* and this is the combination the Phase 0
+  spike actually ran on a device.
+-->
+<resources xmlns:tools="http://schemas.android.com/tools">
+
+    <style name="Theme.Everywhere" parent="Theme.MaterialComponents.DayNight.NoActionBar">
+        <item name="colorPrimary">@color/everywhere_tint</item>
+        <item name="colorPrimaryVariant">@color/everywhere_tint</item>
+        <item name="colorSecondary">@color/everywhere_tint</item>
+        <item name="colorSecondaryVariant">@color/everywhere_tint</item>
+        <item name="colorAccent">@color/everywhere_tint</item>
+
+        <item name="android:colorBackground">@color/everywhere_background</item>
+        <item name="colorSurface">@color/everywhere_background</item>
+        <item name="colorError">@color/everywhere_error</item>
+
+        <item name="colorOnPrimary">@color/everywhere_on_tint</item>
+        <item name="colorOnSecondary">@color/everywhere_on_tint</item>
+        <item name="colorOnBackground">@color/everywhere_on_background</item>
+        <item name="colorOnSurface">@color/everywhere_on_background</item>
+        <item name="colorOnError">@color/everywhere_on_error</item>
+
+        <!-- Edge-to-edge: the bottom navigation applies the system-bar insets
+             itself (HotwireBottomNavigationController.applyWindowInsets). -->
+        <item name="android:statusBarColor">@color/everywhere_transparent</item>
+        <item name="android:navigationBarColor">@color/everywhere_transparent</item>
+        <item name="android:windowLightStatusBar">true</item>
+        <item name="android:windowLightNavigationBar" tools:ignore="NewApi">true</item>
+
+        <item name="elevationOverlayEnabled">false</item>
+        <item name="bottomNavigationStyle">@style/Widget.Everywhere.BottomNavigationView</item>
+        <item name="toolbarStyle">@style/Widget.Everywhere.Toolbar</item>
+    </style>
+
+    <!--
+      The Activity's launch theme. windowBackground is the stamped background
+      colour, so the system's starting window, the splash overlay in
+      activity_main.xml and the first rendered page are all the same colour and
+      the launch reads as one continuous surface. MainActivity swaps to
+      Theme.Everywhere in onCreate, before setContentView.
+    -->
+    <style name="Theme.Everywhere.Splash" parent="Theme.Everywhere">
+        <item name="android:windowBackground">@color/everywhere_background</item>
+    </style>
+
+</resources>

data/support/mobile/android/app/src/main/res/values-night/colors.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- STAMPED — the dark half of appearance.tint_color / background_color. -->
+<resources>
+    <color name="everywhere_tint">#7A75FF</color>
+    <color name="everywhere_background">#121212</color>
+
+    <color name="everywhere_on_tint">#000000</color>
+    <color name="everywhere_on_background">#FFFFFF</color>
+    <color name="everywhere_error">#CF6679</color>
+    <color name="everywhere_on_error">#000000</color>
+</resources>

data/support/mobile/android/app/src/main/res/values-night/themes.xml

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  The colours themselves come from values-night/colors.xml, so the only thing
+  that changes here is which system-bar icon set stays legible.
+-->
+<resources>
+    <style name="Theme.Everywhere" parent="Theme.MaterialComponents.DayNight.NoActionBar">
+        <item name="colorPrimary">@color/everywhere_tint</item>
+        <item name="colorPrimaryVariant">@color/everywhere_tint</item>
+        <item name="colorSecondary">@color/everywhere_tint</item>
+        <item name="colorSecondaryVariant">@color/everywhere_tint</item>
+        <item name="colorAccent">@color/everywhere_tint</item>
+
+        <item name="android:colorBackground">@color/everywhere_background</item>
+        <item name="colorSurface">@color/everywhere_background</item>
+        <item name="colorError">@color/everywhere_error</item>
+
+        <item name="colorOnPrimary">@color/everywhere_on_tint</item>
+        <item name="colorOnSecondary">@color/everywhere_on_tint</item>
+        <item name="colorOnBackground">@color/everywhere_on_background</item>
+        <item name="colorOnSurface">@color/everywhere_on_background</item>
+        <item name="colorOnError">@color/everywhere_on_error</item>
+
+        <item name="android:statusBarColor">@color/everywhere_transparent</item>
+        <item name="android:navigationBarColor">@color/everywhere_transparent</item>
+        <item name="android:windowLightStatusBar">false</item>
+        <item name="android:windowLightNavigationBar">false</item>
+
+        <item name="elevationOverlayEnabled">false</item>
+        <item name="bottomNavigationStyle">@style/Widget.Everywhere.BottomNavigationView</item>
+        <item name="toolbarStyle">@style/Widget.Everywhere.Toolbar</item>
+    </style>
+</resources>

data/support/mobile/android/app/src/main/res/xml/network_security_config.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Release baseline: no cleartext, anywhere. The debug build type overlays
+  src/debug/res/xml/network_security_config.xml over this file (same resource
+  name, build-type source set wins), which opens up loopback and the emulator's
+  host alias for `every dev` for Android. Overlaying the resource rather than the
+  manifest attribute keeps src/main/AndroidManifest.xml frozen and leaves the
+  build type's manifest slot free for src/stamped/AndroidManifest.xml.
+-->
+<network-security-config>
+    <base-config cleartextTrafficPermitted="false" />
+</network-security-config>

data/support/mobile/android/app/src/stamped/AndroidManifest.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  GENERATED by `every build` for Android. The checked-in copy is empty so the raw
+  template builds unchanged; the CLI rewrites it whenever everywhere.yml
+  declares `deep_linking:`, `auth:` or `permissions:`.
+
+  It is applied as BOTH build types' manifest (see app/build.gradle.kts) rather
+  than being folded into the main manifest, so the frozen file above never
+  needs editing — the analogue of iOS's optional App.entitlements.
+
+  Generated content looks like:
+
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+
+    <application>
+      <activity android:name="com.rubyeverywhere.shell.MainActivity">
+        <intent-filter android:autoVerify="true">
+          <action android:name="android.intent.action.VIEW" />
+          <category android:name="android.intent.category.DEFAULT" />
+          <category android:name="android.intent.category.BROWSABLE" />
+          <data android:scheme="https" android:host="example.com" />
+        </intent-filter>
+        <intent-filter>
+          <action android:name="android.intent.action.VIEW" />
+          <category android:name="android.intent.category.DEFAULT" />
+          <category android:name="android.intent.category.BROWSABLE" />
+          <data android:scheme="com.example.app" />
+        </intent-filter>
+      </activity>
+    </application>
+-->
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application />
+</manifest>

data/support/mobile/android/build.gradle.kts

@@ -0,0 +1,8 @@
+// Top-level build file. Plugin versions are pinned here, once, for every
+// module — the analogue of the iOS template's committed `Package.resolved`.
+// Moving a pin is a deliberate edit to this template, never to a stamped copy.
+plugins {
+    id("com.android.application") version "8.13.2" apply false
+    id("org.jetbrains.kotlin.android") version "2.3.0" apply false
+    id("org.jetbrains.kotlin.plugin.serialization") version "2.3.0" apply false
+}

data/support/mobile/android/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,10 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+# `-bin`, not `-all`: the `-all` distribution unpacks to 522 MB in
+# GRADLE_USER_HOME and the extra 500 MB is Gradle's own sources and javadoc,
+# which only an IDE indexing the Gradle API ever reads. The CLI never does.
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.0-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

data/support/mobile/android/gradle.properties

@@ -0,0 +1,14 @@
+# Frozen build settings. Nothing per-app lives here — see app/everywhere.properties.
+
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+org.gradle.caching=true
+
+# Off deliberately. The configuration cache serialises the whole build model,
+# and `app/build.gradle.kts` reads `everywhere.properties` at configuration
+# time — a file the CLI rewrites on every build. Gradle would have to
+# invalidate the cache each run anyway, so it buys nothing and hides staleness.
+org.gradle.configuration-cache=false
+
+android.useAndroidX=true
+android.nonTransitiveRClass=true
+kotlin.code.style=official