diff --git a/app.json b/app.json
index 2ea1169..e0223b4 100644
--- a/app.json
+++ b/app.json
@@ -73,6 +73,7 @@
       "./plugins/withIOSNetworkSecurity.js",
       "./plugins/withNetworkSecurityConfig.js",
       "./plugins/withAndroidLocalNetworkSsl.js",
+      "./plugins/withTermixWidgets.js",
       "expo-dev-client",
       "expo-secure-store",
       "expo-web-browser"
@@ -89,9 +90,7 @@
         "projectId": "cf86f530-ca4b-44bf-bb68-4d178b264910"
       }
     },
-    "assetBundlePatterns": [
-      "assets/**/*"
-    ],
+    "assetBundlePatterns": ["assets/**/*"],
     "owner": "termix"
   }
 }
diff --git a/app/AppContext.tsx b/app/AppContext.tsx
index 707b18a..1312240 100644
--- a/app/AppContext.tsx
+++ b/app/AppContext.tsx
@@ -17,6 +17,7 @@ import {
   getCurrentServerUrl,
 } from "./main-axios";
 import Constants from "expo-constants";
+import { publishSignedOutSnapshot } from "@/app/widgets";
 
 interface Server {
   name: string;
@@ -183,6 +184,14 @@ export const AppProvider: React.FC<AppProviderProps> = ({ children }) => {
     });
   }, []);
 
+  // Losing authentication (sign-out elsewhere, expired token, server change)
+  // must also empty the home-screen widgets — they would otherwise keep showing
+  // host names the user can no longer reach.
+  useEffect(() => {
+    if (isLoading || isAuthenticated) return;
+    void publishSignedOutSnapshot();
+  }, [isAuthenticated, isLoading]);
+
   const lastValidationTimeRef = useRef<number>(0);
   const validationInProgressRef = useRef<boolean>(false);
 
diff --git a/app/_layout.tsx b/app/_layout.tsx
index a26d336..4d3f021 100644
--- a/app/_layout.tsx
+++ b/app/_layout.tsx
@@ -21,6 +21,7 @@ import { useFonts } from "expo-font";
 import { FONT_MAP, MONO_FONT, MONO_FONT_BOLD } from "./constants/fonts";
 import "../global.css";
 import UpdateRequired from "@/app/authentication/UpdateRequired";
+import { WidgetDeepLinkHost } from "@/app/widgets";
 
 function RootLayoutContent() {
   const {
@@ -71,6 +72,10 @@ function RootLayoutContent() {
         <Stack.Screen name="index" options={{ headerShown: false }} />
         <Stack.Screen name="(tabs)" options={{ headerShown: false }} />
       </Stack>
+      {/* Home-screen widget taps: session navigation and the snippet run
+          sheet. Mounted here so it is active for the whole session, including
+          cold starts from a widget. */}
+      <WidgetDeepLinkHost />
       <AppLockGate />
       {authFlowVisible ? (
         <View className="absolute inset-0 bg-background">
diff --git a/app/tabs/hosts/Hosts.tsx b/app/tabs/hosts/Hosts.tsx
index bc23c40..a9d5b53 100644
--- a/app/tabs/hosts/Hosts.tsx
+++ b/app/tabs/hosts/Hosts.tsx
@@ -7,6 +7,7 @@ import {
 } from "react-native";
 import { useState, useCallback, useRef, useMemo, useEffect } from "react";
 import { useFocusEffect } from "@react-navigation/native";
+import { useRouter } from "expo-router";
 import AsyncStorage from "@react-native-async-storage/async-storage";
 import {
   RefreshCw,
@@ -18,6 +19,7 @@ import {
   Zap,
   Plus,
   KeyRound,
+  FileText,
 } from "lucide-react-native";
 import HostTree from "@/app/tabs/hosts/navigation/Folder";
 import type { HostMetrics } from "@/app/tabs/hosts/navigation/Host";
@@ -34,8 +36,10 @@ import {
   getCurrentServerUrl,
   deleteSSHHost,
   createSSHHost,
+  getSnippets,
 } from "@/app/main-axios";
-import { SSHHost, ServerStatus } from "@/types";
+import { SSHHost, ServerStatus, Snippet } from "@/types";
+import { publishHostSnapshot } from "@/app/widgets";
 import { Screen } from "@/app/components/Screen";
 import {
   Text,
@@ -115,6 +119,7 @@ const STORAGE_EXPANDED = "hostExpandedFolders";
 
 export default function Hosts() {
   const color = useThemeColor();
+  const router = useRouter();
   const [hosts, setHosts] = useState<SSHHost[]>([]);
   const [folderColors, setFolderColors] = useState<
     Record<string, string | undefined>
@@ -126,6 +131,10 @@ export default function Hosts() {
     Record<number, ServerStatus>
   >({});
   const [metrics, setMetrics] = useState<Record<number, HostMetrics>>({});
+  // Snippets are fetched here purely to feed the home-screen widget; the list
+  // itself lives under Settings. `null` means "not fetched yet", which keeps a
+  // failed fetch from wiping snippets the Snippets screen already published.
+  const [snippets, setSnippets] = useState<Snippet[] | null>(null);
   const [sortKey, setSortKey] = useState<SortKey>("default");
   const [filterState, setFilterState] = useState<FilterState>(DEFAULT_FILTERS);
   const [expandedPaths, setExpandedPaths] = useState<Set<string>>(new Set());
@@ -215,10 +224,12 @@ export default function Hosts() {
           return;
         }
 
-        const [hostsResult, statusesResult] = await Promise.allSettled([
-          getSSHHosts(),
-          getAllServerStatuses(),
-        ]);
+        const [hostsResult, statusesResult, snippetsResult] =
+          await Promise.allSettled([
+            getSSHHosts(),
+            getAllServerStatuses(),
+            getSnippets(),
+          ]);
 
         if (hostsResult.status !== "fulfilled") throw hostsResult.reason;
 
@@ -248,6 +259,13 @@ export default function Hosts() {
         setFolderColors(colors);
         setServerStatuses(statuses);
 
+        if (
+          snippetsResult.status === "fulfilled" &&
+          Array.isArray(snippetsResult.value)
+        ) {
+          setSnippets(snippetsResult.value as Snippet[]);
+        }
+
         // Best-effort live metrics for online hosts only.
         void fetchMetrics(hostList, statuses);
       } catch (error: any) {
@@ -276,6 +294,21 @@ export default function Hosts() {
     }, [fetchData]),
   );
 
+  // Keep the home-screen widgets in sync with whatever this screen shows. The
+  // publisher throttles and de-dupes, so re-running on every data change is
+  // cheap. This screen only renders for an authenticated user.
+  useEffect(() => {
+    if (loading) return;
+    void publishHostSnapshot({
+      hosts,
+      statuses: serverStatuses,
+      metrics,
+      snippets: snippets ?? undefined,
+      serverUrl: getCurrentServerUrl(),
+      authenticated: true,
+    });
+  }, [loading, hosts, serverStatuses, metrics, snippets]);
+
   // --- Build, sort, and filter the tree.
   const tree = useMemo(
     () => buildHostTree(hosts, folderColors),
@@ -437,54 +470,35 @@ export default function Hosts() {
           <Button
             variant="ghost"
             size="icon"
+            accessibilityLabel="Add host"
             onPress={openCreate}
             icon={<Plus size={20} color={color("muted-foreground")} />}
           />
           <Button
             variant="ghost"
             size="icon"
-            onPress={() => setCredentialListOpen(true)}
-            icon={<KeyRound size={18} color={color("muted-foreground")} />}
-          />
-          <Button
-            variant="ghost"
-            size="icon"
-            onPress={() => setQuickConnectOpen(true)}
-            icon={<Zap size={18} color={color("muted-foreground")} />}
+            accessibilityLabel="Snippets"
+            onPress={() => router.push("/tabs/settings/Snippets" as never)}
+            icon={<FileText size={18} color={color("muted-foreground")} />}
           />
           <Button
             variant="ghost"
             size="icon"
-            onPress={() => setShowFilter(true)}
-            icon={
-              <Filter
-                size={18}
-                color={
-                  isFilterActive
-                    ? color("accent-brand")
-                    : color("muted-foreground")
-                }
-              />
-            }
+            accessibilityLabel="Credentials"
+            onPress={() => setCredentialListOpen(true)}
+            icon={<KeyRound size={18} color={color("muted-foreground")} />}
           />
           <Button
             variant="ghost"
             size="icon"
-            onPress={() => setShowSort(true)}
-            icon={
-              <ArrowUpDown
-                size={18}
-                color={
-                  sortKey !== "default"
-                    ? color("accent-brand")
-                    : color("muted-foreground")
-                }
-              />
-            }
+            accessibilityLabel="Quick connect"
+            onPress={() => setQuickConnectOpen(true)}
+            icon={<Zap size={18} color={color("muted-foreground")} />}
           />
           <Button
             variant="ghost"
             size="icon"
+            accessibilityLabel="Refresh hosts"
             onPress={handleRefresh}
             disabled={refreshing}
             icon={
@@ -500,8 +514,12 @@ export default function Hosts() {
         </View>
       }
     >
-      <View className="px-4 pb-2 pt-3">
+      {/* Search plus the two controls that shape the list. Keeping sort and
+          filter here (rather than in the header) leaves room for the title on
+          small screens and puts them next to the query they refine. */}
+      <View className="flex-row items-center gap-1.5 px-4 pb-2 pt-3">
         <Input
+          containerClassName="flex-1"
           placeholder="Search hosts…"
           value={searchQuery}
           onChangeText={setSearchQuery}
@@ -516,6 +534,38 @@ export default function Hosts() {
             ) : undefined
           }
         />
+        <Button
+          variant="outline"
+          size="icon"
+          accessibilityLabel="Filter hosts"
+          onPress={() => setShowFilter(true)}
+          icon={
+            <Filter
+              size={18}
+              color={
+                isFilterActive
+                  ? color("accent-brand")
+                  : color("muted-foreground")
+              }
+            />
+          }
+        />
+        <Button
+          variant="outline"
+          size="icon"
+          accessibilityLabel="Sort hosts"
+          onPress={() => setShowSort(true)}
+          icon={
+            <ArrowUpDown
+              size={18}
+              color={
+                sortKey !== "default"
+                  ? color("accent-brand")
+                  : color("muted-foreground")
+              }
+            />
+          }
+        />
       </View>
 
       {loading ? (
diff --git a/app/tabs/settings/Settings.tsx b/app/tabs/settings/Settings.tsx
index d1a2c31..34d5f5d 100644
--- a/app/tabs/settings/Settings.tsx
+++ b/app/tabs/settings/Settings.tsx
@@ -15,6 +15,7 @@ import {
   Monitor,
   Key,
   FileText,
+  LayoutGrid,
 } from "lucide-react-native";
 import { useAppContext } from "@/app/AppContext";
 import { useTerminalSessions } from "@/app/contexts/TerminalSessionsContext";
@@ -46,6 +47,16 @@ import {
   type ThemeId,
 } from "@/app/constants/theme";
 import { toast } from "@/app/utils/toast";
+import {
+  DEFAULT_WIDGET_PREFERENCES,
+  isWidgetSupported,
+  loadWidgetPreferences,
+  publishSignedOutSnapshot,
+  republishWithPreferences,
+  resetWidgets,
+  saveWidgetPreferences,
+  type WidgetPreferences,
+} from "@/app/widgets";
 
 export default function Settings() {
   const router = useRouter();
@@ -73,6 +84,29 @@ export default function Settings() {
   );
   const [open, setOpen] = useState<string | null>("appearance");
 
+  // Home-screen widget preferences (no-ops on builds without widget support).
+  const [widgetPrefs, setWidgetPrefs] = useState<WidgetPreferences>(
+    DEFAULT_WIDGET_PREFERENCES,
+  );
+
+  useEffect(() => {
+    if (!isWidgetSupported) return;
+    loadWidgetPreferences()
+      .then(setWidgetPrefs)
+      .catch(() => {});
+  }, []);
+
+  const updateWidgetPref = async (patch: Partial<WidgetPreferences>) => {
+    const next = await saveWidgetPreferences(patch);
+    setWidgetPrefs(next);
+    // Reflect the change on the home screen right away.
+    if (next.enabled) {
+      await republishWithPreferences();
+    } else {
+      await publishSignedOutSnapshot();
+    }
+  };
+
   // App-lock PIN setup dialog (two-step: enter then confirm)
   const [pinDialog, setPinDialog] = useState(false);
   const [pinStep, setPinStep] = useState<"enter" | "confirm">("enter");
@@ -115,6 +149,8 @@ export default function Settings() {
     }
     await clearSession();
     clearAllSessions();
+    // Host names and addresses must not survive on the home screen.
+    await resetWidgets();
     setAuthenticated(false);
     // The tabs fall back to their "no server connected" empty states; the user
     // re-authenticates from there or from this Server section.
@@ -280,7 +316,9 @@ export default function Settings() {
 
               <View className="mt-1 gap-0">
                 <Pressable
-                  onPress={() => router.push("/tabs/settings/TwoFactorAuth" as any)}
+                  onPress={() =>
+                    router.push("/tabs/settings/TwoFactorAuth" as any)
+                  }
                   className="flex-row items-center justify-between border-t border-border py-3"
                 >
                   <View className="flex-row items-center gap-2">
@@ -293,7 +331,9 @@ export default function Settings() {
                 </Pressable>
                 {isAdmin ? (
                   <Pressable
-                    onPress={() => router.push("/tabs/settings/ActiveSessions" as any)}
+                    onPress={() =>
+                      router.push("/tabs/settings/ActiveSessions" as any)
+                    }
                     className="flex-row items-center justify-between border-t border-border py-3"
                   >
                     <View className="flex-row items-center gap-2">
@@ -441,6 +481,104 @@ export default function Settings() {
           </View>
         </AccordionSection>
 
+        {/* Home-screen widgets */}
+        {isWidgetSupported ? (
+          <AccordionSection
+            label="Widgets"
+            icon={<LayoutGrid size={14} color={color("muted-foreground")} />}
+            open={open === "widgets"}
+            onToggle={() => toggle("widgets")}
+          >
+            <View className="pt-1">
+              <Text className="pb-2 text-[11px] text-muted-foreground">
+                Add Termix widgets from your home screen: Quick Connect, Server
+                Status and Snippets. They render a snapshot written by this app
+                — never your credentials — and never connect on their own.
+              </Text>
+
+              <SettingRow
+                label="Home screen widgets"
+                description="Publish hosts and snippets to your widgets"
+                last={!widgetPrefs.enabled}
+              >
+                <FakeSwitch
+                  checked={widgetPrefs.enabled}
+                  onChange={(value) => updateWidgetPref({ enabled: value })}
+                />
+              </SettingRow>
+
+              {/* The rest only matters while publishing is on. */}
+              {widgetPrefs.enabled ? (
+                <>
+                  <SettingRow
+                    label="Show addresses"
+                    description="Display user@host under each server"
+                  >
+                    <FakeSwitch
+                      checked={widgetPrefs.showAddresses}
+                      onChange={(value) =>
+                        updateWidgetPref({ showAddresses: value })
+                      }
+                    />
+                  </SettingRow>
+
+                  <SettingRow
+                    label="Include offline hosts"
+                    description="Otherwise only online servers are listed"
+                  >
+                    <FakeSwitch
+                      checked={widgetPrefs.includeOffline}
+                      onChange={(value) =>
+                        updateWidgetPref({ includeOffline: value })
+                      }
+                    />
+                  </SettingRow>
+
+                  <SettingRow
+                    label="Pinned hosts only"
+                    description="Limit widgets to hosts you pinned"
+                  >
+                    <FakeSwitch
+                      checked={widgetPrefs.pinnedOnly}
+                      onChange={(value) =>
+                        updateWidgetPref({ pinnedOnly: value })
+                      }
+                    />
+                  </SettingRow>
+
+                  <SettingRow
+                    label="Snippets widget"
+                    description="Run saved commands from the home screen"
+                    last={!widgetPrefs.includeSnippets}
+                  >
+                    <FakeSwitch
+                      checked={widgetPrefs.includeSnippets}
+                      onChange={(value) =>
+                        updateWidgetPref({ includeSnippets: value })
+                      }
+                    />
+                  </SettingRow>
+
+                  {widgetPrefs.includeSnippets ? (
+                    <SettingRow
+                      label="Show command preview"
+                      description="Display the first line of each snippet"
+                      last
+                    >
+                      <FakeSwitch
+                        checked={widgetPrefs.showSnippetPreview}
+                        onChange={(value) =>
+                          updateWidgetPref({ showSnippetPreview: value })
+                        }
+                      />
+                    </SettingRow>
+                  ) : null}
+                </>
+              ) : null}
+            </View>
+          </AccordionSection>
+        ) : null}
+
         {/* Customization */}
         <AccordionSection
           label="Customization"
diff --git a/app/tabs/settings/Snippets.tsx b/app/tabs/settings/Snippets.tsx
index 80905a8..d44af99 100644
--- a/app/tabs/settings/Snippets.tsx
+++ b/app/tabs/settings/Snippets.tsx
@@ -1,10 +1,5 @@
 import { useState, useEffect, useCallback } from "react";
-import {
-  View,
-  ScrollView,
-  Pressable,
-  RefreshControl,
-} from "react-native";
+import { View, ScrollView, Pressable, RefreshControl } from "react-native";
 import * as Clipboard from "expo-clipboard";
 import {
   ChevronRight,
@@ -25,15 +20,10 @@ import {
   deleteSnippetFolder,
 } from "@/app/main-axios";
 import { Snippet, SnippetFolder } from "@/types";
+import { publishSnippetSnapshot } from "@/app/widgets";
 import { useThemeColor } from "@/app/contexts/ThemeContext";
 import { Screen } from "@/app/components/Screen";
-import {
-  Text,
-  Button,
-  Input,
-  Label,
-  Dialog,
-} from "@/app/components/ui";
+import { Text, Button, Input, Label, Dialog } from "@/app/components/ui";
 import { toast } from "@/app/utils/toast";
 
 type SnippetFormData = {
@@ -78,7 +68,8 @@ export default function Snippets() {
   const [creatingFolder, setCreatingFolder] = useState(false);
 
   // Delete folder confirm
-  const [deleteFolderTarget, setDeleteFolderTarget] = useState<SnippetFolder | null>(null);
+  const [deleteFolderTarget, setDeleteFolderTarget] =
+    useState<SnippetFolder | null>(null);
   const [deletingFolder, setDeletingFolder] = useState(false);
 
   const load = useCallback(async () => {
@@ -87,8 +78,13 @@ export default function Snippets() {
         getSnippets().catch(() => []),
         getSnippetFolders().catch(() => []),
       ]);
-      setSnippets(Array.isArray(s) ? s.sort((a: Snippet, b: Snippet) => (a.order ?? 0) - (b.order ?? 0)) : []);
+      const ordered = Array.isArray(s)
+        ? s.sort((a: Snippet, b: Snippet) => (a.order ?? 0) - (b.order ?? 0))
+        : [];
+      setSnippets(ordered);
       setFolders(Array.isArray(f) ? f : []);
+      // Mirror the list onto the home-screen Snippets widget.
+      void publishSnippetSnapshot(ordered);
     } catch {
       toast.error("Failed to load snippets");
     }
@@ -236,10 +232,17 @@ export default function Snippets() {
         onLongPress={() => openEdit(snippet)}
         className="flex-1 active:opacity-60"
       >
-        <Text weight="medium" className="text-sm text-foreground" numberOfLines={1}>
+        <Text
+          weight="medium"
+          className="text-sm text-foreground"
+          numberOfLines={1}
+        >
           {snippet.name}
         </Text>
-        <Text className="mt-0.5 text-xs text-muted-foreground" numberOfLines={1}>
+        <Text
+          className="mt-0.5 text-xs text-muted-foreground"
+          numberOfLines={1}
+        >
           {snippet.description || snippet.content}
         </Text>
       </Pressable>
@@ -284,9 +287,7 @@ export default function Snippets() {
           >
             {label}
           </Text>
-          <Text className="text-xs text-muted-foreground">
-            {items.length}
-          </Text>
+          <Text className="text-xs text-muted-foreground">{items.length}</Text>
           {folderKey !== null && (
             <Pressable
               onPress={() => {
@@ -305,8 +306,8 @@ export default function Snippets() {
             style={{ transform: [{ rotate: collapsed ? "-90deg" : "0deg" }] }}
           />
         </Pressable>
-        {!collapsed && (
-          items.length === 0 ? (
+        {!collapsed &&
+          (items.length === 0 ? (
             <View className="border-b border-border px-4 py-3">
               <Text className="text-xs italic text-muted-foreground">
                 No snippets in this folder
@@ -314,8 +315,7 @@ export default function Snippets() {
             </View>
           ) : (
             items.map(renderSnippet)
-          )
-        )}
+          ))}
       </View>
     );
   };
diff --git a/app/widgets/RunSnippetSheet.tsx b/app/widgets/RunSnippetSheet.tsx
new file mode 100644
index 0000000..c1e4dae
--- /dev/null
+++ b/app/widgets/RunSnippetSheet.tsx
@@ -0,0 +1,177 @@
+import { useCallback, useEffect, useState } from "react";
+import { ActivityIndicator, ScrollView, View } from "react-native";
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { Play, Server as ServerIcon } from "lucide-react-native";
+import { executeSnippet, getSSHHosts } from "@/app/main-axios";
+import { useThemeColor } from "@/app/contexts/ThemeContext";
+import { BottomSheet, SheetRow, Text } from "@/app/components/ui";
+import { toast } from "@/app/utils/toast";
+import { systemLogger } from "@/lib/frontend-logger";
+import type { SSHHost, Snippet } from "@/types";
+
+/** Remembers the host a widget-run snippet last targeted. */
+const LAST_HOST_KEY = "widgetSnippetLastHostId";
+
+interface RunSnippetSheetProps {
+  /** The snippet a widget tap resolved to, or null when nothing is pending. */
+  snippet: Snippet | null;
+  onClose: () => void;
+}
+
+/**
+ * Target picker for a snippet launched from the home screen.
+ *
+ * A snippet has no host of its own, so a widget tap can't know where to run.
+ * Rather than guessing, this asks — which doubles as the confirmation step that
+ * a home-screen tap otherwise lacks: running a shell command on a server should
+ * never happen by accident. The last target is remembered and offered first, so
+ * the common case is two taps.
+ */
+export function RunSnippetSheet({ snippet, onClose }: RunSnippetSheetProps) {
+  const color = useThemeColor();
+
+  const [hosts, setHosts] = useState<SSHHost[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [runningHostId, setRunningHostId] = useState<number | null>(null);
+  const [lastHostId, setLastHostId] = useState<number | null>(null);
+
+  const visible = snippet !== null;
+
+  useEffect(() => {
+    if (!visible) return;
+
+    let cancelled = false;
+    setLoading(true);
+
+    (async () => {
+      try {
+        const [list, storedHostId] = await Promise.all([
+          getSSHHosts(),
+          AsyncStorage.getItem(LAST_HOST_KEY).catch(() => null),
+        ]);
+        if (cancelled) return;
+
+        const parsed = Number.parseInt(storedHostId ?? "", 10);
+        setLastHostId(Number.isInteger(parsed) ? parsed : null);
+        setHosts(Array.isArray(list) ? list : []);
+      } catch (error) {
+        if (cancelled) return;
+        setHosts([]);
+        toast.error("Could not load your hosts.");
+        systemLogger.warn("[widgets] failed to load hosts for snippet run", {
+          operation: "widgets",
+          errorMessage: error instanceof Error ? error.message : String(error),
+        });
+      } finally {
+        if (!cancelled) setLoading(false);
+      }
+    })();
+
+    return () => {
+      cancelled = true;
+    };
+  }, [visible]);
+
+  const run = useCallback(
+    async (host: SSHHost) => {
+      if (!snippet || runningHostId !== null) return;
+
+      setRunningHostId(host.id);
+      try {
+        const result = await executeSnippet(snippet.id, host.id);
+        AsyncStorage.setItem(LAST_HOST_KEY, String(host.id)).catch(() => {});
+
+        if (result?.success === false) {
+          toast.error(result.error || `${snippet.name} failed on ${host.name}`);
+        } else {
+          // Show the first line of output when there is any — a bare "ran it"
+          // leaves the user guessing whether anything happened.
+          const preview = (result?.output ?? "").trim().split("\n")[0];
+          toast.success(
+            preview
+              ? `${snippet.name} on ${host.name}: ${preview.slice(0, 80)}`
+              : `Ran ${snippet.name} on ${host.name}`,
+          );
+        }
+        onClose();
+      } catch (error) {
+        const message =
+          error instanceof Error ? error.message : "Failed to run snippet";
+        toast.error(message);
+      } finally {
+        setRunningHostId(null);
+      }
+    },
+    [snippet, runningHostId, onClose],
+  );
+
+  // Suggest the previous target first, then the rest in their usual order.
+  const ordered = [...hosts].sort((a, b) => {
+    if (a.id === lastHostId) return -1;
+    if (b.id === lastHostId) return 1;
+    return 0;
+  });
+
+  return (
+    <BottomSheet
+      visible={visible}
+      onClose={runningHostId === null ? onClose : () => {}}
+      title={snippet ? `Run "${snippet.name}" on` : "Run snippet"}
+    >
+      {snippet?.content ? (
+        <View className="border-b border-border bg-card px-4 py-2.5">
+          <Text
+            className="text-[11px] text-muted-foreground"
+            numberOfLines={2}
+            ellipsizeMode="tail"
+          >
+            {snippet.content.trim()}
+          </Text>
+        </View>
+      ) : null}
+
+      {loading ? (
+        <View className="items-center gap-2 py-8">
+          <ActivityIndicator color={color("accent-brand")} />
+          <Text className="text-xs text-muted-foreground">Loading hosts…</Text>
+        </View>
+      ) : ordered.length === 0 ? (
+        <View className="items-center gap-1 px-4 py-8">
+          <Text weight="medium" className="text-sm text-foreground">
+            No hosts available
+          </Text>
+          <Text className="text-center text-[11px] text-muted-foreground">
+            Add a host in Termix to run snippets from your home screen.
+          </Text>
+        </View>
+      ) : (
+        <ScrollView style={{ maxHeight: 340 }}>
+          {ordered.map((host) => (
+            <SheetRow
+              key={host.id}
+              icon={
+                runningHostId === host.id ? (
+                  <ActivityIndicator
+                    size="small"
+                    color={color("accent-brand")}
+                  />
+                ) : host.id === lastHostId ? (
+                  <Play size={16} color={color("accent-brand")} />
+                ) : (
+                  <ServerIcon size={16} color={color("muted-foreground")} />
+                )
+              }
+              label={host.name || host.ip}
+              onPress={() => run(host)}
+              trailing={
+                <Text className="text-[10px] text-muted-foreground">
+                  {host.id === lastHostId ? "Last used" : host.ip}
+                </Text>
+              }
+            />
+          ))}
+        </ScrollView>
+      )}
+    </BottomSheet>
+  );
+}
diff --git a/app/widgets/WidgetDeepLinkHost.tsx b/app/widgets/WidgetDeepLinkHost.tsx
new file mode 100644
index 0000000..bc37a5f
--- /dev/null
+++ b/app/widgets/WidgetDeepLinkHost.tsx
@@ -0,0 +1,15 @@
+import { useWidgetDeepLink } from "./useWidgetDeepLink";
+import { RunSnippetSheet } from "./RunSnippetSheet";
+
+/**
+ * Mount point for everything a home-screen widget can trigger.
+ *
+ * Host taps navigate straight into a session; snippet taps surface the run
+ * sheet rendered here. Kept as one component so the root layout has a single
+ * line to mount, and so the listener and its UI can't drift apart.
+ */
+export function WidgetDeepLinkHost() {
+  const { pendingSnippet, dismissSnippet } = useWidgetDeepLink();
+
+  return <RunSnippetSheet snippet={pendingSnippet} onClose={dismissSnippet} />;
+}
diff --git a/app/widgets/index.ts b/app/widgets/index.ts
new file mode 100644
index 0000000..cfb11c3
--- /dev/null
+++ b/app/widgets/index.ts
@@ -0,0 +1,38 @@
+/**
+ * Home-screen widget integration.
+ *
+ * - `types` holds the payload contract shared with the native decoders.
+ * - `snapshot` turns app state into that payload (pure).
+ * - `publish` writes it to the native widget hosts.
+ * - `preferences` persists what the user allows widgets to show.
+ * - `useWidgetDeepLink` turns widget taps back into in-app navigation.
+ */
+
+export * from "./types";
+export {
+  buildWidgetSnapshot,
+  buildSignedOutSnapshot,
+  formatServerLabel,
+  snippetPreview,
+  isSnapshotEquivalent,
+  type BuildSnapshotInput,
+  type WidgetMetricsEntry,
+} from "./snapshot";
+export {
+  publishHostSnapshot,
+  publishSnippetSnapshot,
+  publishSignedOutSnapshot,
+  republishWithPreferences,
+  resetWidgets,
+  type HostSnapshotInput,
+} from "./publish";
+export {
+  getCachedWidgetPreferences,
+  loadWidgetPreferences,
+  saveWidgetPreferences,
+  subscribeToWidgetPreferences,
+} from "./preferences";
+export { useWidgetDeepLink, parseWidgetLink } from "./useWidgetDeepLink";
+export { WidgetDeepLinkHost } from "./WidgetDeepLinkHost";
+export { RunSnippetSheet } from "./RunSnippetSheet";
+export { isWidgetSupported } from "@/modules/termix-widgets";
diff --git a/app/widgets/preferences.ts b/app/widgets/preferences.ts
new file mode 100644
index 0000000..30f73ff
--- /dev/null
+++ b/app/widgets/preferences.ts
@@ -0,0 +1,97 @@
+/**
+ * Widget preferences — persisted in AsyncStorage and shared between the
+ * Settings screen (which edits them) and the Hosts screen (which publishes
+ * snapshots shaped by them).
+ *
+ * Kept deliberately tiny: a cached value, a load, a save, and a subscription so
+ * a change in Settings takes effect on the next publish without a remount.
+ */
+
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { DEFAULT_WIDGET_PREFERENCES, type WidgetPreferences } from "./types";
+
+const STORAGE_KEY = "widgetPreferences";
+
+type Listener = (preferences: WidgetPreferences) => void;
+
+let cached: WidgetPreferences = DEFAULT_WIDGET_PREFERENCES;
+let loaded = false;
+let inFlight: Promise<WidgetPreferences> | null = null;
+const listeners = new Set<Listener>();
+
+/** Coerces unknown persisted JSON into a complete, valid preferences object. */
+function normalize(value: unknown): WidgetPreferences {
+  if (!value || typeof value !== "object") return DEFAULT_WIDGET_PREFERENCES;
+  const raw = value as Partial<Record<keyof WidgetPreferences, unknown>>;
+  const pick = (key: keyof WidgetPreferences): boolean =>
+    typeof raw[key] === "boolean"
+      ? (raw[key] as boolean)
+      : DEFAULT_WIDGET_PREFERENCES[key];
+  return {
+    enabled: pick("enabled"),
+    showAddresses: pick("showAddresses"),
+    includeOffline: pick("includeOffline"),
+    pinnedOnly: pick("pinnedOnly"),
+    includeSnippets: pick("includeSnippets"),
+    showSnippetPreview: pick("showSnippetPreview"),
+  };
+}
+
+/** Last known preferences without touching storage. Safe on the render path. */
+export function getCachedWidgetPreferences(): WidgetPreferences {
+  return cached;
+}
+
+/** Loads preferences once and memoizes them. Falls back to defaults on error. */
+export async function loadWidgetPreferences(): Promise<WidgetPreferences> {
+  if (loaded) return cached;
+  if (inFlight) return inFlight;
+
+  inFlight = (async () => {
+    try {
+      const stored = await AsyncStorage.getItem(STORAGE_KEY);
+      cached = stored
+        ? normalize(JSON.parse(stored))
+        : DEFAULT_WIDGET_PREFERENCES;
+    } catch {
+      cached = DEFAULT_WIDGET_PREFERENCES;
+    } finally {
+      loaded = true;
+      inFlight = null;
+    }
+    return cached;
+  })();
+
+  return inFlight;
+}
+
+/** Merges a patch into the stored preferences and notifies subscribers. */
+export async function saveWidgetPreferences(
+  patch: Partial<WidgetPreferences>,
+): Promise<WidgetPreferences> {
+  await loadWidgetPreferences();
+  const next = normalize({ ...cached, ...patch });
+  cached = next;
+  loaded = true;
+  try {
+    await AsyncStorage.setItem(STORAGE_KEY, JSON.stringify(next));
+  } catch {
+    // Persisting is best-effort; the in-memory value still applies this session.
+  }
+  listeners.forEach((listener) => {
+    try {
+      listener(next);
+    } catch {
+      // A misbehaving subscriber must not break the others.
+    }
+  });
+  return next;
+}
+
+/** Subscribes to preference changes. Returns an unsubscribe function. */
+export function subscribeToWidgetPreferences(listener: Listener): () => void {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
diff --git a/app/widgets/publish.ts b/app/widgets/publish.ts
new file mode 100644
index 0000000..d5487cd
--- /dev/null
+++ b/app/widgets/publish.ts
@@ -0,0 +1,236 @@
+/**
+ * Publishing pipeline for home-screen widgets.
+ *
+ * Callers hand over the data they already have — the Hosts screen supplies
+ * hosts/statuses/metrics, the Snippets screen supplies snippets — and this
+ * module keeps the merged picture, applies preferences, dedupes, and performs
+ * the native hand-off.
+ *
+ * Every entry point is fire-and-forget safe: nothing here throws, so a widget
+ * problem can never break a refresh elsewhere in the app.
+ */
+
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import {
+  clearWidgetSnapshot,
+  isWidgetSupported,
+  setWidgetSnapshotJson,
+} from "@/modules/termix-widgets";
+import { DEFAULT_ACCENT, STORAGE_KEYS } from "@/app/constants/theme";
+import { systemLogger } from "@/lib/frontend-logger";
+import type { SSHHost, ServerStatus, Snippet } from "@/types";
+import {
+  buildSignedOutSnapshot,
+  buildWidgetSnapshot,
+  isSnapshotEquivalent,
+  type WidgetMetricsEntry,
+} from "./snapshot";
+import { loadWidgetPreferences } from "./preferences";
+import type { WidgetSnapshot } from "./types";
+
+/**
+ * Minimum gap between writes that carry the same content. Widget hosts wake a
+ * process on every write, so we avoid re-publishing an unchanged payload more
+ * often than this even when a screen refreshes aggressively.
+ */
+const UNCHANGED_REPUBLISH_INTERVAL_MS = 5 * 60 * 1000;
+
+/**
+ * Everything needed to rebuild a snapshot, merged from whichever screen last
+ * reported. Held in memory only — it is rebuilt on the next refresh after a
+ * cold start.
+ */
+interface SnapshotSource {
+  hosts: SSHHost[];
+  statuses: Record<number, ServerStatus>;
+  metrics: Record<number, WidgetMetricsEntry>;
+  snippets: Snippet[];
+  serverUrl: string | null;
+  authenticated: boolean;
+}
+
+const EMPTY_SOURCE: SnapshotSource = {
+  hosts: [],
+  statuses: {},
+  metrics: {},
+  snippets: [],
+  serverUrl: null,
+  authenticated: false,
+};
+
+let source: SnapshotSource = EMPTY_SOURCE;
+/** Whether any screen has reported data this session. */
+let sourcePopulated = false;
+let lastPublished: WidgetSnapshot | null = null;
+let lastPublishedAt = 0;
+/** Serializes writes so two overlapping refreshes can't interleave. */
+let writeChain: Promise<void> = Promise.resolve();
+
+/** What the Hosts screen reports on every refresh. */
+export interface HostSnapshotInput {
+  hosts: SSHHost[];
+  statuses: Record<number, ServerStatus>;
+  metrics?: Record<number, WidgetMetricsEntry>;
+  /** Optional: the Hosts screen fetches snippets alongside hosts. */
+  snippets?: Snippet[];
+  serverUrl?: string | null;
+  authenticated: boolean;
+}
+
+/** Reads the persisted accent color, falling back to the brand default. */
+async function resolveAccent(): Promise<string> {
+  try {
+    const stored = await AsyncStorage.getItem(STORAGE_KEYS.accent);
+    if (stored && /^#[0-9a-fA-F]{6}$/.test(stored.trim())) return stored.trim();
+  } catch {
+    // fall through to the default
+  }
+  return DEFAULT_ACCENT;
+}
+
+/** Queues work so snapshots are written strictly in call order. */
+function enqueue(task: () => Promise<void>): Promise<void> {
+  writeChain = writeChain.then(task, task);
+  return writeChain;
+}
+
+async function write(snapshot: WidgetSnapshot, force: boolean): Promise<void> {
+  const unchanged = isSnapshotEquivalent(lastPublished, snapshot);
+  const staleEnough =
+    Date.now() - lastPublishedAt >= UNCHANGED_REPUBLISH_INTERVAL_MS;
+  if (!force && unchanged && !staleEnough) return;
+
+  const delivered = await setWidgetSnapshotJson(JSON.stringify(snapshot));
+  if (delivered) {
+    lastPublished = snapshot;
+    lastPublishedAt = Date.now();
+  }
+}
+
+/** Rebuilds from the merged source and writes when the result differs. */
+async function rebuild(force: boolean): Promise<void> {
+  const preferences = await loadWidgetPreferences();
+  const accent = await resolveAccent();
+  const snapshot = buildWidgetSnapshot({
+    hosts: source.hosts,
+    snippets: source.snippets,
+    statuses: source.statuses,
+    metrics: source.metrics,
+    preferences,
+    accent,
+    serverUrl: source.serverUrl,
+    authenticated: source.authenticated,
+  });
+  await write(snapshot, force);
+}
+
+function logFailure(message: string, error: unknown): void {
+  systemLogger.warn(message, {
+    operation: "widgets",
+    errorMessage: error instanceof Error ? error.message : String(error),
+  });
+}
+
+/**
+ * Publishes the host side of the snapshot. Safe to call on every Hosts
+ * refresh — redundant payloads are dropped.
+ */
+export async function publishHostSnapshot(
+  input: HostSnapshotInput,
+): Promise<void> {
+  if (!isWidgetSupported) return;
+
+  return enqueue(async () => {
+    try {
+      source = {
+        ...source,
+        hosts: input.hosts,
+        statuses: input.statuses,
+        metrics: input.metrics ?? {},
+        // Only replace snippets when the caller actually fetched them.
+        snippets: input.snippets ?? source.snippets,
+        serverUrl: input.serverUrl ?? source.serverUrl,
+        authenticated: input.authenticated,
+      };
+      sourcePopulated = true;
+      await rebuild(false);
+    } catch (error) {
+      logFailure("[widgets] failed to publish snapshot", error);
+    }
+  });
+}
+
+/**
+ * Publishes the snippet side of the snapshot, keeping the hosts already
+ * reported. Called from the Snippets screen after a load or an edit.
+ */
+export async function publishSnippetSnapshot(
+  snippets: Snippet[],
+): Promise<void> {
+  if (!isWidgetSupported) return;
+
+  return enqueue(async () => {
+    try {
+      source = { ...source, snippets, authenticated: true };
+      sourcePopulated = true;
+      await rebuild(false);
+    } catch (error) {
+      logFailure("[widgets] failed to publish snippets", error);
+    }
+  });
+}
+
+/**
+ * Re-publishes through the current preferences. Called when the user changes a
+ * widget setting so the home screen updates immediately.
+ */
+export async function republishWithPreferences(): Promise<void> {
+  if (!isWidgetSupported) return;
+  // Nothing has been reported yet (e.g. the user opened Settings before the
+  // Hosts screen loaded). Rebuilding now would publish an empty snapshot and
+  // blank the widgets; the next refresh will apply the new preferences.
+  if (!sourcePopulated) return;
+  return enqueue(async () => {
+    try {
+      await rebuild(true);
+    } catch (error) {
+      logFailure("[widgets] failed to republish snapshot", error);
+    }
+  });
+}
+
+/**
+ * Drops all data from the widgets — sign-out, server change, or the user
+ * disabling widgets. Widgets fall back to their "sign in" state.
+ */
+export async function publishSignedOutSnapshot(): Promise<void> {
+  if (!isWidgetSupported) return;
+  return enqueue(async () => {
+    try {
+      source = EMPTY_SOURCE;
+      sourcePopulated = false;
+      const accent = await resolveAccent();
+      await write(buildSignedOutSnapshot(accent), true);
+    } catch (error) {
+      logFailure("[widgets] failed to clear snapshot", error);
+    }
+  });
+}
+
+/** Removes the stored payload entirely (used on sign-out). */
+export async function resetWidgets(): Promise<void> {
+  if (!isWidgetSupported) return;
+  return enqueue(async () => {
+    try {
+      source = EMPTY_SOURCE;
+      sourcePopulated = false;
+      await clearWidgetSnapshot();
+      lastPublished = null;
+      lastPublishedAt = 0;
+    } catch (error) {
+      logFailure("[widgets] failed to reset widgets", error);
+    }
+  });
+}
+
+export type { WidgetMetricsEntry };
diff --git a/app/widgets/snapshot.ts b/app/widgets/snapshot.ts
new file mode 100644
index 0000000..1c9abfb
--- /dev/null
+++ b/app/widgets/snapshot.ts
@@ -0,0 +1,288 @@
+/**
+ * Snapshot builder — pure, dependency-free, and therefore trivially testable.
+ *
+ * Converts the state the Hosts screen already holds (hosts, per-host status,
+ * per-host metrics) into the payload the native widgets render. No IO happens
+ * here; publishing lives in ./publish.
+ */
+
+import type { SSHHost, ServerStatus, Snippet } from "@/types";
+import {
+  DEFAULT_WIDGET_PREFERENCES,
+  MAX_SNAPSHOT_HOSTS,
+  MAX_SNAPSHOT_SNIPPETS,
+  SNAPSHOT_VERSION,
+  buildWidgetLink,
+  buildWidgetSnippetLink,
+  type WidgetHostEntry,
+  type WidgetHostStatus,
+  type WidgetPreferences,
+  type WidgetSnapshot,
+  type WidgetSnippetEntry,
+  type WidgetSummary,
+} from "./types";
+
+/** Per-host metrics as held by the Hosts screen. */
+export interface WidgetMetricsEntry {
+  cpu: number | null;
+  ram: number | null;
+}
+
+export interface BuildSnapshotInput {
+  hosts: SSHHost[];
+  /** Snippets to expose on the Snippets widget. Omit to publish none. */
+  snippets?: Snippet[];
+  statuses: Record<number, ServerStatus>;
+  metrics?: Record<number, WidgetMetricsEntry>;
+  preferences?: WidgetPreferences;
+  /** In-app accent color (#rrggbb). */
+  accent: string;
+  /** Configured server URL, used for the widget's footer label. */
+  serverUrl?: string | null;
+  /** Whether the user is signed in. Drives the "signed-out" state. */
+  authenticated: boolean;
+  /** Injected for deterministic tests. */
+  now?: number;
+}
+
+const STATUS_RANK: Record<WidgetHostStatus, number> = {
+  online: 0,
+  unknown: 1,
+  offline: 2,
+};
+
+/** Clamps a metric to an integer 0–100, or null when it isn't usable. */
+function normalizePercent(value: number | null | undefined): number | null {
+  if (typeof value !== "number" || !Number.isFinite(value)) return null;
+  return Math.max(0, Math.min(100, Math.round(value)));
+}
+
+/** Strips scheme/port/path so the footer shows a compact server label. */
+export function formatServerLabel(url: string | null | undefined): string {
+  if (!url) return "";
+  const withoutScheme = url.trim().replace(/^[a-z][a-z0-9+.-]*:\/\//i, "");
+  const host = withoutScheme.split(/[/?#]/)[0] ?? "";
+  return host.replace(/:\d+$/, "");
+}
+
+function hostStatus(
+  host: SSHHost,
+  statuses: Record<number, ServerStatus>,
+): WidgetHostStatus {
+  const status = statuses[host.id]?.status;
+  return status === "online" || status === "offline" ? status : "unknown";
+}
+
+function hostDisplayName(host: SSHHost): string {
+  const name = (host.name ?? "").trim();
+  if (name) return name;
+  const ip = (host.ip ?? "").trim();
+  return ip || `Host ${host.id}`;
+}
+
+function hostSubtitle(host: SSHHost, showAddresses: boolean): string {
+  // Empty rather than a "Hidden" placeholder: tiles fall back to the folder
+  // name, which reads better than a column of identical labels.
+  if (!showAddresses) return "";
+  const user = (host.username ?? "").trim();
+  const ip = (host.ip ?? "").trim();
+  if (user && ip) return `${user}@${ip}`;
+  return ip || user || "";
+}
+
+/** Longest command preview a widget can show without wrapping awkwardly. */
+const SNIPPET_PREVIEW_LIMIT = 48;
+
+/**
+ * Collapses a snippet body to a single line. Multi-line scripts show their
+ * first meaningful line with an ellipsis so the widget hints at the content
+ * without dumping a script onto the home screen.
+ */
+export function snippetPreview(content: string | undefined): string {
+  const lines = (content ?? "")
+    .split("\n")
+    .map((line) => line.trim())
+    .filter((line) => line.length > 0);
+  if (lines.length === 0) return "";
+
+  const first = lines[0].replace(/\s+/g, " ");
+  const truncated =
+    first.length > SNIPPET_PREVIEW_LIMIT
+      ? `${first.slice(0, SNIPPET_PREVIEW_LIMIT - 1)}…`
+      : first;
+  return lines.length > 1 ? `${truncated} …` : truncated;
+}
+
+/**
+ * Same ordering the backend uses (`sortSnippets` in the server's snippets
+ * route): unfiled snippets first, then folder name, then the user's manual
+ * order — so the widget matches the list inside the app.
+ */
+function compareSnippets(a: Snippet, b: Snippet): number {
+  const aFolder = a.folder || "";
+  const bFolder = b.folder || "";
+  if (!aFolder && bFolder) return -1;
+  if (aFolder && !bFolder) return 1;
+  if (aFolder !== bFolder) return aFolder.localeCompare(bFolder);
+  return (a.order ?? 0) - (b.order ?? 0);
+}
+
+function toSnippetEntry(
+  snippet: Snippet,
+  preferences: WidgetPreferences,
+): WidgetSnippetEntry {
+  const name = (snippet.name ?? "").trim();
+  return {
+    id: snippet.id,
+    name: name || `Snippet ${snippet.id}`,
+    folder: (snippet.folder ?? "").trim(),
+    preview: preferences.showSnippetPreview
+      ? snippetPreview(snippet.content)
+      : "",
+    url: buildWidgetSnippetLink(snippet.id),
+  };
+}
+
+function toEntry(
+  host: SSHHost,
+  status: WidgetHostStatus,
+  metrics: WidgetMetricsEntry | undefined,
+  preferences: WidgetPreferences,
+): WidgetHostEntry {
+  return {
+    id: host.id,
+    name: hostDisplayName(host),
+    subtitle: hostSubtitle(host, preferences.showAddresses),
+    folder: (host.folder ?? "").trim(),
+    status,
+    cpu: normalizePercent(metrics?.cpu),
+    mem: normalizePercent(metrics?.ram),
+    pinned: Boolean(host.pin),
+    url: buildWidgetLink(host.id, "terminal"),
+  };
+}
+
+/**
+ * Ordering shown on the home screen: pinned first, then by status
+ * (online → unknown → offline), then alphabetically. Stable and predictable so
+ * the widget doesn't reshuffle on every refresh.
+ */
+function compareEntries(a: WidgetHostEntry, b: WidgetHostEntry): number {
+  if (a.pinned !== b.pinned) return a.pinned ? -1 : 1;
+  const rank = STATUS_RANK[a.status] - STATUS_RANK[b.status];
+  if (rank !== 0) return rank;
+  const byName = a.name.localeCompare(b.name, undefined, {
+    sensitivity: "base",
+  });
+  if (byName !== 0) return byName;
+  return a.id - b.id;
+}
+
+function summarize(entries: WidgetHostEntry[]): WidgetSummary {
+  return entries.reduce<WidgetSummary>(
+    (acc, entry) => {
+      acc.total += 1;
+      acc[entry.status] += 1;
+      return acc;
+    },
+    { total: 0, online: 0, offline: 0, unknown: 0 },
+  );
+}
+
+/** An intentionally blank snapshot — used when signed out or widgets are off. */
+export function buildSignedOutSnapshot(
+  accent: string,
+  now = Date.now(),
+): WidgetSnapshot {
+  return {
+    version: SNAPSHOT_VERSION,
+    updatedAt: now,
+    state: "signed-out",
+    accent,
+    server: "",
+    summary: { total: 0, online: 0, offline: 0, unknown: 0 },
+    hosts: [],
+    snippets: [],
+  };
+}
+
+/**
+ * Builds the widget payload. Never throws: malformed hosts are skipped rather
+ * than taking down the caller's refresh path.
+ */
+export function buildWidgetSnapshot(input: BuildSnapshotInput): WidgetSnapshot {
+  const {
+    hosts,
+    snippets = [],
+    statuses,
+    metrics = {},
+    preferences = DEFAULT_WIDGET_PREFERENCES,
+    accent,
+    serverUrl,
+    authenticated,
+    now = Date.now(),
+  } = input;
+
+  if (!authenticated || !preferences.enabled) {
+    return buildSignedOutSnapshot(accent, now);
+  }
+
+  const safeHosts = Array.isArray(hosts) ? hosts : [];
+
+  // The summary counts every host the user has, even those the preferences
+  // filter out of the list — "3 of 12 online" should stay truthful.
+  const allEntries = safeHosts
+    .filter((host) => host && typeof host.id === "number")
+    .map((host) =>
+      toEntry(host, hostStatus(host, statuses), metrics[host.id], preferences),
+    );
+
+  const summary = summarize(allEntries);
+
+  const visible = allEntries
+    .filter((entry) => (preferences.pinnedOnly ? entry.pinned : true))
+    .filter((entry) =>
+      preferences.includeOffline ? true : entry.status === "online",
+    )
+    .sort(compareEntries)
+    .slice(0, MAX_SNAPSHOT_HOSTS);
+
+  const visibleSnippets = preferences.includeSnippets
+    ? (Array.isArray(snippets) ? snippets : [])
+        .filter((snippet) => snippet && typeof snippet.id === "number")
+        .slice()
+        .sort(compareSnippets)
+        .slice(0, MAX_SNAPSHOT_SNIPPETS)
+        .map((snippet) => toSnippetEntry(snippet, preferences))
+    : [];
+
+  return {
+    version: SNAPSHOT_VERSION,
+    updatedAt: now,
+    state: visible.length > 0 || visibleSnippets.length > 0 ? "ready" : "empty",
+    accent,
+    server: formatServerLabel(serverUrl),
+    summary,
+    hosts: visible,
+    snippets: visibleSnippets,
+  };
+}
+
+/**
+ * True when two snapshots would render identically. Used to skip redundant
+ * writes (each write wakes the widget host and costs battery).
+ */
+export function isSnapshotEquivalent(
+  a: WidgetSnapshot | null,
+  b: WidgetSnapshot | null,
+): boolean {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  // `updatedAt` is deliberately excluded: it changes on every refresh and would
+  // defeat the comparison.
+  const strip = (snapshot: WidgetSnapshot) => ({
+    ...snapshot,
+    updatedAt: 0,
+  });
+  return JSON.stringify(strip(a)) === JSON.stringify(strip(b));
+}
diff --git a/app/widgets/types.ts b/app/widgets/types.ts
new file mode 100644
index 0000000..4fcd855
--- /dev/null
+++ b/app/widgets/types.ts
@@ -0,0 +1,150 @@
+/**
+ * Home-screen widget data contract.
+ *
+ * This module is the single source of truth for the payload the app publishes
+ * to the native widget hosts. The exact same shape is decoded by:
+ *
+ *   - iOS      modules/termix-widgets/ios/widget/WidgetSnapshot.swift
+ *   - Android  modules/termix-widgets/android/src/main/java/expo/modules/
+ *              termixwidgets/WidgetSnapshot.kt
+ *
+ * Any change here MUST be mirrored in both decoders. Bump SNAPSHOT_VERSION when
+ * the shape changes incompatibly — the decoders drop snapshots whose version
+ * they don't understand and render their empty state instead of crashing or
+ * showing stale/garbled data.
+ */
+
+/** Payload format version. Bump on breaking changes to WidgetSnapshot. */
+export const SNAPSHOT_VERSION = 1;
+
+/** URL scheme registered in app.json. */
+export const APP_SCHEME = "termix-mobile";
+
+/** Deep-link host segment reserved for widget-originated links. */
+export const WIDGET_LINK_PREFIX = `${APP_SCHEME}://widget`;
+
+/**
+ * Hard cap on hosts written into a snapshot. Widget hosts (especially iOS
+ * WidgetKit) limit how much data an extension may hold; the largest layout
+ * shows 8 entries, and the Android collection widget scrolls through the rest.
+ */
+export const MAX_SNAPSHOT_HOSTS = 12;
+
+/** Hard cap on snippets written into a snapshot. Same reasoning as hosts. */
+export const MAX_SNAPSHOT_SNIPPETS = 12;
+
+export type WidgetHostStatus = "online" | "offline" | "unknown";
+
+/**
+ * What the widget should render at the top level. Keeps "no data" cases
+ * explicit rather than inferring them from an empty host array.
+ */
+export type WidgetState =
+  | "ready" // hosts present
+  | "empty" // signed in, but no hosts to show
+  | "signed-out"; // no server / not authenticated
+
+/** Session type a widget tap opens. Mirrors SessionType in TerminalSessionsContext. */
+export type WidgetSessionType = "terminal" | "stats" | "filemanager";
+
+export interface WidgetHostEntry {
+  id: number;
+  /** Display name, already trimmed/fallen back to the address. */
+  name: string;
+  /** Secondary line — `user@ip` (or a redacted placeholder). */
+  subtitle: string;
+  /** Folder path, "" when the host lives at the root. */
+  folder: string;
+  status: WidgetHostStatus;
+  /** CPU load percentage 0–100, or null when unknown. */
+  cpu: number | null;
+  /** Memory usage percentage 0–100, or null when unknown. */
+  mem: number | null;
+  pinned: boolean;
+  /** Deep link the widget opens on tap. Precomputed so native code stays dumb. */
+  url: string;
+}
+
+export interface WidgetSnippetEntry {
+  id: number;
+  name: string;
+  /** Folder the snippet lives in, "" when unfiled. */
+  folder: string;
+  /** One-line preview of the command, already truncated (or redacted). */
+  preview: string;
+  /** Deep link the widget opens on tap — runs the snippet on a chosen host. */
+  url: string;
+}
+
+export interface WidgetSummary {
+  total: number;
+  online: number;
+  offline: number;
+  unknown: number;
+}
+
+export interface WidgetSnapshot {
+  version: number;
+  /** Epoch millis the snapshot was produced. Widgets show relative freshness. */
+  updatedAt: number;
+  state: WidgetState;
+  /** Accent color as #rrggbb, so widgets follow the in-app accent. */
+  accent: string;
+  /** Server label (host portion only) or "" when unknown. */
+  server: string;
+  summary: WidgetSummary;
+  hosts: WidgetHostEntry[];
+  snippets: WidgetSnippetEntry[];
+}
+
+/** Preferences that shape what the widgets are allowed to display. */
+export interface WidgetPreferences {
+  /** Master switch. When off, the app publishes an empty signed-out snapshot. */
+  enabled: boolean;
+  /** Show `user@ip` under each host. Off keeps addresses off the lock screen. */
+  showAddresses: boolean;
+  /** Include hosts that are offline or of unknown status. */
+  includeOffline: boolean;
+  /** Only surface pinned hosts. */
+  pinnedOnly: boolean;
+  /** Publish snippets to the Snippets widget. Off keeps commands off the home screen. */
+  includeSnippets: boolean;
+  /** Show the command preview under each snippet name. */
+  showSnippetPreview: boolean;
+}
+
+export const DEFAULT_WIDGET_PREFERENCES: WidgetPreferences = {
+  enabled: true,
+  showAddresses: true,
+  includeOffline: true,
+  pinnedOnly: false,
+  includeSnippets: true,
+  showSnippetPreview: true,
+};
+
+/** Builds the deep link a widget entry opens. */
+export function buildWidgetLink(
+  hostId: number,
+  type: WidgetSessionType = "terminal",
+): string {
+  return `${WIDGET_LINK_PREFIX}/connect?hostId=${hostId}&type=${type}`;
+}
+
+/**
+ * Builds the deep link a snippet tile opens: the app resolves the snippet and
+ * asks which host to run it on. Snippet *content* never leaves the app through
+ * the link itself — only the id travels.
+ */
+export function buildWidgetSnippetLink(snippetId: number): string {
+  return `${WIDGET_LINK_PREFIX}/snippet?snippetId=${snippetId}`;
+}
+
+/** Deep link that just brings the app to the hosts list. */
+export function buildWidgetOpenLink(): string {
+  return `${WIDGET_LINK_PREFIX}/open`;
+}
+
+/** Deep link that opens the snippets list without copying anything. */
+export function buildWidgetSnippetsListLink(): string {
+  return `${WIDGET_LINK_PREFIX}/snippets`;
+}
diff --git a/app/widgets/useWidgetDeepLink.ts b/app/widgets/useWidgetDeepLink.ts
new file mode 100644
index 0000000..73e0d05
--- /dev/null
+++ b/app/widgets/useWidgetDeepLink.ts
@@ -0,0 +1,230 @@
+/**
+ * Handles taps on home-screen widgets.
+ *
+ * Widgets open `termix-mobile://widget/...` links. This hook owns that prefix
+ * (the OIDC flow owns `termix-mobile://oidc-callback`, so the two never
+ * collide) and turns a link into the same in-app navigation a tap on the Hosts
+ * list would produce.
+ *
+ * Cold starts are handled too: a link that arrives before the user is
+ * authenticated is parked and replayed once sign-in completes.
+ *
+ * Host links open a session directly. Snippet links resolve the snippet and
+ * hand it to the caller, which asks which host to run it on — see
+ * ./RunSnippetSheet.
+ */
+
+import { useCallback, useEffect, useRef, useState } from "react";
+import { Linking } from "react-native";
+import { router } from "expo-router";
+import { useAppContext } from "@/app/AppContext";
+import {
+  useTerminalSessions,
+  type SessionType,
+} from "@/app/contexts/TerminalSessionsContext";
+import { getSSHHosts, getSnippets } from "@/app/main-axios";
+import { systemLogger } from "@/lib/frontend-logger";
+import { toast } from "@/app/utils/toast";
+import type { Snippet } from "@/types";
+import { WIDGET_LINK_PREFIX } from "./types";
+
+/** Session types a widget link is allowed to open. */
+const ALLOWED_SESSION_TYPES: SessionType[] = [
+  "terminal",
+  "stats",
+  "filemanager",
+];
+
+interface WidgetLink {
+  action: "connect" | "snippet" | "snippets" | "open";
+  hostId?: number;
+  snippetId?: number;
+  type: SessionType;
+}
+
+/**
+ * Parses a widget deep link. Returns null for anything that isn't ours or that
+ * carries values we don't recognise — a widget must never be able to steer the
+ * app somewhere unexpected.
+ */
+export function parseWidgetLink(url: string): WidgetLink | null {
+  if (!url || !url.startsWith(WIDGET_LINK_PREFIX)) return null;
+
+  const rest = url.slice(WIDGET_LINK_PREFIX.length);
+  const [pathPart, queryPart = ""] = rest.split("?");
+  const action = pathPart.replace(/^\/+/, "").replace(/\/+$/, "");
+
+  if (action === "open" || action === "") {
+    return { action: "open", type: "terminal" };
+  }
+
+  // The snippets list, opened without copying anything.
+  if (action === "snippets") {
+    return { action: "snippets", type: "terminal" };
+  }
+
+  const params = new URLSearchParams(queryPart);
+
+  if (action === "snippet") {
+    const snippetId = Number.parseInt(params.get("snippetId") ?? "", 10);
+    if (!Number.isInteger(snippetId) || snippetId <= 0) return null;
+    return { action: "snippet", snippetId, type: "terminal" };
+  }
+
+  if (action !== "connect") return null;
+
+  const hostId = Number.parseInt(params.get("hostId") ?? "", 10);
+  if (!Number.isInteger(hostId) || hostId <= 0) return null;
+
+  const requested = params.get("type") ?? "terminal";
+  const type = (ALLOWED_SESSION_TYPES as string[]).includes(requested)
+    ? (requested as SessionType)
+    : "terminal";
+
+  return { action: "connect", hostId, type };
+}
+
+export function useWidgetDeepLink(): {
+  /** Snippet awaiting a target host, or null. */
+  pendingSnippet: Snippet | null;
+  dismissSnippet: () => void;
+} {
+  const { isAuthenticated } = useAppContext();
+  const { navigateToSessions } = useTerminalSessions();
+
+  /** Snippet resolved from a widget tap, waiting for the user to pick a host. */
+  const [pendingSnippet, setPendingSnippet] = useState<Snippet | null>(null);
+
+  /** Link received before we could act on it (cold start / signed out). */
+  const pendingRef = useRef<WidgetLink | null>(null);
+  /** Guards against the same URL being delivered twice (listener + initial). */
+  const lastHandledRef = useRef<{ url: string; at: number } | null>(null);
+  const authenticatedRef = useRef(isAuthenticated);
+  authenticatedRef.current = isAuthenticated;
+
+  /**
+   * Resolves the snippet a widget tap referenced. The widget only carries the
+   * id; the command itself is read here, inside the authenticated app, and is
+   * then handed to the run sheet so the user picks a target host.
+   */
+  const runSnippetLink = useCallback(async (snippetId: number) => {
+    try {
+      const snippets = await getSnippets();
+      const snippet = Array.isArray(snippets)
+        ? snippets.find((candidate: Snippet) => candidate.id === snippetId)
+        : undefined;
+
+      if (!snippet) {
+        toast.error("That snippet no longer exists.");
+        router.push("/tabs/settings/Snippets" as never);
+        return;
+      }
+
+      setPendingSnippet(snippet);
+    } catch (error) {
+      systemLogger.warn("[widgets] failed to open snippet from widget", {
+        operation: "widgets",
+        errorMessage: error instanceof Error ? error.message : String(error),
+      });
+      toast.error("Could not open that snippet.");
+      router.push("/tabs/settings/Snippets" as never);
+    }
+  }, []);
+
+  const runLink = useCallback(
+    async (link: WidgetLink) => {
+      if (link.action === "snippets") {
+        router.push("/tabs/settings/Snippets" as never);
+        return;
+      }
+
+      if (link.action === "snippet" && link.snippetId !== undefined) {
+        await runSnippetLink(link.snippetId);
+        return;
+      }
+
+      if (link.action === "open" || link.hostId === undefined) {
+        router.push("/(tabs)/hosts");
+        return;
+      }
+
+      try {
+        const hosts = await getSSHHosts();
+        const host = Array.isArray(hosts)
+          ? hosts.find((candidate) => candidate.id === link.hostId)
+          : undefined;
+
+        if (!host) {
+          toast.error("That host no longer exists.");
+          router.push("/(tabs)/hosts");
+          return;
+        }
+
+        navigateToSessions(host, link.type);
+      } catch (error) {
+        systemLogger.warn("[widgets] failed to open host from widget", {
+          operation: "widgets",
+          hostId: link.hostId,
+          errorMessage: error instanceof Error ? error.message : String(error),
+        });
+        toast.error("Could not open that host.");
+        router.push("/(tabs)/hosts");
+      }
+    },
+    [navigateToSessions, runSnippetLink],
+  );
+
+  const handleUrl = useCallback(
+    (url: string | null) => {
+      if (!url) return;
+
+      const now = Date.now();
+      const last = lastHandledRef.current;
+      if (last && last.url === url && now - last.at < 1000) return;
+
+      const link = parseWidgetLink(url);
+      if (!link) return;
+      lastHandledRef.current = { url, at: now };
+
+      if (!authenticatedRef.current) {
+        // Park it: the effect below replays it the moment sign-in lands.
+        pendingRef.current = link;
+        router.push("/(tabs)/hosts");
+        return;
+      }
+
+      void runLink(link);
+    },
+    [runLink],
+  );
+
+  useEffect(() => {
+    const subscription = Linking.addEventListener("url", (event) => {
+      handleUrl(event.url);
+    });
+    void Linking.getInitialURL()
+      .then(handleUrl)
+      .catch(() => {
+        // No initial URL is the normal case.
+      });
+    return () => subscription.remove();
+  }, [handleUrl]);
+
+  // Replay a parked link once the user is authenticated.
+  useEffect(() => {
+    if (!isAuthenticated) return;
+    const pending = pendingRef.current;
+    if (!pending) return;
+    pendingRef.current = null;
+    void runLink(pending);
+  }, [isAuthenticated, runLink]);
+
+  // Signing out mid-flight must close the run sheet with it.
+  useEffect(() => {
+    if (!isAuthenticated) setPendingSnippet(null);
+  }, [isAuthenticated]);
+
+  const dismissSnippet = useCallback(() => setPendingSnippet(null), []);
+
+  return { pendingSnippet, dismissSnippet };
+}
diff --git a/modules/termix-widgets/android/build.gradle b/modules/termix-widgets/android/build.gradle
new file mode 100644
index 0000000..a4720bb
--- /dev/null
+++ b/modules/termix-widgets/android/build.gradle
@@ -0,0 +1,19 @@
+plugins {
+  id 'com.android.library'
+  id 'expo-module-gradle-plugin'
+}
+
+group = 'expo.modules.termixwidgets'
+version = '1.0.0'
+
+android {
+  namespace "expo.modules.termixwidgets"
+  defaultConfig {
+    versionCode 1
+    versionName '1.0.0'
+  }
+}
+
+dependencies {
+  implementation "androidx.core:core-ktx:1.13.1"
+}
diff --git a/modules/termix-widgets/android/src/main/AndroidManifest.xml b/modules/termix-widgets/android/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..21bf6af
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/AndroidManifest.xml
@@ -0,0 +1,50 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <application>
+    <!--
+      Home-screen widgets. Declared in the module's library manifest so the app
+      picks them up through normal manifest merging — no config-plugin edits to
+      the generated AndroidManifest are required on Android.
+    -->
+    <receiver
+      android:name="expo.modules.termixwidgets.QuickConnectWidgetProvider"
+      android:exported="false"
+      android:label="@string/termix_widget_quick_connect_label">
+      <intent-filter>
+        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+      </intent-filter>
+      <meta-data
+        android:name="android.appwidget.provider"
+        android:resource="@xml/termix_widget_quick_connect_info" />
+    </receiver>
+
+    <receiver
+      android:name="expo.modules.termixwidgets.StatusWidgetProvider"
+      android:exported="false"
+      android:label="@string/termix_widget_status_label">
+      <intent-filter>
+        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+      </intent-filter>
+      <meta-data
+        android:name="android.appwidget.provider"
+        android:resource="@xml/termix_widget_status_info" />
+    </receiver>
+
+    <receiver
+      android:name="expo.modules.termixwidgets.SnippetsWidgetProvider"
+      android:exported="false"
+      android:label="@string/termix_widget_snippets_label">
+      <intent-filter>
+        <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+      </intent-filter>
+      <meta-data
+        android:name="android.appwidget.provider"
+        android:resource="@xml/termix_widget_snippets_info" />
+    </receiver>
+
+    <!-- Feeds host and snippet rows to the collection widgets. -->
+    <service
+      android:name="expo.modules.termixwidgets.HostCollectionService"
+      android:exported="false"
+      android:permission="android.permission.BIND_REMOTEVIEWS" />
+  </application>
+</manifest>
diff --git a/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/HostCollectionService.kt b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/HostCollectionService.kt
new file mode 100644
index 0000000..5fa8160
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/HostCollectionService.kt
@@ -0,0 +1,281 @@
+package expo.modules.termixwidgets
+
+import android.content.Context
+import android.content.Intent
+import android.text.SpannableString
+import android.text.Spanned
+import android.text.style.ForegroundColorSpan
+import android.view.View
+import android.widget.RemoteViews
+import android.widget.RemoteViewsService
+
+/**
+ * Feeds host rows to the collection widgets.
+ *
+ * Runs in the launcher's process, so it must be cheap and self-contained: it
+ * only reads the JSON snapshot the app already wrote. `onDataSetChanged` is the
+ * single point where data is refreshed, which the provider triggers through
+ * `WidgetUpdater`.
+ */
+class HostCollectionService : RemoteViewsService() {
+  override fun onGetViewFactory(intent: Intent): RemoteViewsFactory {
+    val kind = intent.getStringExtra(EXTRA_KIND) ?: KIND_QUICK
+    return HostCollectionFactory(applicationContext, kind)
+  }
+
+  companion object {
+    const val EXTRA_KIND = "expo.modules.termixwidgets.KIND"
+    const val KIND_QUICK = "quick"
+    const val KIND_STATUS = "status"
+    const val KIND_SNIPPETS = "snippets"
+  }
+}
+
+private class HostCollectionFactory(
+  private val context: Context,
+  private val kind: String
+) : RemoteViewsService.RemoteViewsFactory {
+
+  /** Cells in a block meter. Ten reads cleanly at widget sizes. */
+  private val meterCells = 10
+
+  private var snapshot: WidgetSnapshot = WidgetSnapshot.signedOut()
+  private var hosts: List<HostEntry> = emptyList()
+  private var snippets: List<SnippetEntry> = emptyList()
+
+  override fun onCreate() = reload()
+
+  override fun onDataSetChanged() = reload()
+
+  override fun onDestroy() {
+    hosts = emptyList()
+    snippets = emptyList()
+  }
+
+  private fun reload() {
+    snapshot = SnapshotStore.read(context)
+    snippets = if (kind == HostCollectionService.KIND_SNIPPETS) snapshot.snippets else emptyList()
+    hosts = if (kind == HostCollectionService.KIND_STATUS) {
+      // The status widget leads with hosts that actually report metrics, but
+      // never goes blank just because nothing is online.
+      val online = snapshot.hosts.filter { it.status == HostStatus.ONLINE }
+      if (online.isEmpty()) snapshot.hosts else online
+    } else {
+      snapshot.hosts
+    }
+  }
+
+  override fun getCount(): Int =
+    if (kind == HostCollectionService.KIND_SNIPPETS) snippets.size else hosts.size
+
+  override fun getViewTypeCount(): Int = 1
+
+  override fun hasStableIds(): Boolean = true
+
+  override fun getItemId(position: Int): Long {
+    val id = if (kind == HostCollectionService.KIND_SNIPPETS) {
+      snippets.getOrNull(position)?.id
+    } else {
+      hosts.getOrNull(position)?.id
+    }
+    return id?.toLong() ?: position.toLong()
+  }
+
+  override fun getLoadingView(): RemoteViews? = null
+
+  override fun getViewAt(position: Int): RemoteViews {
+    val accent = WidgetTheme.parseAccent(snapshot.accent)
+
+    if (kind == HostCollectionService.KIND_SNIPPETS) {
+      val snippet = snippets.getOrNull(position)
+        ?: return RemoteViews(context.packageName, R.layout.termix_widget_item_snippet)
+      return snippetRow(snippet, accent)
+    }
+
+    val host = hosts.getOrNull(position) ?: return RemoteViews(
+      context.packageName,
+      R.layout.termix_widget_item_quick
+    )
+
+    return if (kind == HostCollectionService.KIND_STATUS) {
+      statusRow(host, accent)
+    } else {
+      quickTile(host, accent)
+    }
+  }
+
+  // MARK: - Row builders
+
+  private fun quickTile(host: HostEntry, accent: Int): RemoteViews {
+    val views = RemoteViews(context.packageName, R.layout.termix_widget_item_quick)
+
+    views.setTextViewText(R.id.termix_item_name, host.name)
+    views.setInt(R.id.termix_item_dot, "setColorFilter", WidgetTheme.statusColor(host.status))
+    views.setContentDescription(R.id.termix_item_root, describe(host))
+
+    val subtitle = host.subtitle.ifEmpty { host.folder }
+    views.setTextViewText(R.id.termix_item_subtitle, subtitle)
+    views.setViewVisibility(
+      R.id.termix_item_subtitle,
+      if (subtitle.isEmpty()) View.GONE else View.VISIBLE
+    )
+
+    views.setViewVisibility(
+      R.id.termix_item_pin,
+      if (host.pinned) View.VISIBLE else View.GONE
+    )
+    if (host.pinned) {
+      views.setInt(R.id.termix_item_pin, "setColorFilter", accent)
+    }
+
+    views.setOnClickFillInIntent(R.id.termix_item_root, WidgetLinks.fillIn(host.uri))
+    return views
+  }
+
+  private fun snippetRow(snippet: SnippetEntry, accent: Int): RemoteViews {
+    val views = RemoteViews(context.packageName, R.layout.termix_widget_item_snippet)
+
+    views.setTextColor(R.id.termix_item_caret, accent)
+    views.setTextViewText(R.id.termix_item_name, snippet.name)
+    views.setTextViewText(R.id.termix_item_preview, snippet.preview)
+    views.setViewVisibility(
+      R.id.termix_item_preview,
+      if (snippet.preview.isEmpty()) View.GONE else View.VISIBLE
+    )
+
+    views.setContentDescription(
+      R.id.termix_item_root,
+      "${snippet.name}. Runs this snippet on a host you pick."
+    )
+    views.setOnClickFillInIntent(R.id.termix_item_root, WidgetLinks.fillIn(snippet.uri))
+    return views
+  }
+
+  private fun statusRow(host: HostEntry, accent: Int): RemoteViews {
+    val views = RemoteViews(context.packageName, R.layout.termix_widget_item_status)
+
+    views.setTextViewText(R.id.termix_item_name, host.name)
+    views.setInt(R.id.termix_item_dot, "setColorFilter", WidgetTheme.statusColor(host.status))
+    views.setContentDescription(R.id.termix_item_root, describe(host))
+    views.setTextViewText(R.id.termix_item_subtitle, host.subtitle)
+    views.setViewVisibility(
+      R.id.termix_item_subtitle,
+      if (host.subtitle.isEmpty()) View.GONE else View.VISIBLE
+    )
+
+    val online = host.status == HostStatus.ONLINE
+    views.setViewVisibility(
+      R.id.termix_item_metrics,
+      if (online) View.VISIBLE else View.GONE
+    )
+    views.setViewVisibility(
+      R.id.termix_item_offline,
+      if (online) View.GONE else View.VISIBLE
+    )
+
+    if (online) {
+      bindMetric(
+        views,
+        percent = host.cpu,
+        accent = accent,
+        valueId = R.id.termix_item_cpu_value,
+        barId = R.id.termix_item_cpu_bar
+      )
+      bindMetric(
+        views,
+        percent = host.mem,
+        accent = accent,
+        valueId = R.id.termix_item_mem_value,
+        barId = R.id.termix_item_mem_bar
+      )
+    } else {
+      views.setTextViewText(
+        R.id.termix_item_offline,
+        if (host.status == HostStatus.OFFLINE) "OFFLINE" else "STATUS UNKNOWN"
+      )
+    }
+
+    views.setOnClickFillInIntent(R.id.termix_item_root, WidgetLinks.fillIn(host.uri))
+    return views
+  }
+
+  /**
+   * Draws a usage meter as monospaced blocks with colour spans.
+   *
+   * Every alternative needs an API-gated call — `setProgressTintList` is API 31+
+   * and reflective width/tint setters are only honoured for methods annotated
+   * `@RemotableViewMethod`. Coloured spans on a plain TextView work on every
+   * supported version and match the terminal aesthetic.
+   */
+  private fun bindMetric(
+    views: RemoteViews,
+    percent: Int?,
+    accent: Int,
+    valueId: Int,
+    barId: Int
+  ) {
+    views.setTextViewText(valueId, percent?.let { "$it%" } ?: "--")
+    views.setTextColor(
+      valueId,
+      if (percent == null) WidgetTheme.TEXT_TERTIARY else WidgetTheme.TEXT_SECONDARY
+    )
+    views.setTextViewText(barId, meter(percent, accent))
+  }
+
+  /** Builds "███░░░░░░░" with the filled run tinted by load. */
+  private fun meter(percent: Int?, accent: Int): CharSequence {
+    // A non-zero reading always lights at least one cell, so "1%" never looks
+    // identical to "no data".
+    val filled = when {
+      percent == null -> 0
+      percent <= 0 -> 0
+      else -> ((percent * meterCells + 99) / 100).coerceIn(1, meterCells)
+    }
+
+    val text = SpannableString(
+      buildString {
+        repeat(filled) { append(FILLED_CELL) }
+        repeat(meterCells - filled) { append(EMPTY_CELL) }
+      }
+    )
+
+    if (filled > 0 && percent != null) {
+      text.setSpan(
+        ForegroundColorSpan(WidgetTheme.loadColor(percent, accent)),
+        0,
+        filled,
+        Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
+      )
+    }
+    if (filled < meterCells) {
+      text.setSpan(
+        ForegroundColorSpan(WidgetTheme.TRACK),
+        filled,
+        meterCells,
+        Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
+      )
+    }
+
+    return text
+  }
+
+  /** Screen-reader description for a host row. */
+  private fun describe(host: HostEntry): String {
+    val status = when (host.status) {
+      HostStatus.ONLINE -> "online"
+      HostStatus.OFFLINE -> "offline"
+      HostStatus.UNKNOWN -> "status unknown"
+    }
+    val load = if (host.status == HostStatus.ONLINE && host.cpu != null) {
+      ", CPU ${host.cpu}%, memory ${host.mem ?: 0}%"
+    } else {
+      ""
+    }
+    return "${host.name}, $status$load. Opens a terminal session."
+  }
+
+  private companion object {
+    const val FILLED_CELL = "\u2588"
+    const val EMPTY_CELL = "\u2591"
+  }
+}
diff --git a/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/SnapshotStore.kt b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/SnapshotStore.kt
new file mode 100644
index 0000000..e9221a0
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/SnapshotStore.kt
@@ -0,0 +1,36 @@
+package expo.modules.termixwidgets
+
+import android.content.Context
+import android.content.SharedPreferences
+
+/**
+ * Shared storage between the app process and the widget host process.
+ *
+ * SharedPreferences is the Android counterpart of the iOS App Group container:
+ * both processes belong to the same app, so a plain private preferences file is
+ * all that is needed — and unlike a content provider it needs no exported
+ * surface.
+ */
+object SnapshotStore {
+  /** Must match the container id reported by the JS module. */
+  const val PREFERENCES_NAME = "termix_widgets"
+
+  /** Must match `TermixWidgetsModule.snapshotKey` on iOS and the TS layer. */
+  private const val SNAPSHOT_KEY = "termix.widget.snapshot.v1"
+
+  private fun preferences(context: Context): SharedPreferences =
+    context.applicationContext.getSharedPreferences(PREFERENCES_NAME, Context.MODE_PRIVATE)
+
+  fun write(context: Context, json: String) {
+    preferences(context).edit().putString(SNAPSHOT_KEY, json).apply()
+  }
+
+  fun clear(context: Context) {
+    preferences(context).edit().remove(SNAPSHOT_KEY).apply()
+  }
+
+  fun read(context: Context): WidgetSnapshot =
+    WidgetSnapshot.parse(
+      runCatching { preferences(context).getString(SNAPSHOT_KEY, null) }.getOrNull()
+    )
+}
diff --git a/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/TermixWidgetProvider.kt b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/TermixWidgetProvider.kt
new file mode 100644
index 0000000..3c983ca
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/TermixWidgetProvider.kt
@@ -0,0 +1,195 @@
+package expo.modules.termixwidgets
+
+import android.appwidget.AppWidgetManager
+import android.appwidget.AppWidgetProvider
+import android.content.Context
+import android.content.Intent
+import android.net.Uri
+import android.os.Bundle
+import android.view.View
+import android.widget.RemoteViews
+
+/**
+ * Shared chrome for every widget kind: header, summary, footer, empty state and
+ * the collection adapter wiring. Subclasses declare which layout and collection
+ * view they use, plus the copy that differs (wordmark, empty-state subject).
+ *
+ * Rendering never reads the network and never blocks: the snapshot is a small
+ * JSON blob in shared preferences, written by the app.
+ */
+abstract class TermixWidgetProvider : AppWidgetProvider() {
+  protected abstract val layoutId: Int
+  protected abstract val collectionViewId: Int
+  protected abstract val collectionKind: String
+
+  /** Word shown next to the accent block. */
+  protected open val wordmark: String = "TERMIX"
+
+  /** What this widget lists — used in the empty-state copy. */
+  protected open val emptySubject: String = "hosts"
+
+  /** Where a tap on the header (or empty state) lands in the app. */
+  protected open val headerUri: Uri = WidgetSnapshot.FALLBACK_URI
+
+  override fun onUpdate(
+    context: Context,
+    appWidgetManager: AppWidgetManager,
+    appWidgetIds: IntArray
+  ) {
+    appWidgetIds.forEach { widgetId ->
+      runCatching { render(context, appWidgetManager, widgetId) }
+    }
+  }
+
+  override fun onAppWidgetOptionsChanged(
+    context: Context,
+    appWidgetManager: AppWidgetManager,
+    appWidgetId: Int,
+    newOptions: Bundle?
+  ) {
+    super.onAppWidgetOptionsChanged(context, appWidgetManager, appWidgetId, newOptions)
+    runCatching { render(context, appWidgetManager, appWidgetId) }
+  }
+
+  protected open fun render(
+    context: Context,
+    appWidgetManager: AppWidgetManager,
+    appWidgetId: Int
+  ) {
+    val snapshot = SnapshotStore.read(context)
+    val accent = WidgetTheme.parseAccent(snapshot.accent)
+    val views = RemoteViews(context.packageName, layoutId)
+
+    renderHeader(views, snapshot, accent)
+    renderFooter(views, snapshot)
+    renderEmptyState(views, snapshot, accent)
+    views.setOnClickPendingIntent(
+      R.id.termix_widget_empty,
+      WidgetLinks.openApp(context, appWidgetId, headerUri)
+    )
+    bindCollection(context, views, appWidgetId)
+
+    views.setOnClickPendingIntent(
+      R.id.termix_widget_header,
+      WidgetLinks.openApp(context, appWidgetId, headerUri)
+    )
+
+    appWidgetManager.updateAppWidget(appWidgetId, views)
+  }
+
+  private fun renderHeader(views: RemoteViews, snapshot: WidgetSnapshot, accent: Int) {
+    views.setInt(R.id.termix_widget_accent_block, "setBackgroundColor", accent)
+    views.setTextViewText(R.id.termix_widget_wordmark, wordmark)
+
+    val summary = summaryText(snapshot)
+    views.setViewVisibility(
+      R.id.termix_widget_summary,
+      if (summary == null) View.GONE else View.VISIBLE
+    )
+    views.setViewVisibility(
+      R.id.termix_widget_summary_dot,
+      if (summary != null && showsSummaryDot) View.VISIBLE else View.GONE
+    )
+    if (summary != null) {
+      views.setTextViewText(R.id.termix_widget_summary, summary)
+      if (showsSummaryDot) {
+        views.setInt(R.id.termix_widget_summary_dot, "setColorFilter", WidgetTheme.ONLINE)
+      }
+    }
+  }
+
+  /** Right-hand header label, or null to hide it. */
+  protected open fun summaryText(snapshot: WidgetSnapshot): String? =
+    if (snapshot.summary.total > 0) {
+      "${snapshot.summary.online}/${snapshot.summary.total}"
+    } else {
+      null
+    }
+
+  /** Whether the green dot precedes the summary label. */
+  protected open val showsSummaryDot: Boolean = true
+
+  private fun renderFooter(views: RemoteViews, snapshot: WidgetSnapshot) {
+    views.setTextViewText(R.id.termix_widget_server, snapshot.server)
+    views.setViewVisibility(
+      R.id.termix_widget_server,
+      if (snapshot.server.isEmpty()) View.GONE else View.VISIBLE
+    )
+    views.setTextViewText(
+      R.id.termix_widget_age,
+      WidgetTheme.relativeAge(snapshot.updatedAt)
+    )
+  }
+
+  private fun renderEmptyState(views: RemoteViews, snapshot: WidgetSnapshot, accent: Int) {
+    val signedOut = snapshot.state == SnapshotState.SIGNED_OUT
+    // The account having hosts while the list is empty means the widget's own
+    // filters excluded them — "no hosts yet" would be a lie.
+    val filteredOut = !signedOut && snapshot.summary.total > 0
+    val subject = emptySubject.dropLast(1)
+
+    views.setTextViewText(
+      R.id.termix_widget_empty_title,
+      when {
+        signedOut -> "Not signed in"
+        filteredOut -> "Nothing to show"
+        else -> "No $emptySubject yet"
+      }
+    )
+    views.setTextViewText(
+      R.id.termix_widget_empty_message,
+      when {
+        signedOut -> "Open Termix to connect to your server."
+        filteredOut ->
+          "Widget filters hide every $subject. Change them in Settings \u2192 Widgets."
+        else -> "Add a $subject in Termix, or enable them in Settings \u2192 Widgets."
+      }
+    )
+    views.setTextColor(R.id.termix_widget_empty_action, accent)
+  }
+
+  private fun bindCollection(context: Context, views: RemoteViews, appWidgetId: Int) {
+    val intent = Intent(context, HostCollectionService::class.java).apply {
+      putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId)
+      putExtra(HostCollectionService.EXTRA_KIND, collectionKind)
+      // A unique data URI per widget stops Android from reusing another
+      // widget's factory (intents are compared without extras).
+      data = Uri.parse(toUri(Intent.URI_INTENT_SCHEME))
+    }
+
+    views.setRemoteAdapter(collectionViewId, intent)
+    views.setEmptyView(collectionViewId, R.id.termix_widget_empty)
+    views.setPendingIntentTemplate(
+      collectionViewId,
+      WidgetLinks.itemTemplate(context, appWidgetId)
+    )
+  }
+}
+
+/** Launcher grid of hosts — tapping a tile opens a terminal session. */
+class QuickConnectWidgetProvider : TermixWidgetProvider() {
+  override val layoutId = R.layout.termix_widget_quick_connect
+  override val collectionViewId = R.id.termix_widget_grid
+  override val collectionKind = HostCollectionService.KIND_QUICK
+}
+
+/** Metric list — CPU and memory bars per host. */
+class StatusWidgetProvider : TermixWidgetProvider() {
+  override val layoutId = R.layout.termix_widget_status
+  override val collectionViewId = R.id.termix_widget_list
+  override val collectionKind = HostCollectionService.KIND_STATUS
+}
+
+/** Saved commands — tapping one runs it on a host chosen in the app. */
+class SnippetsWidgetProvider : TermixWidgetProvider() {
+  override val layoutId = R.layout.termix_widget_snippets
+  override val collectionViewId = R.id.termix_widget_snippet_list
+  override val collectionKind = HostCollectionService.KIND_SNIPPETS
+  override val wordmark = "SNIPPETS"
+  override val headerUri: Uri = Uri.parse("termix-mobile://widget/snippets")
+  override val emptySubject = "snippets"
+  override val showsSummaryDot = false
+
+  override fun summaryText(snapshot: WidgetSnapshot): String? =
+    snapshot.snippets.size.takeIf { it > 0 }?.toString()
+}
diff --git a/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/TermixWidgetsModule.kt b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/TermixWidgetsModule.kt
new file mode 100644
index 0000000..b92d23e
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/TermixWidgetsModule.kt
@@ -0,0 +1,41 @@
+package expo.modules.termixwidgets
+
+import expo.modules.kotlin.exception.Exceptions
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+/**
+ * Bridges the JS widget layer to the Android home screen.
+ *
+ * The app writes one JSON snapshot into shared preferences; the widget
+ * providers read it back in the launcher's process. Keeping the transport to a
+ * single string keeps the two sides decoupled — the contract lives in
+ * `app/widgets/types.ts`.
+ */
+class TermixWidgetsModule : Module() {
+  private val context
+    get() = appContext.reactContext ?: throw Exceptions.ReactContextLost()
+
+  override fun definition() = ModuleDefinition {
+    Name("TermixWidgets")
+
+    Constants(
+      "isSupported" to true,
+      "containerId" to SnapshotStore.PREFERENCES_NAME
+    )
+
+    AsyncFunction("setSnapshot") { json: String ->
+      SnapshotStore.write(context, json)
+      WidgetUpdater.updateAll(context)
+    }
+
+    AsyncFunction("clearSnapshot") {
+      SnapshotStore.clear(context)
+      WidgetUpdater.updateAll(context)
+    }
+
+    AsyncFunction("reloadWidgets") {
+      WidgetUpdater.updateAll(context)
+    }
+  }
+}
diff --git a/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetLinks.kt b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetLinks.kt
new file mode 100644
index 0000000..f60c80d
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetLinks.kt
@@ -0,0 +1,70 @@
+package expo.modules.termixwidgets
+
+import android.app.PendingIntent
+import android.content.Context
+import android.content.Intent
+import android.net.Uri
+import android.os.Build
+
+/**
+ * Deep links out of the widgets.
+ *
+ * Everything lands on the app's launch activity with an ACTION_VIEW intent; the
+ * JS side (`app/widgets/useWidgetDeepLink.ts`) decides what the URL means.
+ */
+object WidgetLinks {
+  private fun launchIntent(context: Context): Intent {
+    val component = context.packageManager
+      .getLaunchIntentForPackage(context.packageName)
+      ?.component
+    return Intent(Intent.ACTION_VIEW).apply {
+      // Addressing the activity directly keeps the intent unambiguous even if
+      // another app claims the same scheme.
+      if (component != null) setComponent(component) else setPackage(context.packageName)
+      addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP)
+    }
+  }
+
+  /**
+   * FLAG_MUTABLE only exists from API 31, and mutability is the default below
+   * it — so only the immutable case needs a flag on older versions.
+   */
+  private fun flags(mutable: Boolean): Int {
+    val base = PendingIntent.FLAG_UPDATE_CURRENT
+    return when {
+      Build.VERSION.SDK_INT >= Build.VERSION_CODES.S ->
+        base or if (mutable) PendingIntent.FLAG_MUTABLE else PendingIntent.FLAG_IMMUTABLE
+      !mutable && Build.VERSION.SDK_INT >= Build.VERSION_CODES.M ->
+        base or PendingIntent.FLAG_IMMUTABLE
+      else -> base
+    }
+  }
+
+  /**
+   * Template used by collection items. Must be mutable: each row supplies its
+   * own URL through a fill-in intent.
+   */
+  fun itemTemplate(context: Context, widgetId: Int): PendingIntent =
+    PendingIntent.getActivity(context, widgetId, launchIntent(context), flags(mutable = true))
+
+  /** Fill-in intent carrying one host's deep link. */
+  fun fillIn(uri: Uri): Intent = Intent().setData(uri)
+
+  /** Opens the app at [uri] (header / empty-state taps). */
+  fun openApp(
+    context: Context,
+    widgetId: Int,
+    uri: Uri = WidgetSnapshot.FALLBACK_URI
+  ): PendingIntent {
+    val intent = launchIntent(context).setData(uri)
+    // Offset the request code so it can't collide with the item template above.
+    return PendingIntent.getActivity(
+      context,
+      widgetId + REQUEST_CODE_OPEN_OFFSET,
+      intent,
+      flags(mutable = false)
+    )
+  }
+
+  private const val REQUEST_CODE_OPEN_OFFSET = 100_000
+}
diff --git a/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetSnapshot.kt b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetSnapshot.kt
new file mode 100644
index 0000000..f0812c4
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetSnapshot.kt
@@ -0,0 +1,188 @@
+package expo.modules.termixwidgets
+
+import android.net.Uri
+import org.json.JSONObject
+
+/**
+ * Decoders for the snapshot the app publishes.
+ *
+ * The payload shape is defined once in `app/widgets/types.ts`. Parsing is
+ * deliberately lenient — unknown fields are ignored and missing ones fall back —
+ * so an app update can add fields without breaking a widget that hasn't been
+ * rebuilt yet.
+ */
+
+enum class HostStatus {
+  ONLINE,
+  OFFLINE,
+  UNKNOWN;
+
+  companion object {
+    fun from(raw: String?): HostStatus = when (raw) {
+      "online" -> ONLINE
+      "offline" -> OFFLINE
+      else -> UNKNOWN
+    }
+  }
+}
+
+enum class SnapshotState {
+  READY,
+  EMPTY,
+  SIGNED_OUT;
+
+  companion object {
+    fun from(raw: String?): SnapshotState = when (raw) {
+      "ready" -> READY
+      "empty" -> EMPTY
+      else -> SIGNED_OUT
+    }
+  }
+}
+
+data class HostEntry(
+  val id: Int,
+  val name: String,
+  val subtitle: String,
+  val folder: String,
+  val status: HostStatus,
+  val cpu: Int?,
+  val mem: Int?,
+  val pinned: Boolean,
+  val url: String
+) {
+  val uri: Uri
+    get() = runCatching { Uri.parse(url) }.getOrDefault(WidgetSnapshot.FALLBACK_URI)
+}
+
+data class SnippetEntry(
+  val id: Int,
+  val name: String,
+  val folder: String,
+  val preview: String,
+  val url: String
+) {
+  val uri: Uri
+    get() = runCatching { Uri.parse(url) }.getOrDefault(WidgetSnapshot.FALLBACK_URI)
+}
+
+data class HostSummary(
+  val total: Int = 0,
+  val online: Int = 0,
+  val offline: Int = 0,
+  val unknown: Int = 0
+)
+
+data class WidgetSnapshot(
+  val version: Int,
+  val updatedAt: Long,
+  val state: SnapshotState,
+  val accent: String,
+  val server: String,
+  val summary: HostSummary,
+  val hosts: List<HostEntry>,
+  val snippets: List<SnippetEntry>
+) {
+  companion object {
+    /** Payload version this build understands. Mirrors SNAPSHOT_VERSION in TS. */
+    const val SUPPORTED_VERSION = 1
+
+    const val FALLBACK_URL = "termix-mobile://widget/open"
+    val FALLBACK_URI: Uri = Uri.parse(FALLBACK_URL)
+
+    const val DEFAULT_ACCENT = "#f59145"
+
+    fun signedOut(accent: String = DEFAULT_ACCENT) = WidgetSnapshot(
+      version = SUPPORTED_VERSION,
+      updatedAt = System.currentTimeMillis(),
+      state = SnapshotState.SIGNED_OUT,
+      accent = accent,
+      server = "",
+      summary = HostSummary(),
+      hosts = emptyList(),
+      snippets = emptyList()
+    )
+
+    /**
+     * Parses a stored payload. Returns the signed-out snapshot for anything
+     * unreadable so a corrupt write can never crash the widget host process.
+     */
+    fun parse(json: String?): WidgetSnapshot {
+      if (json.isNullOrBlank()) return signedOut()
+
+      return runCatching {
+        val root = JSONObject(json)
+        val version = root.optInt("version", -1)
+        val accent = root.optString("accent", DEFAULT_ACCENT)
+        if (version != SUPPORTED_VERSION) return signedOut(accent)
+
+        val summaryJson = root.optJSONObject("summary")
+        val summary = HostSummary(
+          total = summaryJson?.optInt("total", 0) ?: 0,
+          online = summaryJson?.optInt("online", 0) ?: 0,
+          offline = summaryJson?.optInt("offline", 0) ?: 0,
+          unknown = summaryJson?.optInt("unknown", 0) ?: 0
+        )
+
+        val hostsJson = root.optJSONArray("hosts")
+        val hosts = buildList {
+          for (index in 0 until (hostsJson?.length() ?: 0)) {
+            val item = hostsJson?.optJSONObject(index) ?: continue
+            val id = item.optInt("id", -1)
+            if (id < 0) continue
+            add(
+              HostEntry(
+                id = id,
+                name = item.optString("name", "Host $id"),
+                subtitle = item.optString("subtitle", ""),
+                folder = item.optString("folder", ""),
+                status = HostStatus.from(item.optString("status", "unknown")),
+                cpu = item.optPercent("cpu"),
+                mem = item.optPercent("mem"),
+                pinned = item.optBoolean("pinned", false),
+                url = item.optString("url", FALLBACK_URL)
+              )
+            )
+          }
+        }
+
+        val snippetsJson = root.optJSONArray("snippets")
+        val snippets = buildList {
+          for (index in 0 until (snippetsJson?.length() ?: 0)) {
+            val item = snippetsJson?.optJSONObject(index) ?: continue
+            val id = item.optInt("id", -1)
+            if (id < 0) continue
+            add(
+              SnippetEntry(
+                id = id,
+                name = item.optString("name", "Snippet $id"),
+                folder = item.optString("folder", ""),
+                preview = item.optString("preview", ""),
+                url = item.optString("url", FALLBACK_URL)
+              )
+            )
+          }
+        }
+
+        WidgetSnapshot(
+          version = version,
+          updatedAt = root.optLong("updatedAt", System.currentTimeMillis()),
+          state = SnapshotState.from(root.optString("state", "signed-out")),
+          accent = accent,
+          server = root.optString("server", ""),
+          summary = summary,
+          hosts = hosts,
+          snippets = snippets
+        )
+      }.getOrElse { signedOut() }
+    }
+
+    /** Reads a 0–100 metric, treating null/NaN/out-of-range as "unknown". */
+    private fun JSONObject.optPercent(key: String): Int? {
+      if (isNull(key)) return null
+      val value = optDouble(key, Double.NaN)
+      if (value.isNaN()) return null
+      return value.toInt().coerceIn(0, 100)
+    }
+  }
+}
diff --git a/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetTheme.kt b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetTheme.kt
new file mode 100644
index 0000000..059a2f0
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetTheme.kt
@@ -0,0 +1,56 @@
+package expo.modules.termixwidgets
+
+import android.graphics.Color
+import android.text.format.DateUtils
+
+/**
+ * Colour + formatting helpers shared by both providers.
+ *
+ * Mirrors the iOS widget palette (`ios/widget/WidgetTheme.swift`) which in turn
+ * mirrors `app/constants/designTokens.ts`, so a Termix widget looks the same on
+ * either platform.
+ */
+object WidgetTheme {
+  const val TEXT_PRIMARY = 0xFFFAFAFA.toInt()
+  const val TEXT_SECONDARY = 0xFFA4A4A4.toInt()
+  const val TEXT_TERTIARY = 0xFF737373.toInt()
+
+  const val ONLINE = 0xFF4ADE80.toInt()
+  const val OFFLINE = 0xFFFF6467.toInt()
+  const val UNKNOWN = 0xFF737373.toInt()
+
+  const val TRACK = 0xFF3A3A3A.toInt()
+  const val WARN = 0xFFF5C542.toInt()
+
+  const val FALLBACK_ACCENT = 0xFFF59145.toInt()
+
+  /** Parses `#rrggbb`, falling back to the brand accent for anything invalid. */
+  fun parseAccent(hex: String?): Int {
+    if (hex.isNullOrBlank()) return FALLBACK_ACCENT
+    return runCatching { Color.parseColor(hex.trim()) }.getOrDefault(FALLBACK_ACCENT)
+  }
+
+  fun statusColor(status: HostStatus): Int = when (status) {
+    HostStatus.ONLINE -> ONLINE
+    HostStatus.OFFLINE -> OFFLINE
+    HostStatus.UNKNOWN -> UNKNOWN
+  }
+
+  /** Calm below 60%, warm to 85%, hot above — matches the iOS bars. */
+  fun loadColor(percent: Int, accent: Int): Int = when {
+    percent < 60 -> accent
+    percent < 85 -> WARN
+    else -> OFFLINE
+  }
+
+  /** Compact freshness label ("now", "4m", "2h", "3d"). */
+  fun relativeAge(updatedAt: Long, now: Long = System.currentTimeMillis()): String {
+    val elapsed = (now - updatedAt).coerceAtLeast(0)
+    return when {
+      elapsed < DateUtils.MINUTE_IN_MILLIS -> "now"
+      elapsed < DateUtils.HOUR_IN_MILLIS -> "${elapsed / DateUtils.MINUTE_IN_MILLIS}m"
+      elapsed < DateUtils.DAY_IN_MILLIS -> "${elapsed / DateUtils.HOUR_IN_MILLIS}h"
+      else -> "${elapsed / DateUtils.DAY_IN_MILLIS}d"
+    }
+  }
+}
diff --git a/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetUpdater.kt b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetUpdater.kt
new file mode 100644
index 0000000..1016ef3
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/java/expo/modules/termixwidgets/WidgetUpdater.kt
@@ -0,0 +1,47 @@
+package expo.modules.termixwidgets
+
+import android.appwidget.AppWidgetManager
+import android.content.ComponentName
+import android.content.Context
+
+/**
+ * Pushes a redraw to every placed Termix widget.
+ *
+ * Collection widgets need two signals: the adapter data must be invalidated
+ * (`notifyAppWidgetViewDataChanged`) *and* the host chrome (header, footer,
+ * accent) re-rendered by the provider.
+ */
+object WidgetUpdater {
+  fun updateAll(context: Context) {
+    val appContext = context.applicationContext
+    val manager = AppWidgetManager.getInstance(appContext) ?: return
+
+    updateProvider(appContext, manager, QuickConnectWidgetProvider::class.java, R.id.termix_widget_grid)
+    updateProvider(appContext, manager, StatusWidgetProvider::class.java, R.id.termix_widget_list)
+    updateProvider(
+      appContext,
+      manager,
+      SnippetsWidgetProvider::class.java,
+      R.id.termix_widget_snippet_list
+    )
+  }
+
+  private fun <T : TermixWidgetProvider> updateProvider(
+    context: Context,
+    manager: AppWidgetManager,
+    provider: Class<T>,
+    collectionViewId: Int
+  ) {
+    val ids = runCatching {
+      manager.getAppWidgetIds(ComponentName(context, provider))
+    }.getOrNull() ?: return
+    if (ids.isEmpty()) return
+
+    // Refresh the scrolling rows first, then the surrounding chrome.
+    manager.notifyAppWidgetViewDataChanged(ids, collectionViewId)
+
+    val instance = runCatching { provider.getDeclaredConstructor().newInstance() }.getOrNull()
+      ?: return
+    instance.onUpdate(context, manager, ids)
+  }
+}
diff --git a/modules/termix-widgets/android/src/main/res/drawable/termix_widget_background.xml b/modules/termix-widgets/android/src/main/res/drawable/termix_widget_background.xml
new file mode 100644
index 0000000..310ca50
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/drawable/termix_widget_background.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+  <solid android:color="@color/termix_widget_background" />
+  <stroke android:width="1dp" android:color="@color/termix_widget_border" />
+  <corners android:radius="@dimen/termix_widget_radius" />
+</shape>
diff --git a/modules/termix-widgets/android/src/main/res/drawable/termix_widget_card.xml b/modules/termix-widgets/android/src/main/res/drawable/termix_widget_card.xml
new file mode 100644
index 0000000..c07087d
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/drawable/termix_widget_card.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Square-cornered card, matching the app's terminal chrome. -->
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+  <solid android:color="@color/termix_widget_card" />
+  <stroke android:width="1dp" android:color="@color/termix_widget_border" />
+</shape>
diff --git a/modules/termix-widgets/android/src/main/res/drawable/termix_widget_dot.xml b/modules/termix-widgets/android/src/main/res/drawable/termix_widget_dot.xml
new file mode 100644
index 0000000..0950007
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/drawable/termix_widget_dot.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Neutral white so it can be tinted per status with setColorFilter. -->
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="oval">
+  <solid android:color="#FFFFFFFF" />
+</shape>
diff --git a/modules/termix-widgets/android/src/main/res/drawable/termix_widget_pin.xml b/modules/termix-widgets/android/src/main/res/drawable/termix_widget_pin.xml
new file mode 100644
index 0000000..f0d5b28
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/drawable/termix_widget_pin.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Pinned marker; tinted with the user's accent at runtime. -->
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+  <solid android:color="#FFFFFFFF" />
+</shape>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_empty.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_empty.xml
new file mode 100644
index 0000000..5fc9535
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_empty.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Shown by setEmptyView when the snapshot carries no hosts. -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:id="@+id/termix_widget_empty"
+  android:layout_width="match_parent"
+  android:layout_height="match_parent"
+  android:orientation="vertical"
+  android:gravity="center_vertical"
+  android:visibility="gone">
+
+  <TextView
+    android:id="@+id/termix_widget_empty_title"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:textColor="@color/termix_widget_text_primary"
+    android:textSize="13sp"
+    android:textStyle="bold"
+    android:fontFamily="monospace" />
+
+  <TextView
+    android:id="@+id/termix_widget_empty_message"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:layout_marginTop="3dp"
+    android:maxLines="2"
+    android:textColor="@color/termix_widget_text_tertiary"
+    android:textSize="9sp"
+    android:fontFamily="monospace" />
+
+  <TextView
+    android:id="@+id/termix_widget_empty_action"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:layout_marginTop="8dp"
+    android:text="@string/termix_widget_open_action"
+    android:textColor="#F59145"
+    android:textSize="8sp"
+    android:textStyle="bold"
+    android:letterSpacing="0.1"
+    android:fontFamily="monospace" />
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_footer.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_footer.xml
new file mode 100644
index 0000000..247913b
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_footer.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Server label on the left, snapshot freshness on the right. -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:id="@+id/termix_widget_footer"
+  android:layout_width="match_parent"
+  android:layout_height="wrap_content"
+  android:orientation="horizontal"
+  android:gravity="center_vertical"
+  android:paddingTop="7dp">
+
+  <TextView
+    android:id="@+id/termix_widget_server"
+    android:layout_width="0dp"
+    android:layout_height="wrap_content"
+    android:layout_weight="1"
+    android:maxLines="1"
+    android:ellipsize="middle"
+    android:textColor="@color/termix_widget_text_tertiary"
+    android:textSize="8sp"
+    android:fontFamily="monospace" />
+
+  <TextView
+    android:id="@+id/termix_widget_age"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:textColor="@color/termix_widget_text_tertiary"
+    android:textSize="8sp"
+    android:fontFamily="monospace" />
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_header.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_header.xml
new file mode 100644
index 0000000..acb4e98
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_header.xml
@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Wordmark + online summary. Tapping it opens the app. -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:id="@+id/termix_widget_header"
+  android:layout_width="match_parent"
+  android:layout_height="wrap_content"
+  android:orientation="horizontal"
+  android:gravity="center_vertical"
+  android:paddingBottom="8dp">
+
+  <!-- Accent block; a TextView so its colour is remotable on every API level. -->
+  <TextView
+    android:id="@+id/termix_widget_accent_block"
+    android:layout_width="3dp"
+    android:layout_height="11dp"
+    android:layout_marginEnd="6dp"
+    android:background="#F59145"
+    android:importantForAccessibility="no" />
+
+  <TextView
+    android:id="@+id/termix_widget_wordmark"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:text="@string/termix_widget_wordmark"
+    android:textColor="@color/termix_widget_text_primary"
+    android:textSize="9sp"
+    android:textStyle="bold"
+    android:letterSpacing="0.14"
+    android:fontFamily="monospace" />
+
+  <TextView
+    android:layout_width="0dp"
+    android:layout_height="wrap_content"
+    android:layout_weight="1"
+    android:importantForAccessibility="no" />
+
+  <ImageView
+    android:id="@+id/termix_widget_summary_dot"
+    android:layout_width="5dp"
+    android:layout_height="5dp"
+    android:layout_marginEnd="4dp"
+    android:src="@drawable/termix_widget_dot"
+    android:importantForAccessibility="no" />
+
+  <TextView
+    android:id="@+id/termix_widget_summary"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:textColor="@color/termix_widget_text_secondary"
+    android:textSize="9sp"
+    android:fontFamily="monospace" />
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_quick.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_quick.xml
new file mode 100644
index 0000000..a0699da
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_quick.xml
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- One launchable host tile. -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:id="@+id/termix_item_root"
+  android:layout_width="match_parent"
+  android:layout_height="wrap_content"
+  android:orientation="vertical"
+  android:paddingStart="7dp"
+  android:paddingEnd="7dp"
+  android:paddingTop="6dp"
+  android:paddingBottom="6dp"
+  android:background="@drawable/termix_widget_card">
+
+  <LinearLayout
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="horizontal"
+    android:gravity="center_vertical">
+
+    <ImageView
+      android:id="@+id/termix_item_dot"
+      android:layout_width="6dp"
+      android:layout_height="6dp"
+      android:layout_marginEnd="5dp"
+      android:src="@drawable/termix_widget_dot"
+      android:importantForAccessibility="no" />
+
+    <TextView
+      android:id="@+id/termix_item_name"
+      android:layout_width="0dp"
+      android:layout_height="wrap_content"
+      android:layout_weight="1"
+      android:maxLines="1"
+      android:ellipsize="end"
+      android:textColor="@color/termix_widget_text_primary"
+      android:textSize="11sp"
+      android:textStyle="bold"
+      android:fontFamily="monospace" />
+
+    <ImageView
+      android:id="@+id/termix_item_pin"
+      android:layout_width="3dp"
+      android:layout_height="3dp"
+      android:layout_marginStart="4dp"
+      android:src="@drawable/termix_widget_pin"
+      android:visibility="gone"
+      android:importantForAccessibility="no" />
+  </LinearLayout>
+
+  <TextView
+    android:id="@+id/termix_item_subtitle"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:layout_marginTop="3dp"
+    android:maxLines="1"
+    android:ellipsize="middle"
+    android:textColor="@color/termix_widget_text_tertiary"
+    android:textSize="9sp"
+    android:fontFamily="monospace" />
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_snippet.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_snippet.xml
new file mode 100644
index 0000000..bb4e57a
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_snippet.xml
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- One saved command. The caret marks it as a snippet without needing icons. -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:id="@+id/termix_item_root"
+  android:layout_width="match_parent"
+  android:layout_height="wrap_content"
+  android:orientation="vertical"
+  android:paddingStart="7dp"
+  android:paddingEnd="7dp"
+  android:paddingTop="6dp"
+  android:paddingBottom="6dp"
+  android:background="@drawable/termix_widget_card">
+
+  <LinearLayout
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="horizontal"
+    android:gravity="center_vertical">
+
+    <TextView
+      android:id="@+id/termix_item_caret"
+      android:layout_width="wrap_content"
+      android:layout_height="wrap_content"
+      android:layout_marginEnd="5dp"
+      android:text="&gt;"
+      android:textColor="#F59145"
+      android:textSize="10sp"
+      android:textStyle="bold"
+      android:fontFamily="monospace" />
+
+    <TextView
+      android:id="@+id/termix_item_name"
+      android:layout_width="0dp"
+      android:layout_height="wrap_content"
+      android:layout_weight="1"
+      android:maxLines="1"
+      android:ellipsize="end"
+      android:textColor="@color/termix_widget_text_primary"
+      android:textSize="11sp"
+      android:textStyle="bold"
+      android:fontFamily="monospace" />
+  </LinearLayout>
+
+  <TextView
+    android:id="@+id/termix_item_preview"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:layout_marginTop="3dp"
+    android:maxLines="1"
+    android:ellipsize="end"
+    android:textColor="@color/termix_widget_text_tertiary"
+    android:textSize="9sp"
+    android:fontFamily="monospace" />
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_status.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_status.xml
new file mode 100644
index 0000000..804cc0b
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_item_status.xml
@@ -0,0 +1,163 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  One host with CPU/memory bars. Each bar is a fixed-width track with a fill
+  TextView whose width and colour are set at runtime — both are remotable on
+  every supported API level, unlike ProgressBar tinting.
+-->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:id="@+id/termix_item_root"
+  android:layout_width="match_parent"
+  android:layout_height="wrap_content"
+  android:orientation="vertical"
+  android:paddingStart="8dp"
+  android:paddingEnd="8dp"
+  android:paddingTop="7dp"
+  android:paddingBottom="7dp"
+  android:background="@drawable/termix_widget_card">
+
+  <LinearLayout
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:orientation="horizontal"
+    android:gravity="center_vertical">
+
+    <ImageView
+      android:id="@+id/termix_item_dot"
+      android:layout_width="6dp"
+      android:layout_height="6dp"
+      android:layout_marginEnd="5dp"
+      android:src="@drawable/termix_widget_dot"
+      android:importantForAccessibility="no" />
+
+    <TextView
+      android:id="@+id/termix_item_name"
+      android:layout_width="wrap_content"
+      android:layout_height="wrap_content"
+      android:maxLines="1"
+      android:ellipsize="end"
+      android:textColor="@color/termix_widget_text_primary"
+      android:textSize="11sp"
+      android:textStyle="bold"
+      android:fontFamily="monospace" />
+
+    <TextView
+      android:id="@+id/termix_item_subtitle"
+      android:layout_width="0dp"
+      android:layout_height="wrap_content"
+      android:layout_weight="1"
+      android:layout_marginStart="6dp"
+      android:gravity="end"
+      android:maxLines="1"
+      android:ellipsize="middle"
+      android:textColor="@color/termix_widget_text_tertiary"
+      android:textSize="8sp"
+      android:fontFamily="monospace" />
+  </LinearLayout>
+
+  <TextView
+    android:id="@+id/termix_item_offline"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:layout_marginTop="5dp"
+    android:textColor="@color/termix_widget_text_tertiary"
+    android:textSize="8sp"
+    android:textStyle="bold"
+    android:letterSpacing="0.1"
+    android:visibility="gone"
+    android:fontFamily="monospace" />
+
+  <LinearLayout
+    android:id="@+id/termix_item_metrics"
+    android:layout_width="match_parent"
+    android:layout_height="wrap_content"
+    android:layout_marginTop="6dp"
+    android:orientation="horizontal">
+
+    <!-- CPU -->
+    <LinearLayout
+      android:layout_width="wrap_content"
+      android:layout_height="wrap_content"
+      android:orientation="vertical"
+      android:layout_marginEnd="12dp">
+
+      <LinearLayout
+        android:layout_width="@dimen/termix_widget_track_width"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal">
+
+        <TextView
+          android:layout_width="0dp"
+          android:layout_height="wrap_content"
+          android:layout_weight="1"
+          android:text="CPU"
+          android:textColor="@color/termix_widget_text_tertiary"
+          android:textSize="8sp"
+          android:textStyle="bold"
+          android:letterSpacing="0.08"
+          android:fontFamily="monospace" />
+
+        <TextView
+          android:id="@+id/termix_item_cpu_value"
+          android:layout_width="wrap_content"
+          android:layout_height="wrap_content"
+          android:textColor="@color/termix_widget_text_secondary"
+          android:textSize="8sp"
+          android:fontFamily="monospace" />
+      </LinearLayout>
+
+      <!-- Block meter. Drawn as monospaced text with colour spans: the only
+           fully dynamic bar that needs no API-gated RemoteViews call. -->
+      <TextView
+        android:id="@+id/termix_item_cpu_bar"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="2dp"
+        android:includeFontPadding="false"
+        android:textSize="7sp"
+        android:fontFamily="monospace" />
+    </LinearLayout>
+
+    <!-- Memory -->
+    <LinearLayout
+      android:layout_width="wrap_content"
+      android:layout_height="wrap_content"
+      android:orientation="vertical">
+
+      <LinearLayout
+        android:layout_width="@dimen/termix_widget_track_width"
+        android:layout_height="wrap_content"
+        android:orientation="horizontal">
+
+        <TextView
+          android:layout_width="0dp"
+          android:layout_height="wrap_content"
+          android:layout_weight="1"
+          android:text="MEM"
+          android:textColor="@color/termix_widget_text_tertiary"
+          android:textSize="8sp"
+          android:textStyle="bold"
+          android:letterSpacing="0.08"
+          android:fontFamily="monospace" />
+
+        <TextView
+          android:id="@+id/termix_item_mem_value"
+          android:layout_width="wrap_content"
+          android:layout_height="wrap_content"
+          android:textColor="@color/termix_widget_text_secondary"
+          android:textSize="8sp"
+          android:fontFamily="monospace" />
+      </LinearLayout>
+
+      <!-- Block meter. Drawn as monospaced text with colour spans: the only
+           fully dynamic bar that needs no API-gated RemoteViews call. -->
+      <TextView
+        android:id="@+id/termix_item_mem_bar"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="2dp"
+        android:includeFontPadding="false"
+        android:textSize="7sp"
+        android:fontFamily="monospace" />
+    </LinearLayout>
+  </LinearLayout>
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_quick_connect.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_quick_connect.xml
new file mode 100644
index 0000000..da37986
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_quick_connect.xml
@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Quick Connect widget: a scrollable grid of host tiles. The column count is
+  adapted to the widget's width by QuickConnectWidgetProvider.
+-->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:layout_width="match_parent"
+  android:layout_height="match_parent"
+  android:orientation="vertical"
+  android:padding="@dimen/termix_widget_padding"
+  android:background="@drawable/termix_widget_background">
+
+  <include layout="@layout/termix_widget_header" />
+
+  <FrameLayout
+    android:layout_width="match_parent"
+    android:layout_height="0dp"
+    android:layout_weight="1">
+
+    <GridView
+      android:id="@+id/termix_widget_grid"
+      android:layout_width="match_parent"
+      android:layout_height="match_parent"
+      android:numColumns="auto_fit"
+      android:columnWidth="@dimen/termix_widget_tile_width"
+      android:stretchMode="columnWidth"
+      android:horizontalSpacing="@dimen/termix_widget_gap"
+      android:verticalSpacing="@dimen/termix_widget_gap"
+      android:scrollbars="none"
+      android:listSelector="@android:color/transparent" />
+
+    <include layout="@layout/termix_widget_empty" />
+  </FrameLayout>
+
+  <include layout="@layout/termix_widget_footer" />
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_snippets.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_snippets.xml
new file mode 100644
index 0000000..bb9c287
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_snippets.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Snippets widget: tapping a row runs that command on a host chosen in the app. -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:layout_width="match_parent"
+  android:layout_height="match_parent"
+  android:orientation="vertical"
+  android:padding="@dimen/termix_widget_padding"
+  android:background="@drawable/termix_widget_background">
+
+  <include layout="@layout/termix_widget_header" />
+
+  <FrameLayout
+    android:layout_width="match_parent"
+    android:layout_height="0dp"
+    android:layout_weight="1">
+
+    <ListView
+      android:id="@+id/termix_widget_snippet_list"
+      android:layout_width="match_parent"
+      android:layout_height="match_parent"
+      android:divider="@android:color/transparent"
+      android:dividerHeight="@dimen/termix_widget_gap"
+      android:scrollbars="none"
+      android:listSelector="@android:color/transparent" />
+
+    <include layout="@layout/termix_widget_empty" />
+  </FrameLayout>
+
+  <include layout="@layout/termix_widget_footer" />
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/layout/termix_widget_status.xml b/modules/termix-widgets/android/src/main/res/layout/termix_widget_status.xml
new file mode 100644
index 0000000..a2375d1
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/layout/termix_widget_status.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Server Status widget: one row per host with CPU and memory bars. -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+  android:layout_width="match_parent"
+  android:layout_height="match_parent"
+  android:orientation="vertical"
+  android:padding="@dimen/termix_widget_padding"
+  android:background="@drawable/termix_widget_background">
+
+  <include layout="@layout/termix_widget_header" />
+
+  <FrameLayout
+    android:layout_width="match_parent"
+    android:layout_height="0dp"
+    android:layout_weight="1">
+
+    <ListView
+      android:id="@+id/termix_widget_list"
+      android:layout_width="match_parent"
+      android:layout_height="match_parent"
+      android:divider="@android:color/transparent"
+      android:dividerHeight="@dimen/termix_widget_gap"
+      android:scrollbars="none"
+      android:listSelector="@android:color/transparent" />
+
+    <include layout="@layout/termix_widget_empty" />
+  </FrameLayout>
+
+  <include layout="@layout/termix_widget_footer" />
+</LinearLayout>
diff --git a/modules/termix-widgets/android/src/main/res/values-v31/termix_widget_dimens.xml b/modules/termix-widgets/android/src/main/res/values-v31/termix_widget_dimens.xml
new file mode 100644
index 0000000..741751d
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/values-v31/termix_widget_dimens.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+  <!-- Android 12+ exposes the launcher's widget corner radius; matching it
+       makes the widget sit flush with system widgets. -->
+  <dimen name="termix_widget_radius">@android:dimen/system_app_widget_background_radius</dimen>
+</resources>
diff --git a/modules/termix-widgets/android/src/main/res/values/termix_widget_colors.xml b/modules/termix-widgets/android/src/main/res/values/termix_widget_colors.xml
new file mode 100644
index 0000000..2073452
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/values/termix_widget_colors.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  Widget palette. Mirrors app/constants/designTokens.ts and the iOS widget
+  theme so a Termix widget looks identical on both platforms. The accent is not
+  listed here: it travels in the snapshot and is applied at runtime.
+-->
+<resources>
+  <color name="termix_widget_background">#0C0D0B</color>
+  <color name="termix_widget_surface">#141513</color>
+  <color name="termix_widget_card">#181917</color>
+  <color name="termix_widget_border">#2A2A2A</color>
+  <color name="termix_widget_track">#3A3A3A</color>
+
+  <color name="termix_widget_text_primary">#FAFAFA</color>
+  <color name="termix_widget_text_secondary">#A4A4A4</color>
+  <color name="termix_widget_text_tertiary">#737373</color>
+</resources>
diff --git a/modules/termix-widgets/android/src/main/res/values/termix_widget_dimens.xml b/modules/termix-widgets/android/src/main/res/values/termix_widget_dimens.xml
new file mode 100644
index 0000000..3844cbf
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/values/termix_widget_dimens.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+  <!-- Overridden on API 31+ to match the launcher's own corner radius. -->
+  <dimen name="termix_widget_radius">16dp</dimen>
+  <dimen name="termix_widget_padding">12dp</dimen>
+  <dimen name="termix_widget_gap">6dp</dimen>
+  <dimen name="termix_widget_track_width">62dp</dimen>
+  <!-- Minimum tile width; GridView fits as many columns as the widget allows. -->
+  <dimen name="termix_widget_tile_width">128dp</dimen>
+  <dimen name="termix_widget_bar_height">3dp</dimen>
+</resources>
diff --git a/modules/termix-widgets/android/src/main/res/values/termix_widget_strings.xml b/modules/termix-widgets/android/src/main/res/values/termix_widget_strings.xml
new file mode 100644
index 0000000..f872438
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/values/termix_widget_strings.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+  <string name="termix_widget_quick_connect_label">Termix Quick Connect</string>
+  <string name="termix_widget_quick_connect_description">Jump straight into a terminal session on your servers.</string>
+  <string name="termix_widget_status_label">Termix Server Status</string>
+  <string name="termix_widget_status_description">CPU and memory load for the servers you care about.</string>
+  <string name="termix_widget_snippets_label">Termix Snippets</string>
+  <string name="termix_widget_snippets_description">Run one of your saved commands on any server.</string>
+  <string name="termix_widget_wordmark">TERMIX</string>
+  <string name="termix_widget_snippets_wordmark">SNIPPETS</string>
+  <string name="termix_widget_open_action">OPEN TERMIX</string>
+</resources>
diff --git a/modules/termix-widgets/android/src/main/res/xml/termix_widget_quick_connect_info.xml b/modules/termix-widgets/android/src/main/res/xml/termix_widget_quick_connect_info.xml
new file mode 100644
index 0000000..35bd899
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/xml/termix_widget_quick_connect_info.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+  android:minWidth="180dp"
+  android:minHeight="110dp"
+  android:minResizeWidth="110dp"
+  android:minResizeHeight="70dp"
+  android:targetCellWidth="4"
+  android:targetCellHeight="2"
+  android:resizeMode="horizontal|vertical"
+  android:widgetCategory="home_screen"
+  android:description="@string/termix_widget_quick_connect_description"
+  android:previewLayout="@layout/termix_widget_quick_connect"
+  android:initialLayout="@layout/termix_widget_quick_connect"
+  android:updatePeriodMillis="0" />
diff --git a/modules/termix-widgets/android/src/main/res/xml/termix_widget_snippets_info.xml b/modules/termix-widgets/android/src/main/res/xml/termix_widget_snippets_info.xml
new file mode 100644
index 0000000..96f09b7
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/xml/termix_widget_snippets_info.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+  android:minWidth="180dp"
+  android:minHeight="110dp"
+  android:minResizeWidth="110dp"
+  android:minResizeHeight="70dp"
+  android:targetCellWidth="3"
+  android:targetCellHeight="2"
+  android:resizeMode="horizontal|vertical"
+  android:widgetCategory="home_screen"
+  android:description="@string/termix_widget_snippets_description"
+  android:previewLayout="@layout/termix_widget_snippets"
+  android:initialLayout="@layout/termix_widget_snippets"
+  android:updatePeriodMillis="0" />
diff --git a/modules/termix-widgets/android/src/main/res/xml/termix_widget_status_info.xml b/modules/termix-widgets/android/src/main/res/xml/termix_widget_status_info.xml
new file mode 100644
index 0000000..fb7d113
--- /dev/null
+++ b/modules/termix-widgets/android/src/main/res/xml/termix_widget_status_info.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+  android:minWidth="250dp"
+  android:minHeight="110dp"
+  android:minResizeWidth="180dp"
+  android:minResizeHeight="70dp"
+  android:targetCellWidth="4"
+  android:targetCellHeight="2"
+  android:resizeMode="horizontal|vertical"
+  android:widgetCategory="home_screen"
+  android:description="@string/termix_widget_status_description"
+  android:previewLayout="@layout/termix_widget_status"
+  android:initialLayout="@layout/termix_widget_status"
+  android:updatePeriodMillis="0" />
diff --git a/modules/termix-widgets/expo-module.config.json b/modules/termix-widgets/expo-module.config.json
new file mode 100644
index 0000000..fa7ab35
--- /dev/null
+++ b/modules/termix-widgets/expo-module.config.json
@@ -0,0 +1,9 @@
+{
+  "platforms": ["ios", "android"],
+  "ios": {
+    "modules": ["TermixWidgetsModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.termixwidgets.TermixWidgetsModule"]
+  }
+}
diff --git a/modules/termix-widgets/index.ts b/modules/termix-widgets/index.ts
new file mode 100644
index 0000000..b94556a
--- /dev/null
+++ b/modules/termix-widgets/index.ts
@@ -0,0 +1,60 @@
+/**
+ * TermixWidgets — thin bridge to the native home-screen widget hosts.
+ *
+ * The app hands the native side one JSON string (see app/widgets/types.ts for
+ * the contract); the native side persists it in shared storage (App Group on
+ * iOS, SharedPreferences on Android) and asks the widget host to redraw.
+ *
+ * Every export is a no-op when the native module is unavailable — Expo Go, web,
+ * and older dev clients all fall into that bucket — so callers never need to
+ * guard by platform.
+ */
+
+import { requireOptionalNativeModule } from "expo-modules-core";
+
+interface TermixWidgetsNativeModule {
+  /** False on platforms/OS versions where widgets can't be hosted. */
+  readonly isSupported: boolean;
+  /** Shared-storage container id, exposed for diagnostics. */
+  readonly containerId: string;
+  setSnapshot(json: string): Promise<void>;
+  clearSnapshot(): Promise<void>;
+  reloadWidgets(): Promise<void>;
+}
+
+const NativeModule =
+  requireOptionalNativeModule<TermixWidgetsNativeModule>("TermixWidgets");
+
+/**
+ * Whether home-screen widgets can be driven on this device/build.
+ * Note this is about the *native module* being present — the user may still
+ * have zero widgets placed on their home screen, which we can't detect.
+ */
+export const isWidgetSupported: boolean = NativeModule?.isSupported ?? false;
+
+/** Shared container identifier (App Group / SharedPreferences name), or "". */
+export const widgetContainerId: string = NativeModule?.containerId ?? "";
+
+/**
+ * Publishes a snapshot and refreshes every placed widget.
+ * Resolves to true when the payload reached the native side.
+ */
+export async function setWidgetSnapshotJson(json: string): Promise<boolean> {
+  if (!NativeModule) return false;
+  await NativeModule.setSnapshot(json);
+  return true;
+}
+
+/** Wipes the stored snapshot — widgets fall back to their signed-out state. */
+export async function clearWidgetSnapshot(): Promise<boolean> {
+  if (!NativeModule) return false;
+  await NativeModule.clearSnapshot();
+  return true;
+}
+
+/** Asks the widget host to redraw without changing the stored payload. */
+export async function reloadWidgets(): Promise<boolean> {
+  if (!NativeModule) return false;
+  await NativeModule.reloadWidgets();
+  return true;
+}
diff --git a/modules/termix-widgets/ios/TermixWidgets.podspec b/modules/termix-widgets/ios/TermixWidgets.podspec
new file mode 100644
index 0000000..fd1ad3c
--- /dev/null
+++ b/modules/termix-widgets/ios/TermixWidgets.podspec
@@ -0,0 +1,23 @@
+Pod::Spec.new do |s|
+  s.name           = 'TermixWidgets'
+  s.version        = '1.0.0'
+  s.summary        = 'Bridges Termix host data to the iOS home-screen widgets.'
+  s.description    = 'Writes the widget snapshot into the shared App Group container and reloads WidgetKit timelines.'
+  s.author         = 'Termix'
+  s.homepage       = 'https://github.com/Termix-SSH/Mobile'
+  s.platforms      = { :ios => '15.1' }
+  s.source         = { git: 'https://github.com/Termix-SSH/Mobile' }
+  s.license        = { :type => 'MIT' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+    'SWIFT_COMPILATION_MODE' => 'wholemodule'
+  }
+
+  # Only the module bridge is compiled into the app. Everything under `widget/`
+  # belongs to the WidgetKit extension target, which the config plugin creates.
+  s.source_files = '*.{h,m,mm,swift,hpp,cpp}'
+end
diff --git a/modules/termix-widgets/ios/TermixWidgetsModule.swift b/modules/termix-widgets/ios/TermixWidgetsModule.swift
new file mode 100644
index 0000000..d08dd97
--- /dev/null
+++ b/modules/termix-widgets/ios/TermixWidgetsModule.swift
@@ -0,0 +1,87 @@
+import ExpoModulesCore
+import WidgetKit
+
+/**
+ Bridges the JS widget layer to WidgetKit.
+
+ The app writes one JSON snapshot into the shared App Group container; the
+ widget extension reads it back. Keeping the transport to a single string keeps
+ the two sides decoupled — the contract lives in `app/widgets/types.ts`.
+ */
+public class TermixWidgetsModule: Module {
+  /// Info.plist key injected by `plugins/withTermixWidgets.js`.
+  private static let appGroupInfoKey = "TermixWidgetsAppGroup"
+
+  /// Shared key. Must match `SharedStore.snapshotKey` in the widget target.
+  private static let snapshotKey = "termix.widget.snapshot.v1"
+
+  public func definition() -> ModuleDefinition {
+    Name("TermixWidgets")
+
+    Constants([
+      "isSupported": TermixWidgetsModule.isSupported,
+      "containerId": TermixWidgetsModule.appGroupId ?? "",
+    ])
+
+    AsyncFunction("setSnapshot") { (json: String) in
+      try TermixWidgetsModule.write(json)
+      TermixWidgetsModule.reload()
+    }
+
+    AsyncFunction("clearSnapshot") {
+      try TermixWidgetsModule.write(nil)
+      TermixWidgetsModule.reload()
+    }
+
+    AsyncFunction("reloadWidgets") {
+      TermixWidgetsModule.reload()
+    }
+  }
+
+  // MARK: - Shared container
+
+  /// App Group identifier the extension and the app share.
+  private static var appGroupId: String? {
+    guard
+      let value = Bundle.main.object(forInfoDictionaryKey: appGroupInfoKey) as? String,
+      !value.isEmpty
+    else {
+      return nil
+    }
+    return value
+  }
+
+  /// Widgets need both WidgetKit (iOS 14+) and a configured App Group.
+  private static var isSupported: Bool {
+    if #available(iOS 14.0, *) {
+      return appGroupId != nil
+    }
+    return false
+  }
+
+  private static func write(_ json: String?) throws {
+    guard let groupId = appGroupId else {
+      throw Exception(
+        name: "ERR_TERMIX_WIDGETS_NO_APP_GROUP",
+        description: "No App Group is configured; the widget extension is not installed in this build."
+      )
+    }
+    guard let defaults = UserDefaults(suiteName: groupId) else {
+      throw Exception(
+        name: "ERR_TERMIX_WIDGETS_CONTAINER",
+        description: "The shared container \(groupId) is not accessible."
+      )
+    }
+
+    if let json {
+      defaults.set(json, forKey: snapshotKey)
+    } else {
+      defaults.removeObject(forKey: snapshotKey)
+    }
+  }
+
+  private static func reload() {
+    guard #available(iOS 14.0, *) else { return }
+    WidgetCenter.shared.reloadAllTimelines()
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/Info.plist b/modules/termix-widgets/ios/widget/Info.plist
new file mode 100644
index 0000000..7e49ff3
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/Info.plist
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleDisplayName</key>
+	<string>Termix</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<!-- App extensions are XPC bundles; PRODUCT_BUNDLE_PACKAGE_TYPE is no
+	     longer defined by recent Xcode versions, so spell it out. -->
+	<key>CFBundlePackageType</key>
+	<string>XPC!</string>
+	<key>CFBundleShortVersionString</key>
+	<string>$(MARKETING_VERSION)</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSExtension</key>
+	<dict>
+		<key>NSExtensionPointIdentifier</key>
+		<string>com.apple.widgetkit-extension</string>
+	</dict>
+	<key>TermixWidgetsAppGroup</key>
+	<string>$(TERMIX_WIDGETS_APP_GROUP)</string>
+</dict>
+</plist>
diff --git a/modules/termix-widgets/ios/widget/QuickConnectWidget.swift b/modules/termix-widgets/ios/widget/QuickConnectWidget.swift
new file mode 100644
index 0000000..5d5e126
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/QuickConnectWidget.swift
@@ -0,0 +1,189 @@
+import WidgetKit
+import SwiftUI
+
+/**
+ Quick Connect — a launcher for your hosts.
+
+ Small shows the single most relevant host (pinned first, then online), medium a
+ 2×2 grid, large a 2×4 grid with a summary strip. Every tile deep-links straight
+ into a terminal session for that host.
+ */
+struct QuickConnectWidget: Widget {
+  static let kind = "TermixQuickConnectWidget"
+
+  var body: some WidgetConfiguration {
+    StaticConfiguration(kind: Self.kind, provider: TermixProvider()) { entry in
+      QuickConnectView(entry: entry)
+    }
+    .configurationDisplayName("Quick Connect")
+    .description("Jump straight into a terminal session on your servers.")
+    .supportedFamilies([.systemSmall, .systemMedium, .systemLarge])
+  }
+}
+
+struct QuickConnectView: View {
+  @Environment(\.widgetFamily) private var family
+  let entry: TermixEntry
+
+  private var snapshot: WidgetSnapshot { entry.snapshot }
+  private var accent: Color { Theme.accent(snapshot.accent) }
+
+  /// Tiles each family can show without cramping.
+  private var capacity: Int {
+    switch family {
+    case .systemSmall: return 1
+    case .systemMedium: return 4
+    default: return 8
+    }
+  }
+
+  var body: some View {
+    Group {
+      if snapshot.hosts.isEmpty {
+        EmptyStateView(snapshot: snapshot, accent: accent, compact: family == .systemSmall)
+      } else {
+        switch family {
+        case .systemSmall: smallLayout
+        case .systemMedium: gridLayout(columns: 2)
+        default: largeLayout
+        }
+      }
+    }
+    .padding(family == .systemSmall ? 10 : 12)
+    .widgetBackground()
+  }
+
+  // MARK: - Layouts
+
+  private var featured: HostEntry? { snapshot.hosts.first }
+
+  private var smallLayout: some View {
+    VStack(alignment: .leading, spacing: 0) {
+      WidgetHeader(snapshot: snapshot, accent: accent)
+
+      Spacer(minLength: 6)
+
+      if let host = featured {
+        VStack(alignment: .leading, spacing: 5) {
+          HStack(spacing: 5) {
+            StatusDot(status: host.status, size: 7)
+            Text(host.name)
+              .font(Theme.mono(14, weight: .bold))
+              .foregroundColor(Theme.textPrimary)
+              .lineLimit(1)
+              .minimumScaleFactor(0.75)
+          }
+
+          if !host.subtitle.isEmpty {
+            Text(host.subtitle)
+              .font(Theme.mono(9))
+              .foregroundColor(Theme.textTertiary)
+              .lineLimit(1)
+              .truncationMode(.middle)
+          }
+
+          if host.status == .online && (host.cpu != nil || host.mem != nil) {
+            HStack(spacing: 10) {
+              MetricBar(label: "CPU", percent: host.cpu, accent: accent)
+              MetricBar(label: "MEM", percent: host.mem, accent: accent)
+            }
+            .padding(.top, 1)
+          }
+        }
+      }
+
+      Spacer(minLength: 6)
+
+      HStack(spacing: 4) {
+        Rectangle().fill(accent).frame(width: 6, height: 1)
+        Text("CONNECT")
+          .font(Theme.label(8))
+          .tracking(1.2)
+          .foregroundColor(accent)
+        Spacer(minLength: 2)
+        Text(relativeAge(from: snapshot.updatedDate))
+          .font(Theme.mono(8))
+          .foregroundColor(Theme.textTertiary)
+      }
+    }
+    .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .leading)
+    .widgetURL(featured?.link ?? WidgetSnapshot.fallbackLink)
+  }
+
+  private func gridLayout(columns: Int) -> some View {
+    VStack(alignment: .leading, spacing: 8) {
+      WidgetHeader(snapshot: snapshot, accent: accent)
+      tileGrid(columns: columns)
+      Spacer(minLength: 0)
+      WidgetFooter(snapshot: snapshot)
+    }
+    .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
+  }
+
+  private var largeLayout: some View {
+    VStack(alignment: .leading, spacing: 8) {
+      WidgetHeader(snapshot: snapshot, accent: accent)
+      SummaryStrip(summary: snapshot.summary, accent: accent)
+      tileGrid(columns: 2)
+      Spacer(minLength: 0)
+      WidgetFooter(snapshot: snapshot)
+    }
+    .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
+  }
+
+  private func tileGrid(columns: Int) -> some View {
+    let visible = Array(snapshot.hosts.prefix(capacity))
+    return VStack(spacing: 6) {
+      ForEach(Array(chunked(visible, into: columns).enumerated()), id: \.offset) { _, row in
+        HStack(spacing: 6) {
+          ForEach(row) { host in
+            HostTile(host: host, accent: accent)
+          }
+          // Keep the last row aligned with the ones above it.
+          if row.count < columns {
+            ForEach(0..<(columns - row.count), id: \.self) { _ in
+              Color.clear.frame(maxWidth: .infinity)
+            }
+          }
+        }
+      }
+    }
+  }
+}
+
+/// online / offline / total counters shown on the large family.
+struct SummaryStrip: View {
+  let summary: HostSummary
+  let accent: Color
+
+  var body: some View {
+    HStack(spacing: 0) {
+      counter(value: summary.online, label: "ONLINE", color: Theme.online)
+      divider
+      counter(value: summary.offline, label: "OFFLINE", color: Theme.offline)
+      divider
+      counter(value: summary.total, label: "HOSTS", color: accent)
+    }
+    .padding(.vertical, 6)
+    .termixCard(fill: Theme.surface)
+  }
+
+  private var divider: some View {
+    Rectangle()
+      .fill(Theme.border)
+      .frame(width: 1, height: 20)
+  }
+
+  private func counter(value: Int, label: String, color: Color) -> some View {
+    VStack(spacing: 1) {
+      Text("\(value)")
+        .font(Theme.mono(14, weight: .bold))
+        .foregroundColor(color)
+      Text(label)
+        .font(Theme.label(8))
+        .tracking(0.9)
+        .foregroundColor(Theme.textTertiary)
+    }
+    .frame(maxWidth: .infinity)
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/SharedStore.swift b/modules/termix-widgets/ios/widget/SharedStore.swift
new file mode 100644
index 0000000..ed4ec28
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/SharedStore.swift
@@ -0,0 +1,48 @@
+import Foundation
+
+/**
+ Reads the snapshot the app writes into the shared App Group container.
+
+ Failure is never fatal: an unreadable, malformed, or future-versioned payload
+ degrades to the signed-out state rather than an empty or broken widget.
+ */
+enum SharedStore {
+  /// Must match `TermixWidgetsModule.snapshotKey` in the app target.
+  static let snapshotKey = "termix.widget.snapshot.v1"
+
+  /// Injected into the extension's Info.plist by `plugins/withTermixWidgets.js`.
+  private static let appGroupInfoKey = "TermixWidgetsAppGroup"
+
+  static var appGroupId: String? {
+    guard
+      let value = Bundle.main.object(forInfoDictionaryKey: appGroupInfoKey) as? String,
+      !value.isEmpty
+    else {
+      return nil
+    }
+    return value
+  }
+
+  static func loadSnapshot() -> WidgetSnapshot {
+    guard
+      let groupId = appGroupId,
+      let defaults = UserDefaults(suiteName: groupId),
+      let json = defaults.string(forKey: snapshotKey),
+      let data = json.data(using: .utf8)
+    else {
+      return .signedOut()
+    }
+
+    do {
+      let snapshot = try JSONDecoder().decode(WidgetSnapshot.self, from: data)
+      // A payload written by a newer app version may mean something different;
+      // showing the signed-out card is safer than rendering it wrong.
+      guard snapshot.version == WidgetSnapshot.supportedVersion else {
+        return .signedOut(accent: snapshot.accent)
+      }
+      return snapshot
+    } catch {
+      return .signedOut()
+    }
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/SnippetsWidget.swift b/modules/termix-widgets/ios/widget/SnippetsWidget.swift
new file mode 100644
index 0000000..f8576f7
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/SnippetsWidget.swift
@@ -0,0 +1,102 @@
+import WidgetKit
+import SwiftUI
+
+/**
+ Snippets — the commands you keep reaching for, one tap from the home screen.
+
+ Tapping a snippet opens Termix and asks which host to run it on. Only the
+ snippet id travels in the deep link; the command itself is read (and executed)
+ inside the authenticated app.
+ */
+struct SnippetsWidget: Widget {
+  static let kind = "TermixSnippetsWidget"
+
+  var body: some WidgetConfiguration {
+    StaticConfiguration(kind: Self.kind, provider: TermixProvider()) { entry in
+      SnippetsView(entry: entry)
+    }
+    .configurationDisplayName("Snippets")
+    .description("Run one of your saved commands on any server.")
+    .supportedFamilies([.systemSmall, .systemMedium, .systemLarge])
+  }
+}
+
+struct SnippetsView: View {
+  @Environment(\.widgetFamily) private var family
+  let entry: TermixEntry
+
+  private var snapshot: WidgetSnapshot { entry.snapshot }
+  private var accent: Color { Theme.accent(snapshot.accent) }
+
+  private var capacity: Int {
+    switch family {
+    case .systemSmall: return 3
+    case .systemMedium: return 4
+    default: return 8
+    }
+  }
+
+  private var visible: [SnippetEntry] {
+    Array(snapshot.snippets.prefix(capacity))
+  }
+
+  var body: some View {
+    Group {
+      if snapshot.snippets.isEmpty {
+        EmptyStateView(
+          snapshot: snapshot,
+          accent: accent,
+          compact: family == .systemSmall,
+          subject: "snippets"
+        )
+      } else {
+        VStack(alignment: .leading, spacing: 8) {
+          header
+          list
+          Spacer(minLength: 0)
+          if family != .systemSmall {
+            WidgetFooter(snapshot: snapshot)
+          }
+        }
+        .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
+        // `Link` is inert on the small family, so the whole widget opens the
+        // snippets list there instead of silently doing nothing.
+        .widgetURL(family == .systemSmall ? WidgetSnapshot.snippetsLink : nil)
+      }
+    }
+    .padding(family == .systemSmall ? 10 : 12)
+    .widgetBackground()
+  }
+
+  private var header: some View {
+    HStack(spacing: 6) {
+      Rectangle()
+        .fill(accent)
+        .frame(width: 3, height: 11)
+
+      Text("SNIPPETS")
+        .font(Theme.label(9))
+        .tracking(1.4)
+        .foregroundColor(Theme.textPrimary)
+
+      Spacer(minLength: 4)
+
+      Text("\(snapshot.snippets.count)")
+        .font(Theme.mono(9, weight: .medium))
+        .foregroundColor(Theme.textSecondary)
+    }
+  }
+
+  private var list: some View {
+    // One column reads better than a grid: commands are wide, names are short.
+    VStack(spacing: 6) {
+      ForEach(visible) { snippet in
+        SnippetTile(
+          snippet: snippet,
+          accent: accent,
+          showsPreview: family != .systemSmall
+        )
+      }
+    }
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/StatusWidget.swift b/modules/termix-widgets/ios/widget/StatusWidget.swift
new file mode 100644
index 0000000..ca4f2ae
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/StatusWidget.swift
@@ -0,0 +1,118 @@
+import WidgetKit
+import SwiftUI
+
+/**
+ Server Status — CPU and memory at a glance.
+
+ Reads the same snapshot as Quick Connect but leads with load rather than
+ launching: small focuses on one host, medium and large list several. Rows are
+ still tappable, so it doubles as a launcher.
+ */
+struct StatusWidget: Widget {
+  static let kind = "TermixStatusWidget"
+
+  var body: some WidgetConfiguration {
+    StaticConfiguration(kind: Self.kind, provider: TermixProvider()) { entry in
+      StatusView(entry: entry)
+    }
+    .configurationDisplayName("Server Status")
+    .description("CPU and memory load for the servers you care about.")
+    .supportedFamilies([.systemSmall, .systemMedium, .systemLarge])
+  }
+}
+
+struct StatusView: View {
+  @Environment(\.widgetFamily) private var family
+  let entry: TermixEntry
+
+  private var snapshot: WidgetSnapshot { entry.snapshot }
+  private var accent: Color { Theme.accent(snapshot.accent) }
+
+  private var rowCount: Int {
+    switch family {
+    case .systemSmall: return 1
+    case .systemMedium: return 3
+    default: return 6
+    }
+  }
+
+  /// Online hosts carry metrics; fall back to everything so the widget is never
+  /// blank just because nothing is reporting yet.
+  private var rankedHosts: [HostEntry] {
+    let online = snapshot.hosts.filter { $0.status == .online }
+    let source = online.isEmpty ? snapshot.hosts : online
+    return Array(source.prefix(rowCount))
+  }
+
+  var body: some View {
+    Group {
+      if snapshot.hosts.isEmpty {
+        EmptyStateView(snapshot: snapshot, accent: accent, compact: family == .systemSmall)
+      } else if family == .systemSmall {
+        smallLayout
+      } else {
+        listLayout
+      }
+    }
+    .padding(family == .systemSmall ? 10 : 12)
+    .widgetBackground()
+  }
+
+  // MARK: - Layouts
+
+  private var smallLayout: some View {
+    let host = rankedHosts.first
+    return VStack(alignment: .leading, spacing: 0) {
+      WidgetHeader(snapshot: snapshot, accent: accent)
+
+      Spacer(minLength: 6)
+
+      if let host {
+        VStack(alignment: .leading, spacing: 8) {
+          HStack(spacing: 5) {
+            StatusDot(status: host.status, size: 7)
+            Text(host.name)
+              .font(Theme.mono(13, weight: .bold))
+              .foregroundColor(Theme.textPrimary)
+              .lineLimit(1)
+              .minimumScaleFactor(0.75)
+          }
+
+          if host.status == .online {
+            VStack(spacing: 7) {
+              MetricBar(label: "CPU", percent: host.cpu, accent: accent)
+              MetricBar(label: "MEM", percent: host.mem, accent: accent)
+            }
+          } else {
+            Text(host.status == .offline ? "OFFLINE" : "STATUS UNKNOWN")
+              .font(Theme.label(9))
+              .tracking(0.9)
+              .foregroundColor(Theme.textTertiary)
+          }
+        }
+      }
+
+      Spacer(minLength: 6)
+
+      WidgetFooter(snapshot: snapshot)
+    }
+    .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .leading)
+    .widgetURL(host?.link ?? WidgetSnapshot.fallbackLink)
+  }
+
+  private var listLayout: some View {
+    VStack(alignment: .leading, spacing: 8) {
+      WidgetHeader(snapshot: snapshot, accent: accent)
+
+      VStack(spacing: 6) {
+        ForEach(rankedHosts) { host in
+          HostMetricRow(host: host, accent: accent, showsSubtitle: family != .systemMedium)
+        }
+      }
+
+      Spacer(minLength: 0)
+      WidgetFooter(snapshot: snapshot)
+    }
+    .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/TermixProvider.swift b/modules/termix-widgets/ios/widget/TermixProvider.swift
new file mode 100644
index 0000000..8d6b1a7
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/TermixProvider.swift
@@ -0,0 +1,44 @@
+import WidgetKit
+import SwiftUI
+
+/**
+ Timeline provider shared by both widget kinds.
+
+ There is no network access here by design: the extension only reads what the
+ app already published. It still schedules a periodic refresh so the "updated
+ 3m ago" footer stays honest even when the app hasn't run in a while.
+ */
+struct TermixEntry: TimelineEntry {
+  let date: Date
+  let snapshot: WidgetSnapshot
+}
+
+struct TermixProvider: TimelineProvider {
+  /// How often the extension re-renders from the already-stored snapshot.
+  private static let refreshInterval: TimeInterval = 15 * 60
+
+  func placeholder(in context: Context) -> TermixEntry {
+    TermixEntry(date: Date(), snapshot: .placeholder)
+  }
+
+  func getSnapshot(in context: Context, completion: @escaping (TermixEntry) -> Void) {
+    // The gallery preview should always look populated.
+    let snapshot = context.isPreview ? WidgetSnapshot.placeholder : SharedStore.loadSnapshot()
+    completion(TermixEntry(date: Date(), snapshot: snapshot))
+  }
+
+  func getTimeline(in context: Context, completion: @escaping (Timeline<TermixEntry>) -> Void) {
+    let now = Date()
+    let entry = TermixEntry(date: now, snapshot: SharedStore.loadSnapshot())
+    let next = now.addingTimeInterval(Self.refreshInterval)
+    completion(Timeline(entries: [entry], policy: .after(next)))
+  }
+}
+
+/// Splits hosts into rows of `size` for the tile grids.
+func chunked<T>(_ items: [T], into size: Int) -> [[T]] {
+  guard size > 0 else { return [items] }
+  return stride(from: 0, to: items.count, by: size).map { start in
+    Array(items[start..<min(start + size, items.count)])
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/TermixWidgetBundle.swift b/modules/termix-widgets/ios/widget/TermixWidgetBundle.swift
new file mode 100644
index 0000000..40710bb
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/TermixWidgetBundle.swift
@@ -0,0 +1,12 @@
+import SwiftUI
+import WidgetKit
+
+/// Entry point of the widget extension. Both widget kinds appear in the gallery.
+@main
+struct TermixWidgetBundle: WidgetBundle {
+  var body: some Widget {
+    QuickConnectWidget()
+    StatusWidget()
+    SnippetsWidget()
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/WidgetComponents.swift b/modules/termix-widgets/ios/widget/WidgetComponents.swift
new file mode 100644
index 0000000..14f9874
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/WidgetComponents.swift
@@ -0,0 +1,297 @@
+import SwiftUI
+import WidgetKit
+
+/**
+ Shared building blocks. Both widget kinds are assembled from these so the two
+ stay visually identical as either evolves.
+ */
+
+/// Status dot with a soft halo — reads at a glance without needing a legend.
+struct StatusDot: View {
+  let status: HostStatus
+  var size: CGFloat = 6
+
+  var body: some View {
+    let color = Theme.statusColor(status)
+    return Circle()
+      .fill(color)
+      .frame(width: size, height: size)
+      .overlay(
+        Circle()
+          .stroke(color.opacity(0.28), lineWidth: size * 0.55)
+      )
+  }
+}
+
+/// The wordmark + summary line every widget carries.
+struct WidgetHeader: View {
+  let snapshot: WidgetSnapshot
+  let accent: Color
+  var showsSummary: Bool = true
+
+  var body: some View {
+    HStack(spacing: 6) {
+      Rectangle()
+        .fill(accent)
+        .frame(width: 3, height: 11)
+
+      Text("TERMIX")
+        .font(Theme.label(9))
+        .tracking(1.4)
+        .foregroundColor(Theme.textPrimary)
+
+      Spacer(minLength: 4)
+
+      if showsSummary && snapshot.summary.total > 0 {
+        HStack(spacing: 4) {
+          StatusDot(status: .online, size: 5)
+          Text("\(snapshot.summary.online)/\(snapshot.summary.total)")
+            .font(Theme.mono(9, weight: .medium))
+            .foregroundColor(Theme.textSecondary)
+        }
+      }
+    }
+  }
+}
+
+/// Thin usage bar used for CPU / memory.
+struct MetricBar: View {
+  let label: String
+  let percent: Int?
+  let accent: Color
+
+  var body: some View {
+    VStack(alignment: .leading, spacing: 3) {
+      HStack(spacing: 3) {
+        Text(label)
+          .font(Theme.label(8))
+          .tracking(0.6)
+          .foregroundColor(Theme.textTertiary)
+        Spacer(minLength: 2)
+        Text(percent.map { "\($0)%" } ?? "--")
+          .font(Theme.mono(8, weight: .medium))
+          .foregroundColor(percent == nil ? Theme.textTertiary : Theme.textSecondary)
+      }
+
+      GeometryReader { geometry in
+        ZStack(alignment: .leading) {
+          Rectangle()
+            .fill(Theme.borderStrong.opacity(0.55))
+          if let percent {
+            Rectangle()
+              .fill(Theme.loadColor(percent, accent: accent))
+              .frame(width: max(2, geometry.size.width * CGFloat(percent) / 100))
+          }
+        }
+      }
+      .frame(height: 3)
+    }
+  }
+}
+
+/// Launchable host tile used by the Quick Connect widget.
+struct HostTile: View {
+  let host: HostEntry
+  let accent: Color
+  var showsSubtitle: Bool = true
+
+  var body: some View {
+    Link(destination: host.link) {
+      VStack(alignment: .leading, spacing: 3) {
+        HStack(spacing: 5) {
+          StatusDot(status: host.status)
+          Text(host.name)
+            .font(Theme.mono(11, weight: .semibold))
+            .foregroundColor(Theme.textPrimary)
+            .lineLimit(1)
+            .truncationMode(.tail)
+          Spacer(minLength: 0)
+          if host.pinned {
+            Rectangle()
+              .fill(accent.opacity(0.9))
+              .frame(width: 3, height: 3)
+          }
+        }
+
+        if showsSubtitle {
+          Text(host.subtitle.isEmpty ? host.folder : host.subtitle)
+            .font(Theme.mono(9))
+            .foregroundColor(Theme.textTertiary)
+            .lineLimit(1)
+            .truncationMode(.middle)
+        }
+      }
+      .padding(.horizontal, 7)
+      .padding(.vertical, 6)
+      .frame(maxWidth: .infinity, alignment: .leading)
+      .termixCard(
+        fill: host.status == .online ? Theme.cardRaised : Theme.card,
+        border: host.status == .online ? accent.opacity(0.30) : Theme.border
+      )
+    }
+    .accessibilityLabel(host.accessibilityDescription)
+  }
+}
+
+/// Metric row used by the Server Status widget.
+struct HostMetricRow: View {
+  let host: HostEntry
+  let accent: Color
+  var showsSubtitle: Bool = true
+
+  var body: some View {
+    Link(destination: host.link) {
+      VStack(alignment: .leading, spacing: 5) {
+        HStack(spacing: 5) {
+          StatusDot(status: host.status)
+          Text(host.name)
+            .font(Theme.mono(11, weight: .semibold))
+            .foregroundColor(Theme.textPrimary)
+            .lineLimit(1)
+          Spacer(minLength: 4)
+          if showsSubtitle && !host.subtitle.isEmpty {
+            Text(host.subtitle)
+              .font(Theme.mono(8))
+              .foregroundColor(Theme.textTertiary)
+              .lineLimit(1)
+              .truncationMode(.middle)
+          }
+        }
+
+        if host.status == .online {
+          HStack(spacing: 10) {
+            MetricBar(label: "CPU", percent: host.cpu, accent: accent)
+            MetricBar(label: "MEM", percent: host.mem, accent: accent)
+          }
+        } else {
+          Text(host.status == .offline ? "OFFLINE" : "STATUS UNKNOWN")
+            .font(Theme.label(8))
+            .tracking(0.8)
+            .foregroundColor(Theme.textTertiary)
+        }
+      }
+      .padding(.horizontal, 8)
+      .padding(.vertical, 7)
+      .frame(maxWidth: .infinity, alignment: .leading)
+      .termixCard()
+    }
+    .accessibilityLabel(host.accessibilityDescription)
+  }
+}
+
+/// Shown for the signed-out / no-hosts states.
+struct EmptyStateView: View {
+  let snapshot: WidgetSnapshot
+  let accent: Color
+  var compact: Bool = false
+  /// What the widget would have listed — drives the "nothing here yet" copy.
+  var subject: String = "hosts"
+
+  /// True when the account has hosts but the widget's filters excluded them —
+  /// "no hosts yet" would be a lie in that case.
+  private var filteredOut: Bool {
+    snapshot.state != .signedOut && snapshot.summary.total > 0
+  }
+
+  private var title: String {
+    if snapshot.state == .signedOut { return "Not signed in" }
+    return filteredOut ? "Nothing to show" : "No \(subject) yet"
+  }
+
+  private var message: String {
+    if snapshot.state == .signedOut {
+      return "Open Termix to connect to your server."
+    }
+    if filteredOut {
+      return "Widget filters hide every \(subject.dropLast()). Change them in Settings → Widgets."
+    }
+    return "Add a \(subject.dropLast()) in Termix, or enable them in Settings → Widgets."
+  }
+
+  var body: some View {
+    VStack(alignment: .leading, spacing: 6) {
+      WidgetHeader(snapshot: snapshot, accent: accent, showsSummary: false)
+      Spacer(minLength: 0)
+      Text(title)
+        .font(Theme.mono(compact ? 12 : 13, weight: .semibold))
+        .foregroundColor(Theme.textPrimary)
+      if !compact {
+        Text(message)
+          .font(Theme.mono(9))
+          .foregroundColor(Theme.textTertiary)
+          .lineLimit(3)
+          .minimumScaleFactor(0.9)
+      }
+      Spacer(minLength: 0)
+      HStack(spacing: 4) {
+        Rectangle().fill(accent).frame(width: 6, height: 1)
+        Text("OPEN TERMIX")
+          .font(Theme.label(8))
+          .tracking(1)
+          .foregroundColor(accent)
+      }
+    }
+    .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .leading)
+    .widgetURL(WidgetSnapshot.fallbackLink)
+  }
+}
+
+/// Snippet tile — tapping runs the command on a host chosen in the app.
+struct SnippetTile: View {
+  let snippet: SnippetEntry
+  let accent: Color
+  var showsPreview: Bool = true
+
+  var body: some View {
+    Link(destination: snippet.link) {
+      VStack(alignment: .leading, spacing: 3) {
+        HStack(spacing: 5) {
+          // A caret keeps the "this is a command" metaphor without an icon set.
+          Text(">")
+            .font(Theme.mono(10, weight: .bold))
+            .foregroundColor(accent)
+          Text(snippet.name)
+            .font(Theme.mono(11, weight: .semibold))
+            .foregroundColor(Theme.textPrimary)
+            .lineLimit(1)
+            .truncationMode(.tail)
+          Spacer(minLength: 0)
+        }
+
+        if showsPreview && !snippet.preview.isEmpty {
+          Text(snippet.preview)
+            .font(Theme.mono(9))
+            .foregroundColor(Theme.textTertiary)
+            .lineLimit(1)
+            .truncationMode(.tail)
+        }
+      }
+      .padding(.horizontal, 7)
+      .padding(.vertical, 6)
+      .frame(maxWidth: .infinity, alignment: .leading)
+      .termixCard()
+    }
+    .accessibilityLabel("\(snippet.name). Runs this snippet on a host you pick.")
+  }
+}
+
+/// Footer line: server label on the left, data freshness on the right.
+struct WidgetFooter: View {
+  let snapshot: WidgetSnapshot
+
+  var body: some View {
+    HStack(spacing: 4) {
+      if !snapshot.server.isEmpty {
+        Text(snapshot.server)
+          .font(Theme.mono(8))
+          .foregroundColor(Theme.textTertiary)
+          .lineLimit(1)
+          .truncationMode(.middle)
+      }
+      Spacer(minLength: 4)
+      Text(relativeAge(from: snapshot.updatedDate))
+        .font(Theme.mono(8))
+        .foregroundColor(Theme.textTertiary)
+    }
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/WidgetModels.swift b/modules/termix-widgets/ios/widget/WidgetModels.swift
new file mode 100644
index 0000000..cee5821
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/WidgetModels.swift
@@ -0,0 +1,193 @@
+import Foundation
+
+/**
+ Decoders for the snapshot the app publishes.
+
+ The shape is defined once in `app/widgets/types.ts`; this file mirrors it.
+ Every field is decoded defensively: a widget must render *something* even if a
+ future app version adds fields or a payload arrives half-written.
+ */
+
+enum HostStatus: String, Codable {
+  case online
+  case offline
+  case unknown
+
+  init(from decoder: Decoder) throws {
+    let raw = try decoder.singleValueContainer().decode(String.self)
+    self = HostStatus(rawValue: raw) ?? .unknown
+  }
+}
+
+enum SnapshotState: String, Codable {
+  case ready
+  case empty
+  case signedOut = "signed-out"
+
+  init(from decoder: Decoder) throws {
+    let raw = try decoder.singleValueContainer().decode(String.self)
+    self = SnapshotState(rawValue: raw) ?? .signedOut
+  }
+}
+
+struct HostEntry: Codable, Identifiable, Hashable {
+  let id: Int
+  let name: String
+  let subtitle: String
+  let folder: String
+  let status: HostStatus
+  let cpu: Int?
+  let mem: Int?
+  let pinned: Bool
+  let url: String
+
+  /// Deep link for this host, or the generic "open the app" link as a fallback.
+  var link: URL {
+    URL(string: url) ?? WidgetSnapshot.fallbackLink
+  }
+
+  /// Spoken description — the visual status dot and bars carry no text.
+  var accessibilityDescription: String {
+    let state: String
+    switch status {
+    case .online: state = "online"
+    case .offline: state = "offline"
+    case .unknown: state = "status unknown"
+    }
+
+    var description = "\(name), \(state)"
+    if status == .online, let cpu {
+      description += ", CPU \(cpu) percent, memory \(mem ?? 0) percent"
+    }
+    return description + ". Opens a terminal session."
+  }
+}
+
+struct SnippetEntry: Codable, Identifiable, Hashable {
+  let id: Int
+  let name: String
+  let folder: String
+  let preview: String
+  let url: String
+
+  var link: URL {
+    URL(string: url) ?? WidgetSnapshot.fallbackLink
+  }
+}
+
+struct HostSummary: Codable, Hashable {
+  let total: Int
+  let online: Int
+  let offline: Int
+  let unknown: Int
+
+  static let zero = HostSummary(total: 0, online: 0, offline: 0, unknown: 0)
+}
+
+struct WidgetSnapshot: Codable, Hashable {
+  /// Payload version understood by this build. Newer payloads are ignored.
+  static let supportedVersion = 1
+  static let fallbackLink = URL(string: "termix-mobile://widget/open")!
+  /// Opens the snippets list without copying anything.
+  static let snippetsLink = URL(string: "termix-mobile://widget/snippets")!
+
+  let version: Int
+  let updatedAt: Double
+  let state: SnapshotState
+  let accent: String
+  let server: String
+  let summary: HostSummary
+  let hosts: [HostEntry]
+  let snippets: [SnippetEntry]
+
+  private enum CodingKeys: String, CodingKey {
+    case version, updatedAt, state, accent, server, summary, hosts, snippets
+  }
+
+  init(
+    version: Int,
+    updatedAt: Double,
+    state: SnapshotState,
+    accent: String,
+    server: String,
+    summary: HostSummary,
+    hosts: [HostEntry],
+    snippets: [SnippetEntry]
+  ) {
+    self.version = version
+    self.updatedAt = updatedAt
+    self.state = state
+    self.accent = accent
+    self.server = server
+    self.summary = summary
+    self.hosts = hosts
+    self.snippets = snippets
+  }
+
+  /// Tolerant decoding: a missing collection is empty rather than fatal, so a
+  /// payload from a slightly different app build still renders.
+  init(from decoder: Decoder) throws {
+    let container = try decoder.container(keyedBy: CodingKeys.self)
+    version = try container.decodeIfPresent(Int.self, forKey: .version) ?? -1
+    updatedAt = try container.decodeIfPresent(Double.self, forKey: .updatedAt) ?? 0
+    state = try container.decodeIfPresent(SnapshotState.self, forKey: .state) ?? .signedOut
+    accent = try container.decodeIfPresent(String.self, forKey: .accent) ?? "#f59145"
+    server = try container.decodeIfPresent(String.self, forKey: .server) ?? ""
+    summary = try container.decodeIfPresent(HostSummary.self, forKey: .summary) ?? .zero
+    hosts = try container.decodeIfPresent([HostEntry].self, forKey: .hosts) ?? []
+    snippets = try container.decodeIfPresent([SnippetEntry].self, forKey: .snippets) ?? []
+  }
+
+  var updatedDate: Date {
+    Date(timeIntervalSince1970: updatedAt / 1000)
+  }
+
+  /// Shown before any snapshot exists and in the widget gallery.
+  static let placeholder = WidgetSnapshot(
+    version: supportedVersion,
+    updatedAt: Date().timeIntervalSince1970 * 1000,
+    state: .ready,
+    accent: "#f59145",
+    server: "termix.local",
+    summary: HostSummary(total: 4, online: 3, offline: 1, unknown: 0),
+    hosts: [
+      HostEntry(id: 1, name: "web-01", subtitle: "root@10.0.0.11", folder: "Production",
+                status: .online, cpu: 34, mem: 61, pinned: true,
+                url: "termix-mobile://widget/connect?hostId=1&type=terminal"),
+      HostEntry(id: 2, name: "db-primary", subtitle: "postgres@10.0.0.12", folder: "Production",
+                status: .online, cpu: 72, mem: 48, pinned: false,
+                url: "termix-mobile://widget/connect?hostId=2&type=terminal"),
+      HostEntry(id: 3, name: "build-runner", subtitle: "ci@10.0.0.21", folder: "CI",
+                status: .online, cpu: 12, mem: 22, pinned: false,
+                url: "termix-mobile://widget/connect?hostId=3&type=terminal"),
+      HostEntry(id: 4, name: "backup-nas", subtitle: "admin@10.0.0.30", folder: "Storage",
+                status: .offline, cpu: nil, mem: nil, pinned: false,
+                url: "termix-mobile://widget/connect?hostId=4&type=terminal"),
+    ],
+    snippets: [
+      SnippetEntry(id: 1, name: "Tail syslog", folder: "Ops",
+                   preview: "tail -f /var/log/syslog",
+                   url: "termix-mobile://widget/snippet?snippetId=1"),
+      SnippetEntry(id: 2, name: "Disk usage", folder: "Ops",
+                   preview: "df -h --total …",
+                   url: "termix-mobile://widget/snippet?snippetId=2"),
+      SnippetEntry(id: 3, name: "Restart nginx", folder: "",
+                   preview: "sudo systemctl restart nginx",
+                   url: "termix-mobile://widget/snippet?snippetId=3"),
+    ]
+  )
+
+  /// State shown when the user hasn't signed in (or turned widgets off).
+  static func signedOut(accent: String = "#f59145") -> WidgetSnapshot {
+    WidgetSnapshot(
+      version: supportedVersion,
+      updatedAt: Date().timeIntervalSince1970 * 1000,
+      state: .signedOut,
+      accent: accent,
+      server: "",
+      summary: .zero,
+      hosts: [],
+      snippets: []
+    )
+  }
+}
diff --git a/modules/termix-widgets/ios/widget/WidgetTheme.swift b/modules/termix-widgets/ios/widget/WidgetTheme.swift
new file mode 100644
index 0000000..a52364d
--- /dev/null
+++ b/modules/termix-widgets/ios/widget/WidgetTheme.swift
@@ -0,0 +1,117 @@
+import SwiftUI
+
+/**
+ Visual language for the widgets.
+
+ Mirrors the app's dark session surfaces (`app/constants/designTokens.ts`):
+ square corners, hairline borders, monospaced type, one accent color. The
+ accent is not hardcoded — it travels in the snapshot so the widget follows the
+ accent the user picked in Settings.
+ */
+enum Theme {
+  // Static surface palette (the terminal chrome is dark in every app theme).
+  static let background = Color(hex: "#0c0d0b")
+  static let surface = Color(hex: "#141513")
+  static let card = Color(hex: "#181917")
+  static let cardRaised = Color(hex: "#1f201d")
+  static let border = Color(hex: "#2a2a2a")
+  static let borderStrong = Color(hex: "#3a3a3a")
+
+  static let textPrimary = Color(hex: "#fafafa")
+  static let textSecondary = Color(hex: "#a4a4a4")
+  static let textTertiary = Color(hex: "#737373")
+
+  static let online = Color(hex: "#4ade80")
+  static let offline = Color(hex: "#ff6467")
+  static let unknown = Color(hex: "#737373")
+
+  static let fallbackAccent = Color(hex: "#f59145")
+
+  static func accent(_ hex: String) -> Color {
+    Color(hex: hex, fallback: fallbackAccent)
+  }
+
+  static func statusColor(_ status: HostStatus) -> Color {
+    switch status {
+    case .online: return online
+    case .offline: return offline
+    case .unknown: return unknown
+    }
+  }
+
+  /// Load colouring: calm below 60%, warm to 80%, hot above.
+  static func loadColor(_ percent: Int, accent: Color) -> Color {
+    switch percent {
+    case ..<60: return accent
+    case 60..<85: return Color(hex: "#f5c542")
+    default: return offline
+    }
+  }
+
+  // MARK: - Typography
+
+  static func mono(_ size: CGFloat, weight: Font.Weight = .regular) -> Font {
+    .system(size: size, weight: weight, design: .monospaced)
+  }
+
+  static func label(_ size: CGFloat = 9) -> Font {
+    .system(size: size, weight: .semibold, design: .monospaced)
+  }
+}
+
+extension Color {
+  /// Parses `#rrggbb` / `#rrggbbaa`, falling back when the string is unusable.
+  init(hex: String, fallback: Color = Color(.sRGB, red: 0.96, green: 0.57, blue: 0.27, opacity: 1)) {
+    var cleaned = hex.trimmingCharacters(in: .whitespacesAndNewlines)
+    if cleaned.hasPrefix("#") { cleaned.removeFirst() }
+
+    guard cleaned.count == 6 || cleaned.count == 8,
+          let value = UInt64(cleaned, radix: 16) else {
+      self = fallback
+      return
+    }
+
+    let hasAlpha = cleaned.count == 8
+    let red = Double((value >> (hasAlpha ? 24 : 16)) & 0xFF) / 255
+    let green = Double((value >> (hasAlpha ? 16 : 8)) & 0xFF) / 255
+    let blue = Double((value >> (hasAlpha ? 8 : 0)) & 0xFF) / 255
+    let alpha = hasAlpha ? Double(value & 0xFF) / 255 : 1
+
+    self = Color(.sRGB, red: red, green: green, blue: blue, opacity: alpha)
+  }
+}
+
+/// Applies the widget container background on iOS 17+, a plain background below.
+struct WidgetBackground: ViewModifier {
+  let color: Color
+
+  func body(content: Content) -> some View {
+    if #available(iOSApplicationExtension 17.0, *) {
+      content.containerBackground(color, for: .widget)
+    } else {
+      content.background(color)
+    }
+  }
+}
+
+extension View {
+  func widgetBackground(_ color: Color = Theme.background) -> some View {
+    modifier(WidgetBackground(color: color))
+  }
+
+  /// Hairline card treatment used by every tile and row.
+  func termixCard(fill: Color = Theme.card, border: Color = Theme.border) -> some View {
+    self
+      .background(fill)
+      .overlay(Rectangle().strokeBorder(border, lineWidth: 1))
+  }
+}
+
+/// Compact "3m" / "2h" freshness label.
+func relativeAge(from date: Date, now: Date = Date()) -> String {
+  let seconds = max(0, now.timeIntervalSince(date))
+  if seconds < 60 { return "now" }
+  if seconds < 3600 { return "\(Int(seconds / 60))m" }
+  if seconds < 86_400 { return "\(Int(seconds / 3600))h" }
+  return "\(Int(seconds / 86_400))d"
+}
diff --git a/package.json b/package.json
index 2958c09..33b4d92 100644
--- a/package.json
+++ b/package.json
@@ -12,6 +12,7 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "verify:android-network-security": "node scripts/verify-android-network-security.cjs",
+    "verify:widget-contract": "node scripts/verify-widget-contract.cjs",
     "build-all": "eas build --platform all --profile development",
     "build-android": "eas build --platform android --profile development",
     "build-ios": "eas build --platform ios --profile development"
diff --git a/plugins/withTermixWidgets.js b/plugins/withTermixWidgets.js
new file mode 100644
index 0000000..c55bc8a
--- /dev/null
+++ b/plugins/withTermixWidgets.js
@@ -0,0 +1,287 @@
+const {
+  withDangerousMod,
+  withEntitlementsPlist,
+  withInfoPlist,
+  withXcodeProject,
+} = require("@expo/config-plugins");
+const fs = require("fs");
+const path = require("path");
+
+/**
+ * withTermixWidgets — wires the home-screen widgets into the native projects.
+ *
+ * Android needs nothing here: the providers, layouts and receiver entries live
+ * in `modules/termix-widgets/android` and reach the app through normal Gradle
+ * library-manifest merging.
+ *
+ * iOS needs a real app-extension target, which this plugin creates on every
+ * prebuild:
+ *
+ *   1. copies the versioned SwiftUI sources into `ios/<target>/`
+ *   2. writes the extension's entitlements (App Group membership)
+ *   3. adds the App Group to the main app and records its id in Info.plist
+ *   4. creates the WidgetKit target, its build phases and build settings, and
+ *      embeds the product in the app
+ *
+ * Options (all optional):
+ *   appGroupIdentifier  defaults to `group.<bundleId>.widgets`
+ *   targetName          defaults to "TermixWidgets"
+ *   deploymentTarget    defaults to "15.1" (matches the app)
+ */
+
+const DEFAULT_TARGET_NAME = "TermixWidgets";
+/**
+ * The extension targets iOS 16 even though the app supports 15.1: WidgetKit's
+ * modern layout APIs (and SwiftUI's `Text.tracking`) require it. An extension
+ * may set a higher minimum than its host app — devices below it simply don't
+ * offer the widgets.
+ */
+const DEFAULT_DEPLOYMENT_TARGET = "16.0";
+const APP_GROUP_INFO_KEY = "TermixWidgetsAppGroup";
+const APP_GROUP_ENTITLEMENT = "com.apple.security.application-groups";
+const APP_GROUP_BUILD_SETTING = "TERMIX_WIDGETS_APP_GROUP";
+
+/** Where the widget sources live in the repo. */
+const WIDGET_SOURCE_DIR = path.join(
+  "modules",
+  "termix-widgets",
+  "ios",
+  "widget",
+);
+
+function resolveOptions(config, props = {}) {
+  const bundleIdentifier = config.ios?.bundleIdentifier;
+  if (!bundleIdentifier) {
+    throw new Error(
+      "[withTermixWidgets] ios.bundleIdentifier must be set in app.json before the widget target can be created.",
+    );
+  }
+
+  return {
+    targetName: props.targetName || DEFAULT_TARGET_NAME,
+    deploymentTarget: props.deploymentTarget || DEFAULT_DEPLOYMENT_TARGET,
+    appGroupIdentifier:
+      props.appGroupIdentifier || `group.${bundleIdentifier}.widgets`,
+    bundleIdentifier,
+    widgetBundleIdentifier: `${bundleIdentifier}.widgets`,
+  };
+}
+
+/** Copies the versioned widget sources into the generated iOS project. */
+const withWidgetSources = (config, options) =>
+  withDangerousMod(config, [
+    "ios",
+    async (config) => {
+      const { platformProjectRoot, projectRoot } = config.modRequest;
+      const sourceDir = path.join(projectRoot, WIDGET_SOURCE_DIR);
+      const targetDir = path.join(platformProjectRoot, options.targetName);
+
+      if (!fs.existsSync(sourceDir)) {
+        throw new Error(
+          `[withTermixWidgets] Widget sources are missing at ${WIDGET_SOURCE_DIR}.`,
+        );
+      }
+
+      fs.mkdirSync(targetDir, { recursive: true });
+
+      for (const file of fs.readdirSync(sourceDir)) {
+        const from = path.join(sourceDir, file);
+        if (!fs.statSync(from).isFile()) continue;
+        fs.copyFileSync(from, path.join(targetDir, file));
+      }
+
+      // The extension's own entitlements: App Group membership is what lets it
+      // read the snapshot the app writes.
+      const entitlements = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">',
+        '<plist version="1.0">',
+        "<dict>",
+        `\t<key>${APP_GROUP_ENTITLEMENT}</key>`,
+        "\t<array>",
+        `\t\t<string>${options.appGroupIdentifier}</string>`,
+        "\t</array>",
+        "</dict>",
+        "</plist>",
+        "",
+      ].join("\n");
+
+      fs.writeFileSync(
+        path.join(targetDir, `${options.targetName}.entitlements`),
+        entitlements,
+        "utf8",
+      );
+
+      return config;
+    },
+  ]);
+
+/** Adds the App Group to the main app so it can write the snapshot. */
+const withAppGroupEntitlement = (config, options) =>
+  withEntitlementsPlist(config, (config) => {
+    const existing = config.modResults[APP_GROUP_ENTITLEMENT];
+    const groups = Array.isArray(existing) ? existing : [];
+    if (!groups.includes(options.appGroupIdentifier)) {
+      groups.push(options.appGroupIdentifier);
+    }
+    config.modResults[APP_GROUP_ENTITLEMENT] = groups;
+    return config;
+  });
+
+/** Records the App Group id so the native module can find the container. */
+const withAppGroupInfoPlist = (config, options) =>
+  withInfoPlist(config, (config) => {
+    config.modResults[APP_GROUP_INFO_KEY] = options.appGroupIdentifier;
+    return config;
+  });
+
+/**
+ * Creates a PBXBuildFile for a file reference that already exists in a group,
+ * so the Sources phase and the navigator share one reference instead of each
+ * creating its own (duplicates confuse Xcode's "duplicate output" checks).
+ */
+function addBuildFileForReference(project, fileRefUuid, basename, phaseName) {
+  const buildFileUuid = project.generateUuid();
+  const section = project.hash.project.objects.PBXBuildFile;
+  section[buildFileUuid] = {
+    isa: "PBXBuildFile",
+    fileRef: fileRefUuid,
+    fileRef_comment: basename,
+  };
+  section[`${buildFileUuid}_comment`] = `${basename} in ${phaseName}`;
+  return { value: buildFileUuid, comment: `${basename} in ${phaseName}` };
+}
+
+/** Applies build settings to every configuration of a target. */
+function applyBuildSettings(project, target, settings) {
+  const configurations = project.pbxXCBuildConfigurationSection();
+  const listUuid = target.pbxNativeTarget.buildConfigurationList;
+  const lists = project.pbxXCConfigurationList();
+  const buildConfigurations = lists[listUuid]?.buildConfigurations ?? [];
+
+  for (const entry of buildConfigurations) {
+    const configuration = configurations[entry.value];
+    if (!configuration || typeof configuration !== "object") continue;
+    configuration.buildSettings = {
+      ...configuration.buildSettings,
+      ...settings,
+    };
+  }
+}
+
+/** Creates the WidgetKit extension target inside the Xcode project. */
+const withWidgetTarget = (config, options) =>
+  withXcodeProject(config, (config) => {
+    const project = config.modResults;
+    const { targetName } = options;
+
+    // Prebuild regenerates the project, but a re-run (or `prebuild` without
+    // `--clean`) must not create the target twice.
+    if (project.pbxTargetByName(targetName)) {
+      return config;
+    }
+
+    const sourceDir = path.join(
+      config.modRequest.projectRoot,
+      WIDGET_SOURCE_DIR,
+    );
+    const swiftFiles = fs
+      .readdirSync(sourceDir)
+      .filter((file) => file.endsWith(".swift"))
+      .sort();
+
+    if (swiftFiles.length === 0) {
+      throw new Error(
+        "[withTermixWidgets] No Swift sources found for the widget target.",
+      );
+    }
+
+    const entitlementsFile = `${targetName}.entitlements`;
+    const groupFiles = [...swiftFiles, "Info.plist", entitlementsFile];
+
+    // Group: makes the sources visible (and resolvable) under ios/<target>/.
+    const group = project.addPbxGroup(groupFiles, targetName, targetName);
+    const mainGroup = project.getFirstProject().firstProject.mainGroup;
+    project.addToPbxGroup(group.uuid, mainGroup);
+
+    // A freshly generated Expo project has no dependency sections; xcode's
+    // addTarget silently skips the app → extension dependency when they are
+    // missing, which would leave the embed phase racing the extension build.
+    const objects = project.hash.project.objects;
+    objects.PBXTargetDependency = objects.PBXTargetDependency ?? {};
+    objects.PBXContainerItemProxy = objects.PBXContainerItemProxy ?? {};
+
+    // Target: also creates the embed phase in the app and the dependency.
+    const target = project.addTarget(
+      targetName,
+      "app_extension",
+      targetName,
+      options.widgetBundleIdentifier,
+    );
+
+    const sourcesPhase = project.addBuildPhase(
+      [],
+      "PBXSourcesBuildPhase",
+      "Sources",
+      target.uuid,
+    );
+    project.addBuildPhase(
+      [],
+      "PBXResourcesBuildPhase",
+      "Resources",
+      target.uuid,
+    );
+    project.addBuildPhase(
+      [],
+      "PBXFrameworksBuildPhase",
+      "Frameworks",
+      target.uuid,
+    );
+
+    // Compile exactly the Swift files, reusing the group's file references.
+    const swiftBasenames = new Set(swiftFiles);
+    for (const child of group.pbxGroup.children) {
+      const basename = String(child.comment ?? "");
+      if (!swiftBasenames.has(basename)) continue;
+      sourcesPhase.buildPhase.files.push(
+        addBuildFileForReference(project, child.value, basename, "Sources"),
+      );
+    }
+
+    applyBuildSettings(project, target, {
+      ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS: "NO",
+      CLANG_ENABLE_MODULES: "YES",
+      CODE_SIGN_ENTITLEMENTS: `"${targetName}/${entitlementsFile}"`,
+      CODE_SIGN_STYLE: "Automatic",
+      CURRENT_PROJECT_VERSION: `"${config.ios?.buildNumber ?? "1"}"`,
+      GENERATE_INFOPLIST_FILE: "NO",
+      INFOPLIST_FILE: `"${targetName}/Info.plist"`,
+      IPHONEOS_DEPLOYMENT_TARGET: `"${options.deploymentTarget}"`,
+      LD_RUNPATH_SEARCH_PATHS: `"$(inherited) @executable_path/Frameworks @executable_path/../../Frameworks"`,
+      MARKETING_VERSION: `"${config.version ?? "1.0.0"}"`,
+      PRODUCT_BUNDLE_IDENTIFIER: `"${options.widgetBundleIdentifier}"`,
+      PRODUCT_NAME: `"$(TARGET_NAME)"`,
+      SKIP_INSTALL: "YES",
+      SWIFT_EMIT_LOC_STRINGS: "YES",
+      SWIFT_VERSION: "5.0",
+      TARGETED_DEVICE_FAMILY: `"1,2"`,
+      // Consumed by the extension's Info.plist so the App Group id is defined
+      // in exactly one place.
+      [APP_GROUP_BUILD_SETTING]: `"${options.appGroupIdentifier}"`,
+    });
+
+    return config;
+  });
+
+const withTermixWidgets = (config, props = {}) => {
+  const options = resolveOptions(config, props);
+
+  config = withAppGroupEntitlement(config, options);
+  config = withAppGroupInfoPlist(config, options);
+  config = withWidgetSources(config, options);
+  config = withWidgetTarget(config, options);
+
+  return config;
+};
+
+module.exports = withTermixWidgets;
diff --git a/scripts/verify-widget-contract.cjs b/scripts/verify-widget-contract.cjs
new file mode 100644
index 0000000..29e57dd
--- /dev/null
+++ b/scripts/verify-widget-contract.cjs
@@ -0,0 +1,187 @@
+/* eslint-env node */
+/* global __dirname */
+
+/**
+ * Guards the home-screen widget payload contract.
+ *
+ * The snapshot the app publishes is decoded by three independent
+ * implementations — TypeScript, Swift and Kotlin. Nothing in the compiler
+ * chain catches a field renamed on one side only; the widget would just quietly
+ * render blanks on one platform. This script fails loudly instead.
+ *
+ * Run with `npm run verify:widget-contract`.
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const projectRoot = path.resolve(__dirname, "..");
+const widgetModule = path.join(projectRoot, "modules", "termix-widgets");
+
+function read(...segments) {
+  return fs.readFileSync(path.join(...segments), "utf8");
+}
+
+function assert(condition, message) {
+  if (!condition) {
+    throw new Error(message);
+  }
+}
+
+const typescript = read(projectRoot, "app", "widgets", "types.ts");
+const swift = read(widgetModule, "ios", "widget", "WidgetModels.swift");
+const kotlin = read(
+  widgetModule,
+  "android",
+  "src",
+  "main",
+  "java",
+  "expo",
+  "modules",
+  "termixwidgets",
+  "WidgetSnapshot.kt",
+);
+
+// --- Payload version must be identical on all three sides.
+
+function single(source, pattern, description) {
+  const match = source.match(pattern);
+  assert(match, `Could not find ${description}`);
+  return match[1];
+}
+
+const versions = {
+  TypeScript: single(
+    typescript,
+    /SNAPSHOT_VERSION\s*=\s*(\d+)/,
+    "SNAPSHOT_VERSION in app/widgets/types.ts",
+  ),
+  Swift: single(
+    swift,
+    /supportedVersion\s*=\s*(\d+)/,
+    "supportedVersion in WidgetModels.swift",
+  ),
+  Kotlin: single(
+    kotlin,
+    /SUPPORTED_VERSION\s*=\s*(\d+)/,
+    "SUPPORTED_VERSION in WidgetSnapshot.kt",
+  ),
+};
+
+const distinctVersions = new Set(Object.values(versions));
+assert(
+  distinctVersions.size === 1,
+  `Snapshot version disagrees across decoders: ${JSON.stringify(versions)}. ` +
+    "Bump it in all three when the payload shape changes.",
+);
+
+// --- Every field must exist on all three sides, spelled the same way.
+
+/** Fields of a TypeScript interface, ignoring comments and optional markers. */
+function tsFields(name) {
+  const body = single(
+    typescript,
+    new RegExp(`export interface ${name} \\{([\\s\\S]*?)\\n\\}`),
+    `interface ${name} in types.ts`,
+  );
+  return body
+    .split("\n")
+    .map((line) => line.trim())
+    .filter((line) => /^\w+\??:/.test(line))
+    .map((line) => line.split(/\??:/)[0])
+    .sort();
+}
+
+function swiftFields(name) {
+  const body = single(
+    swift,
+    new RegExp(`struct ${name}[^{]*\\{([\\s\\S]*?)\\n\\}`),
+    `struct ${name} in WidgetModels.swift`,
+  );
+  return [...body.matchAll(/^ {2}let (\w+):/gm)].map((m) => m[1]).sort();
+}
+
+function kotlinFields(name) {
+  const body = single(
+    kotlin,
+    new RegExp(`data class ${name}\\(([\\s\\S]*?)\\n\\)`),
+    `data class ${name} in WidgetSnapshot.kt`,
+  );
+  return [...body.matchAll(/val (\w+):/g)].map((m) => m[1]).sort();
+}
+
+const shapes = [
+  { ts: "WidgetSnapshot", native: "WidgetSnapshot" },
+  { ts: "WidgetSummary", native: "HostSummary" },
+  { ts: "WidgetHostEntry", native: "HostEntry" },
+  { ts: "WidgetSnippetEntry", native: "SnippetEntry" },
+];
+
+for (const shape of shapes) {
+  const expected = tsFields(shape.ts);
+  const fromSwift = swiftFields(shape.native);
+  const fromKotlin = kotlinFields(shape.native);
+
+  assert(
+    expected.join(",") === fromSwift.join(","),
+    `${shape.ts} differs between TypeScript and Swift:\n` +
+      `  ts:    ${expected.join(", ")}\n  swift: ${fromSwift.join(", ")}`,
+  );
+  assert(
+    expected.join(",") === fromKotlin.join(","),
+    `${shape.ts} differs between TypeScript and Kotlin:\n` +
+      `  ts:     ${expected.join(", ")}\n  kotlin: ${fromKotlin.join(", ")}`,
+  );
+
+  // Kotlin parses by string key, so a matching property name is not enough.
+  for (const field of expected) {
+    assert(
+      kotlin.includes(`"${field}"`) || field === "url",
+      `WidgetSnapshot.kt never reads the "${field}" key when parsing ${shape.native}`,
+    );
+  }
+}
+
+// --- The shared storage key must match on both native sides.
+
+const storageKey = "termix.widget.snapshot.v1";
+const iosModule = read(widgetModule, "ios", "TermixWidgetsModule.swift");
+const iosStore = read(widgetModule, "ios", "widget", "SharedStore.swift");
+const androidStore = read(
+  widgetModule,
+  "android",
+  "src",
+  "main",
+  "java",
+  "expo",
+  "modules",
+  "termixwidgets",
+  "SnapshotStore.kt",
+);
+
+for (const [name, source] of [
+  ["TermixWidgetsModule.swift", iosModule],
+  ["SharedStore.swift", iosStore],
+  ["SnapshotStore.kt", androidStore],
+]) {
+  assert(
+    source.includes(storageKey),
+    `${name} must read/write the shared snapshot key "${storageKey}"`,
+  );
+}
+
+// --- The iOS widget target only builds if the plugin is registered.
+
+const appJson = require(path.join(projectRoot, "app.json"));
+assert(
+  (appJson.expo?.plugins ?? []).some((plugin) =>
+    (Array.isArray(plugin) ? plugin[0] : plugin).includes(
+      "withTermixWidgets.js",
+    ),
+  ),
+  "app.json must include ./plugins/withTermixWidgets.js",
+);
+
+console.log(
+  `Widget snapshot contract v${versions.TypeScript} matches across TypeScript, Swift and Kotlin.`,
+);