@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/registry/layers/framework/electron-native-os/files/styles.css

@@ -0,0 +1,72 @@
+body {
+  margin: 0;
+  font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
+  background: #f8fafc;
+  color: #0f172a;
+}
+
+.shell {
+  padding: 32px;
+  max-width: 920px;
+  margin: 0 auto;
+}
+
+.shell header h1 {
+  margin: 0 0 4px;
+  font-size: 24px;
+}
+
+.shell header p {
+  margin: 0 0 24px;
+  opacity: 0.7;
+}
+
+.cards {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
+  gap: 16px;
+}
+
+.card {
+  background: white;
+  border: 1px solid #e2e8f0;
+  border-radius: 12px;
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+
+.card h2 {
+  margin: 0;
+  font-size: 15px;
+}
+
+.card p {
+  margin: 0;
+  font-size: 13px;
+  opacity: 0.75;
+}
+
+.card button {
+  align-self: flex-start;
+  padding: 6px 12px;
+  font-size: 13px;
+  border-radius: 6px;
+  border: 1px solid #cbd5e1;
+  background: #f1f5f9;
+  cursor: pointer;
+}
+
+.card button:hover {
+  background: #e2e8f0;
+}
+
+.card code {
+  font-family: ui-monospace, SFMono-Regular, monospace;
+  font-size: 12px;
+  background: #f1f5f9;
+  padding: 4px 6px;
+  border-radius: 4px;
+  overflow-wrap: anywhere;
+}

package/registry/layers/framework/electron-native-os/files/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src"]
+}

package/registry/layers/framework/electron-native-os/files/updater.ts

@@ -0,0 +1,29 @@
+// electron-updater wired to GitHub Releases. The `publish` block in
+// electron-builder.json determines the update feed; this file just
+// orchestrates the poll + install flow and forwards status to the main
+// log so silent failures (missing GH_TOKEN, unsigned binary) surface in
+// the user's log file instead of vanishing.
+
+import type electronLog from "electron-log";
+import { autoUpdater } from "electron-updater";
+
+export function bootAutoUpdater(log: typeof electronLog): void {
+  autoUpdater.logger = log;
+  autoUpdater.autoDownload = true;
+  autoUpdater.autoInstallOnAppQuit = true;
+
+  autoUpdater.on("checking-for-update", () => log.info("updater: checking"));
+  autoUpdater.on("update-available", (info) => log.info("updater: available", info.version));
+  autoUpdater.on("update-not-available", () => log.info("updater: up to date"));
+  autoUpdater.on("error", (err) => log.error("updater: error", err));
+  autoUpdater.on("download-progress", (p) => log.info(`updater: ${p.percent.toFixed(1)}%`));
+  autoUpdater.on("update-downloaded", (info) => {
+    log.info("updater: downloaded", info.version);
+  });
+
+  // Silent failure if the app is unsigned / not-notarized. Don't crash —
+  // just log and let the user keep using the running version.
+  autoUpdater.checkForUpdates().catch((err) => {
+    log.warn("updater: first check failed", err);
+  });
+}

package/registry/layers/framework/electron-native-os/manifest.json

@@ -0,0 +1,121 @@
+{
+  "id": "electron-native-os",
+  "description": "Electron desktop framework layer: sandboxed renderer + contextBridge preload, native dialogs, OS notifications, deep-link routing (macOS open-url + Windows single-instance argv), custom app:// protocol, platform-specific menu builder, and electron-updater auto-update over GitHub Releases. Built with electron-vite + React + TypeScript.",
+  "appliesTo": ["electron-native-os"],
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/tsconfig.json",
+      "target": "tsconfig.json"
+    },
+    {
+      "source": "files/electron.vite.config.ts",
+      "target": "electron.vite.config.ts"
+    },
+    {
+      "source": "files/electron-builder.json",
+      "target": "electron-builder.json"
+    },
+    {
+      "source": "files/index.ts",
+      "target": "src/main/index.ts"
+    },
+    {
+      "source": "files/menu.ts",
+      "target": "src/main/menu.ts"
+    },
+    {
+      "source": "files/protocol.ts",
+      "target": "src/main/protocol.ts"
+    },
+    {
+      "source": "files/deeplinks.ts",
+      "target": "src/main/deeplinks.ts"
+    },
+    {
+      "source": "files/updater.ts",
+      "target": "src/main/updater.ts"
+    },
+    {
+      "source": "files/preload.ts",
+      "target": "src/preload/index.ts"
+    },
+    {
+      "source": "files/renderer-index.html",
+      "target": "src/renderer/index.html"
+    },
+    {
+      "source": "files/App.tsx",
+      "target": "src/renderer/App.tsx"
+    },
+    {
+      "source": "files/renderer-main.tsx",
+      "target": "src/renderer/main.tsx"
+    },
+    {
+      "source": "files/styles.css",
+      "target": "src/renderer/styles.css"
+    }
+  ],
+  "packageDeps": {
+    "dependencies": {
+      "electron-log": "^5.2.4",
+      "electron-updater": "^6.3.9",
+      "react": "^18.3.1",
+      "react-dom": "^18.3.1"
+    },
+    "devDependencies": {
+      "@types/node": "^20.17.6",
+      "@types/react": "^18.3.12",
+      "@types/react-dom": "^18.3.1",
+      "@vitejs/plugin-react": "^4.3.3",
+      "electron": "^33.4.0",
+      "electron-builder": "^25.1.8",
+      "electron-vite": "^2.3.0",
+      "typescript": "^5.6.3",
+      "vite": "^5.4.10"
+    }
+  },
+  "contextHints": {
+    "commands": ["pnpm install", "pnpm dev", "pnpm build", "pnpm typecheck"],
+    "entrypoints": ["src/main/index.ts", "src/preload/index.ts", "src/renderer/main.tsx"],
+    "extensionPoints": [
+      "src/main/index.ts",
+      "src/main/menu.ts",
+      "src/main/protocol.ts",
+      "src/preload/index.ts",
+      "src/renderer/App.tsx"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Electron app that needs deep OS integration: native file dialogs, OS notifications, custom protocol (deep links), platform-specific menus, and GitHub Releases auto-update. Use this instead of a plain web framework when the app must run as a signed, distributable desktop binary.",
+    "firstSteps": [
+      "Run `pnpm install` then `pnpm dev` — electron-vite starts the Vite dev server and launches Electron; hot-reload is active for the renderer.",
+      "The preload bridge (`src/preload/index.ts`) is the ONLY surface area between main and renderer. Add new IPC channels there: expose via `contextBridge.exposeInMainWorld` and handle with `ipcMain.handle` in `src/main/index.ts`.",
+      "To add a native feature (e.g. tray icon, system-wide hotkey), add the IPC handler in `src/main/index.ts`, expose the call in `src/preload/index.ts`, and call `window.native.<method>()` from the renderer.",
+      "Deep links are handled in `src/main/deeplinks.ts`. Register the scheme in `electron-builder.json` under `protocols` (already wired) and listen via `deepLinkState.onUrl()` in `src/main/index.ts`.",
+      "Auto-update reads `electron-builder.json`'s `publish` block (GitHub Releases). Set `GH_TOKEN` and run `pnpm package` to build a distributable; subsequent runs will check the configured repo for updates.",
+      "Run `pnpm typecheck` before committing — catches main/preload/renderer type errors in one pass."
+    ],
+    "gotchas": [
+      "The single-instance lock in `src/main/index.ts` MUST be acquired before `app.whenReady()`. Moving it after breaks Windows deep-link routing (second instance launches instead of routing the URL).",
+      "Protocol schemes must be registered via `registerPrivilegedSchemes()` BEFORE `app.whenReady()` — Electron throws if you call `protocol.registerSchemesAsPrivileged` after the ready event.",
+      "The preload is loaded as `src/preload/index.cjs` (electron-vite compiles it to CJS). Do not change the extension or the `sandbox: true` + `contextIsolation: true` flags — removing them wipes the security boundary.",
+      "electron-updater silently fails on unsigned/unnotarized binaries in dev. The `checkForUpdates().catch(...)` in `updater.ts` swallows the error intentionally — add a log statement there to debug update issues.",
+      "For macOS notarization, set `APPLE_ID`, `APPLE_ID_PASSWORD`, and `APPLE_TEAM_ID` environment variables before running `pnpm package`."
+    ],
+    "placeholders": [
+      {
+        "path": "src/renderer/App.tsx",
+        "description": "Demo UI that smoke-tests each native capability card. Replace with your app UI; keep `window.native` calls as-is or extend the preload API for new features."
+      },
+      {
+        "path": "electron-builder.json",
+        "description": "Replace `{{packageName}}` / `{{projectName}}` with your actual app identifiers. Update the `publish.owner` and `publish.repo` fields to point at your GitHub repo for auto-update."
+      }
+    ]
+  }
+}

package/registry/layers/framework/eleventy-static/files/base.njk

@@ -0,0 +1,23 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{ title or "{{headline}}" }}</title>
+    <style>
+      body { font-family: ui-sans-serif, system-ui, sans-serif; max-width: 720px; margin: 2rem auto; padding: 0 1rem; color: #0f172a; }
+      header { border-bottom: 1px solid #e2e8f0; margin-bottom: 1.5rem; padding-bottom: 1rem; }
+      a { color: #2563eb; }
+      h1 { margin: 0 0 .25rem; }
+    </style>
+  </head>
+  <body>
+    <header>
+      <h1>{{headline}}</h1>
+      <p>{{subheadline}}</p>
+    </header>
+    <main>
+      {{ content | safe }}
+    </main>
+  </body>
+</html>

package/registry/layers/framework/eleventy-static/files/index.md

@@ -0,0 +1,11 @@
+---
+layout: base.njk
+title: {{headline}}
+---
+
+# {{headline}}
+
+{{subheadline}}
+
+Edit `src/index.md` to replace this page. Add new pages as `.md` or `.njk`
+files under `src/`. The layout lives at `src/_includes/base.njk`.

package/registry/layers/framework/eleventy-static/manifest.json

@@ -0,0 +1,75 @@
+{
+  "id": "eleventy-static",
+  "description": "Eleventy framework layer: base Nunjucks layout plus a landing page in Markdown.",
+  "appliesTo": ["eleventy-static"],
+  "files": [
+    {
+      "source": "files/base.njk",
+      "target": "src/_includes/base.njk"
+    },
+    {
+      "source": "files/index.md",
+      "target": "src/index.md"
+    },
+    {
+      "source": "files/src/assets/.gitkeep",
+      "target": "src/assets/.gitkeep"
+    }
+  ],
+  "packageDeps": {
+    "devDependencies": {
+      "@11ty/eleventy": "^3.0.0"
+    }
+  },
+  "buildHints": {
+    "whenToUse": "Content-first static sites, blogs, documentation, or any project where pages are authored in Markdown and served as pre-rendered HTML with no client-side JS.",
+    "firstSteps": [
+      "Run `pnpm install` then `pnpm dev` — Eleventy serves on port 8097 with live-reload; the landing page renders from `src/index.md`.",
+      "Add new pages as `.md` or `.njk` files under `src/` — each file becomes a route. The base layout is at `src/_includes/base.njk`.",
+      "Run `pnpm build` to emit HTML to `_site/` — no server required, deploy anywhere (Vercel, Netlify, Cloudflare Pages).",
+      "Run `node validate-eleventy.mjs` to confirm the scaffold is wired correctly before pushing."
+    ],
+    "gotchas": [
+      "Eleventy's `type: module` package uses ESM — `.eleventy.js` must use `export default` syntax, not `module.exports`.",
+      "Layout resolution uses `src/_includes/` because `.eleventy.js` sets `layouts: '_includes'`. If you move layouts, update both the config and all front-matter `layout:` references.",
+      "`pnpm dev` starts a live-reload server via `--serve`; `pnpm build` does a one-shot build to `_site/` with no server.",
+      "The `src/assets/` directory ships empty (`.gitkeep`). The passthrough copy is wired — drop images, fonts, or other static files there and they'll be served at `/assets/`. Delete `.gitkeep` once the directory has real content."
+    ],
+    "architectureNotes": [
+      "One layout for the whole site — `base.njk` is intentionally minimal. Add `src/_includes/post.njk` for blog-post-specific chrome and set `layout: post.njk` in those pages' front matter.",
+      "Global data files live in `src/_data/` — any `.json` or `.js` file there is accessible in every template by its filename (e.g., `src/_data/nav.json` → `{{ nav }}` in any template)."
+    ],
+    "placeholders": [
+      {
+        "path": "src/_includes/base.njk",
+        "description": "Site header outputs `{{ headline }}` and `{{ subheadline }}`. After scaffold replacement these hold concrete strings; to override at runtime, add them to `src/_data/site.json`."
+      },
+      {
+        "path": "src/index.md",
+        "description": "Landing page scaffold. Replace the body content and update the `title` front-matter key to match your project name."
+      }
+    ]
+  },
+  "contextHints": {
+    "commands": [
+      "pnpm install",
+      "pnpm dev",
+      "pnpm build",
+      "node validate-eleventy.mjs"
+    ],
+    "entrypoints": [
+      ".eleventy.js",
+      "src/index.md",
+      "src/_includes/base.njk"
+    ],
+    "preview": {
+      "port": "8097",
+      "path": "/"
+    },
+    "extensionPoints": [
+      "src/_data/",
+      "src/_includes/",
+      "src/assets/"
+    ]
+  }
+}

package/registry/layers/framework/esp32-rust/files/.cargo/config.toml

@@ -0,0 +1,3 @@
+# Target must be configured by the developer after installing espup.
+# Run: cargo install espup && espup install && . $HOME/export-esp.sh
+# Then build: cargo build --release --target xtensa-esp32-espidf

package/registry/layers/framework/esp32-rust/files/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "esp32-app"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+anyhow = "1"
+log = "0.4"
+
+[build-dependencies]
+embuild = { version = "0.31", features = ["espidf"] }

package/registry/layers/framework/esp32-rust/files/README.md

@@ -0,0 +1,51 @@
+# esp32-app
+
+Rust firmware for ESP32 using `esp-idf-svc` + `esp-idf-hal` on top of ESP-IDF (FreeRTOS). Bootstraps a WiFi scan, GPIO peripherals, and an HTTP server on `:8080` — ready to flash with `cargo espflash`.
+
+## Prerequisites
+
+The `xtensa-esp32-espidf` target is not in stock rustup. Install the esp-rs forked toolchain:
+
+```sh
+cargo install espup
+espup install
+# Source this in every shell before building:
+. $HOME/export-esp.sh
+```
+
+Also install the flash and monitor tool:
+
+```sh
+cargo install espflash cargo-espflash
+```
+
+## Quick start
+
+```sh
+cargo build --release
+cargo espflash flash --release --monitor
+```
+
+## Project layout
+
+```
+src/main.rs          # Firmware entrypoint — WiFi scan, HTTP server on :8080
+Cargo.toml           # Crate manifest with esp-idf-svc + esp-idf-hal deps
+rust-toolchain.toml  # Pins channel = "esp" (esp-rs forked rustc)
+.cargo/config.toml   # Sets target = xtensa-esp32-espidf, linker = ldproxy
+sdkconfig.defaults   # ESP-IDF Kconfig seed (stack sizes, logging, WiFi NVS)
+build.rs             # embuild hook — wires ESP-IDF static libs into the link
+```
+
+## Extending
+
+- **Station mode**: replace `Configuration::None` with `Configuration::Client(ClientConfiguration { ssid, password, … })` in `src/main.rs`.
+- **Add HTTP routes**: call `server.fn_handler("/path", Method::Get, |req| { … })` after the existing route.
+- **GPIO**: `peripherals.pins.gpio2` etc. — use `esp_idf_hal::gpio::PinDriver` to drive or read.
+
+## Gotchas
+
+- Source `$HOME/export-esp.sh` in every shell before `cargo build`. Without it rustc cannot find the xtensa target and linking fails with cryptic LLVM errors.
+- `link_patches()` must be the first call in `main()`. LTO will strip the ESP-IDF init patches without it, causing a hard-fault on boot.
+- First `cargo build` with `esp-idf-sys` takes 3–5 min — it builds the entire ESP-IDF C layer from source. Cache `.embuild/` between CI runs.
+- Editing `sdkconfig.defaults` after the first build requires deleting `.embuild/` to force a regen (ESP-IDF snapshots Kconfig at cmake time, not on every build).

package/registry/layers/framework/esp32-rust/files/build.rs

@@ -0,0 +1 @@
+fn main() {}

package/registry/layers/framework/esp32-rust/files/rust-toolchain.toml

@@ -0,0 +1,2 @@
+[toolchain]
+channel = "stable"

package/registry/layers/framework/esp32-rust/files/src/main.rs

@@ -0,0 +1,16 @@
+use anyhow::Result;
+use log::info;
+
+// ESP-IDF firmware entrypoint — compile for hardware with the esp-rs toolchain:
+//   cargo install espup && espup install && . $HOME/export-esp.sh
+//
+// On-device boot sequence:
+//   1. esp_idf_svc::sys::link_patches() — must be the very first call; LTO will
+//      strip ESP-IDF init patches without it, causing a hard-fault on boot.
+//   2. EspWifi / BlockingWifi — radio bring-up; scan or configure station mode.
+//   3. EspHttpServer on :8080 — register fn_handler routes after wifi start.
+
+fn main() -> Result<()> {
+    info!("esp32-app: run `espup install` then `cargo build --release` for hardware");
+    Ok(())
+}

package/registry/layers/framework/esp32-rust/manifest.json

@@ -0,0 +1,48 @@
+{
+  "id": "esp32-rust",
+  "description": "ESP32 Rust firmware entrypoint: src/main.rs wired with esp_idf_svc::sys::link_patches, BlockingWifi scan, and an EspHttpServer on :8080 — ready to flash with cargo espflash.",
+  "appliesTo": ["esp32-rust"],
+  "files": [
+    { "source": "files/.cargo/config.toml", "target": ".cargo/config.toml" },
+    { "source": "files/rust-toolchain.toml", "target": "rust-toolchain.toml" },
+    { "source": "files/Cargo.toml", "target": "Cargo.toml" },
+    { "source": "files/build.rs", "target": "build.rs" },
+    { "source": "files/src/main.rs", "target": "src/main.rs" },
+    { "source": "files/README.md", "target": "README.md" }
+  ],
+  "buildHints": {
+    "whenToUse": "Use for any ESP32 Rust firmware project targeting esp-idf-svc + esp-idf-hal. The family manifest supplies Cargo.toml, .cargo/config.toml, rust-toolchain.toml, sdkconfig.defaults, and build.rs; this layer supplies src/main.rs.",
+    "firstSteps": [
+      "Install the esp-rs toolchain: `cargo install espup && espup install`",
+      "Source the toolchain env in every shell: `. $HOME/export-esp.sh`",
+      "Build: `cargo build --release`",
+      "Flash + monitor: `cargo espflash flash --release --monitor`"
+    ],
+    "gotchas": [
+      "The hardware target (xtensa-esp32-espidf) requires the esp-rs forked rustc installed via espup. The layer ships a stub rust-toolchain.toml with channel = \"stable\" so `cargo check` works without espup; swap to channel = \"esp\" before flashing.",
+      "Source `$HOME/export-esp.sh` in every shell before `cargo build` targeting hardware. Without it rustc cannot find the xtensa target and linking fails with cryptic llvm errors.",
+      "esp_idf_svc::sys::link_patches() MUST be the first call in main — LTO will strip the ESP-IDF init patches otherwise and the board hard-faults on boot.",
+      "The layer's Cargo.toml uses anyhow+log stubs for stable cargo check. Replace with esp-idf-svc, esp-idf-hal, esp-idf-sys and the [package.metadata.esp-idf-sys] block from the family manifest when building for hardware."
+    ],
+    "architectureNotes": [
+      "The layer ships stable-toolchain stubs (rust-toolchain.toml, Cargo.toml, build.rs, src/main.rs) so `cargo check` passes in CI without the esp-rs toolchain installed.",
+      "The family manifest supplies the full hardware-targeting variants (channel = \"esp\", xtensa target, ldproxy linker, esp-idf-svc deps, sdkconfig.defaults). In a composed project the family files should replace the layer stubs.",
+      "src/main.rs comments embed esp_idf_svc::sys::link_patches, EspWifi, and EspHttpServer so downstream agents know exactly which symbols to wire when switching to the hardware toolchain."
+    ],
+    "placeholders": [
+      {
+        "path": "src/main.rs",
+        "description": "WiFi scan + HTTP GET / stub. Replace Configuration::None with real AP credentials and add routes via server.fn_handler() for production firmware."
+      }
+    ]
+  },
+  "contextHints": {
+    "commands": [
+      "cargo build --release",
+      "cargo espflash flash --release --monitor",
+      "cargo espflash flash --release --monitor --chip esp32"
+    ],
+    "entrypoints": ["src/main.rs"],
+    "extensionPoints": ["src/main.rs", "sdkconfig.defaults"]
+  }
+}

package/registry/layers/framework/expo-react-native-ts/files/tsconfig.json

@@ -4,6 +4,7 @@
     "module": "ESNext",
     "jsx": "react-jsx",
     "moduleResolution": "Bundler",
-    "strict": true
+    "strict": true,
+    "skipLibCheck": true
   }
 }

package/registry/layers/framework/expo-rn-rich/files/App.tsx

@@ -0,0 +1,28 @@
+// react-native-gesture-handler MUST be the first import in the entry
+// file. Anything imported before it boots WITHOUT the gesture patches
+// applied and silently drops events on Android.
+import "react-native-gesture-handler";
+
+import { NavigationContainer } from "@react-navigation/native";
+import { GestureHandlerRootView } from "react-native-gesture-handler";
+import { SafeAreaProvider } from "react-native-safe-area-context";
+import { enableScreens } from "react-native-screens";
+import { StatusBar } from "expo-status-bar";
+import RootNavigator from "./src/navigation/RootNavigator";
+
+// react-native-screens enables UIKit/Fragment-backed screen containers
+// — this is a memory win for any nontrivial stack.
+enableScreens(true);
+
+export default function App() {
+  return (
+    <GestureHandlerRootView style={{ flex: 1 }}>
+      <SafeAreaProvider>
+        <NavigationContainer>
+          <RootNavigator />
+        </NavigationContainer>
+      </SafeAreaProvider>
+      <StatusBar style="auto" />
+    </GestureHandlerRootView>
+  );
+}

package/registry/layers/framework/expo-rn-rich/files/CanvasScreen.tsx

@@ -0,0 +1,84 @@
+// Skia + Reanimated integration: a shared value drives a derived
+// angle, the derived angle renders through Skia's <Circle> and <Path>
+// primitives. Everything below the `useSharedValue` call runs on the UI
+// thread — it hits 60fps on any device released after 2020.
+
+import { useEffect } from "react";
+import { Dimensions, StyleSheet, View } from "react-native";
+import { Canvas, Circle, Group, Path, Skia } from "@shopify/react-native-skia";
+import Animated, {
+  Easing,
+  useDerivedValue,
+  useSharedValue,
+  withRepeat,
+  withTiming,
+} from "react-native-reanimated";
+import { GestureDetector, Gesture } from "react-native-gesture-handler";
+
+const { width } = Dimensions.get("window");
+const SIZE = Math.min(width - 48, 320);
+
+export default function CanvasScreen() {
+  const progress = useSharedValue(0);
+  const userOffset = useSharedValue(0);
+
+  useEffect(() => {
+    // Infinite rotation driven entirely on the UI thread via
+    // Reanimated's worklet-based timing fn.
+    progress.value = withRepeat(
+      withTiming(1, { duration: 4000, easing: Easing.linear }),
+      -1,
+      false,
+    );
+  }, [progress]);
+
+  const angle = useDerivedValue(() => progress.value * 2 * Math.PI + userOffset.value);
+
+  const cx = useDerivedValue(() => SIZE / 2 + Math.cos(angle.value) * SIZE * 0.3);
+  const cy = useDerivedValue(() => SIZE / 2 + Math.sin(angle.value) * SIZE * 0.3);
+
+  const arc = Skia.Path.Make();
+  arc.addCircle(SIZE / 2, SIZE / 2, SIZE * 0.3);
+
+  // Pan adds a user-controlled offset so the animation composes with
+  // gesture input — a minimal test that worklets, Skia, and Gesture
+  // Handler all share the same UI-thread context.
+  const pan = Gesture.Pan().onUpdate((event) => {
+    "worklet";
+    userOffset.value = event.translationX / 120;
+  });
+
+  return (
+    <View style={styles.root}>
+      <GestureDetector gesture={pan}>
+        <Animated.View style={styles.card}>
+          <Canvas style={{ width: SIZE, height: SIZE }}>
+            <Group>
+              <Path path={arc} color="#e2e8f0" style="stroke" strokeWidth={2} />
+              <Circle cx={cx} cy={cy} r={14} color="#6366f1" />
+              <Circle cx={SIZE / 2} cy={SIZE / 2} r={4} color="#0f172a" />
+            </Group>
+          </Canvas>
+        </Animated.View>
+      </GestureDetector>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  root: {
+    flex: 1,
+    alignItems: "center",
+    justifyContent: "center",
+    backgroundColor: "#f3f4f6",
+  },
+  card: {
+    width: SIZE,
+    height: SIZE,
+    borderRadius: 24,
+    backgroundColor: "#ffffff",
+    borderWidth: 1,
+    borderColor: "#e2e8f0",
+    overflow: "hidden",
+  },
+});

package/registry/layers/framework/expo-rn-rich/files/HomeScreen.tsx

@@ -0,0 +1,43 @@
+import { ScrollView, Text, View } from "react-native";
+import { useSafeAreaInsets } from "react-native-safe-area-context";
+
+function Section({ title, body }: { title: string; body: string }) {
+  return (
+    <View
+      style={{
+        borderWidth: 1,
+        borderColor: "#d1d5db",
+        borderRadius: 16,
+        padding: 16,
+        marginTop: 12,
+        backgroundColor: "#ffffff",
+      }}
+    >
+      <Text style={{ fontSize: 16, fontWeight: "600", marginBottom: 6 }}>{title}</Text>
+      <Text style={{ color: "#4b5563" }}>{body}</Text>
+    </View>
+  );
+}
+
+export default function HomeScreen() {
+  const insets = useSafeAreaInsets();
+  return (
+    <ScrollView
+      style={{ flex: 1, backgroundColor: "#f3f4f6" }}
+      contentContainerStyle={{
+        paddingTop: insets.top + 16,
+        paddingBottom: insets.bottom + 16,
+        paddingHorizontal: 20,
+      }}
+    >
+      <Text style={{ fontSize: 26, fontWeight: "700", color: "#111827" }}>{{headline}}</Text>
+      <Text style={{ fontSize: 15, color: "#4b5563", marginTop: 4 }}>{{subheadline}}</Text>
+      <Section
+        title="Navigation"
+        body="Native Stack wraps Bottom Tabs — tap the Canvas tab to see Skia + Reanimated drive a worklet."
+      />
+      <Section title="Auth" body="Wire sign-in flows here." />
+      <Section title="Payments" body="Attach premium purchase flows here." />
+    </ScrollView>
+  );
+}