@tangle-network/starter-foundry 0.5.4 → 0.7.0

package/registry/families/eleventy-static/files/.eleventy.js

@@ -0,0 +1,16 @@
+export default function (eleventyConfig) {
+  eleventyConfig.addPassthroughCopy({ 'src/assets': 'assets' })
+  eleventyConfig.setServerOptions({ port: Number(process.env.PORT) || 8097 })
+
+  return {
+    dir: {
+      input: 'src',
+      includes: '_includes',
+      layouts: '_includes',
+      output: '_site',
+    },
+    templateFormats: ['md', 'njk', 'html'],
+    markdownTemplateEngine: 'njk',
+    htmlTemplateEngine: 'njk',
+  }
+}

package/registry/families/eleventy-static/files/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "eleventy --serve --port={{port}}",
+    "build": "eleventy",
+    "clean": "rm -rf _site",
+    "validate": "node validate-eleventy.mjs",
+    "start": "eleventy --serve --port={{port}}"
+  },
+  "devDependencies": {
+    "@11ty/eleventy": "^3.0.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
+  }
+}

package/registry/families/eleventy-static/files/validate-eleventy.mjs

@@ -0,0 +1,25 @@
+import { existsSync, readFileSync } from 'node:fs'
+
+const must = (cond, msg) => {
+  if (!cond) {
+    console.error(`validate-eleventy: ${msg}`)
+    process.exit(1)
+  }
+}
+
+must(existsSync('.eleventy.js'), 'missing .eleventy.js config')
+must(existsSync('src/index.md'), 'missing src/index.md entry page')
+must(existsSync('src/_includes/base.njk'), 'missing src/_includes/base.njk layout')
+
+const config = readFileSync('.eleventy.js', 'utf8')
+must(/input:\s*['"]src['"]/.test(config), '.eleventy.js must declare dir.input = "src"')
+must(/output:\s*['"]_site['"]/.test(config), '.eleventy.js must declare dir.output = "_site"')
+
+const index = readFileSync('src/index.md', 'utf8')
+must(/^---/m.test(index), 'src/index.md must have YAML frontmatter')
+must(/layout:\s*base\.njk/.test(index), 'src/index.md must set layout: base.njk')
+
+const pkg = JSON.parse(readFileSync('package.json', 'utf8'))
+must(pkg.devDependencies?.['@11ty/eleventy'], 'package.json must depend on @11ty/eleventy')
+
+console.log('eleventy starter ok')

package/registry/families/eleventy-static/manifest.json

@@ -0,0 +1,106 @@
+{
+  "id": "eleventy-static",
+  "description": "Eleventy (11ty) static site generator starter — zero-config Nunjucks + Markdown pipeline, no client JS by default, instant builds.",
+  "tags": [
+    "eleventy",
+    "11ty",
+    "static-site",
+    "ssg",
+    "frontend"
+  ],
+  "taxonomy": {
+    "language": "javascript",
+    "runtime": "node",
+    "surface": "frontend"
+  },
+  "defaults": {
+    "projectType": "frontend",
+    "serviceName": "starter-foundry-eleventy",
+    "port": 8097,
+    "headline": "Starter Foundry Eleventy",
+    "subheadline": "Content-first static site powered by 11ty.",
+    "databaseProvider": "none"
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/.eleventy.js",
+      "target": ".eleventy.js"
+    },
+    {
+      "source": "files/validate-eleventy.mjs",
+      "target": "validate-eleventy.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": ".eleventy.js"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/index.md"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-eleventy.mjs"
+      ],
+      "expect": "eleventy starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "npm install",
+      "npx @11ty/eleventy --serve",
+      "npx @11ty/eleventy"
+    ],
+    "entrypoints": [
+      ".eleventy.js",
+      "src/index.md",
+      "src/_includes/base.njk"
+    ],
+    "preview": {
+      "port": "{{port}}",
+      "path": "/"
+    },
+    "extensionPoints": [
+      "starter-data.json",
+      "starter-brand.json"
+    ]
+  },
+  "keywords": [
+    "eleventy",
+    "11ty",
+    "eleventy site",
+    "11ty site",
+    "nunjucks",
+    "eleventy blog",
+    "11ty blog",
+    "eleventy ssg"
+  ],
+  "scoring": {
+    "boost": {
+      "eleventy": 3,
+      "11ty": 3
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "eleventy",
+      "11ty",
+      "eleventy site",
+      "11ty site"
+    ],
+    "tier2": [
+      "nunjucks",
+      "eleventy blog",
+      "11ty blog",
+      "eleventy ssg"
+    ]
+  }
+}

package/registry/families/esp32-rust/files/Cargo.toml

@@ -0,0 +1,47 @@
+[package]
+name = "{{crateName}}"
+version = "0.1.0"
+edition = "2021"
+rust-version = "1.77"
+resolver = "2"
+
+[[bin]]
+name = "{{crateName}}"
+path = "src/main.rs"
+
+[profile.release]
+opt-level = "s"
+lto = "fat"
+codegen-units = 1
+debug = false
+
+[profile.dev]
+opt-level = "s"
+debug = true
+
+[features]
+default = ["std", "embassy", "esp-idf-svc/native"]
+std = ["esp-idf-svc/std"]
+embassy = ["esp-idf-svc/embassy-sync", "esp-idf-svc/critical-section", "esp-idf-svc/embassy-time-driver"]
+
+[dependencies]
+# Espressif runtime + services. esp-idf-svc wraps the ESP-IDF C APIs
+# (WiFi, NVS, HTTP, MQTT, logging) into safe Rust handles. esp-idf-hal
+# is the peripheral HAL (GPIO, SPI, I2C, UART). esp-idf-sys is the
+# low-level sys crate — pulled in transitively but pinned here so
+# the IDF version is stable.
+esp-idf-svc = { version = "0.49", default-features = false }
+esp-idf-hal = "0.44"
+esp-idf-sys = { version = "0.35", default-features = false }
+log = "0.4"
+anyhow = "1.0"
+heapless = "0.8"
+
+[build-dependencies]
+embuild = "0.32"
+
+[package.metadata.esp-idf-sys]
+esp_idf_version = "v5.2.2"
+esp_idf_tools_install_dir = "global"
+esp_idf_sdkconfig = "sdkconfig"
+esp_idf_sdkconfig_defaults = ["sdkconfig.defaults"]

package/registry/families/esp32-rust/files/build.rs

@@ -0,0 +1,9 @@
+// Build-time hook for esp-idf-sys. Resolves the ESP-IDF checkout,
+// runs its cmake, and wires the output into cargo's link search path.
+// Without embuild::espidf::sysenv::output() the final ELF will fail to
+// link because the ESP-IDF static libs (freertos, esp_wifi, lwip ...)
+// are nowhere on the link line.
+
+fn main() {
+    embuild::espidf::sysenv::output();
+}

package/registry/families/esp32-rust/files/cargo-config.toml

@@ -0,0 +1,22 @@
+# Cargo config for the esp-rs (Xtensa) toolchain. `cargo build` with no
+# --target will use the triple below. The linker flags are what ESP-IDF's
+# idf.py would pass when producing the final ELF — we lean on `ldproxy`
+# (installed by `cargo install ldproxy`) to forward them.
+
+[build]
+target = "xtensa-esp32-espidf"
+
+[target.xtensa-esp32-espidf]
+linker = "ldproxy"
+runner = "espflash flash --monitor"
+rustflags = [
+    "--cfg",  "espidf_time64",
+    "-C", "default-linker-libraries",
+]
+
+[unstable]
+build-std = ["std", "panic_abort"]
+
+[env]
+MCU = "esp32"
+ESP_IDF_VERSION = "v5.2.2"

package/registry/families/esp32-rust/files/rust-toolchain.toml

@@ -0,0 +1,10 @@
+# ESP32 Xtensa targets require the esp-rs forked rustc built by espup.
+# Stock nightly does NOT ship the xtensa-esp32-espidf target. Install with:
+#   cargo install espup
+#   espup install
+#   . $HOME/export-esp.sh   # source in every shell before `cargo build`
+
+[toolchain]
+channel = "esp"
+components = ["rust-src"]
+targets = ["xtensa-esp32-espidf"]

package/registry/families/esp32-rust/files/sdkconfig.defaults

@@ -0,0 +1,28 @@
+# ESP-IDF Kconfig seed. Values here get merged into sdkconfig during the
+# first `cargo build`. Changing this file after a build requires removing
+# .embuild/ to force a regen — ESP-IDF does not re-read defaults on every
+# cargo build, it snapshots them into sdkconfig.
+
+# Main task stack bump. 3584 (default) is not enough for WiFi + TLS + HTTP
+# — the first time you call `EspHttpServer::new()` inside the main task
+# you'll overflow and hit a StoreProhibited panic if this is left low.
+CONFIG_ESP_MAIN_TASK_STACK_SIZE=8192
+
+# FreeRTOS tick rate — 1kHz matches embassy-time defaults.
+CONFIG_FREERTOS_HZ=1000
+
+# WiFi-enable NVS (WiFi stores calibration blobs in NVS; without this the
+# first boot is very slow while RF calibration runs).
+CONFIG_ESP32_PHY_CALIBRATION_AND_DATA_STORAGE=y
+
+# HTTP server — default 10 URIs is fine; bump buffer for JSON bodies.
+CONFIG_HTTPD_MAX_REQ_HDR_LEN=1024
+CONFIG_HTTPD_MAX_URI_LEN=512
+
+# Logging: info-level by default, can override per-module at runtime.
+CONFIG_LOG_DEFAULT_LEVEL_INFO=y
+CONFIG_LOG_MAXIMUM_LEVEL_DEBUG=y
+
+# Use modern C++ stdlib (required by some esp-idf-sys transitive deps).
+CONFIG_COMPILER_CXX_EXCEPTIONS=n
+CONFIG_COMPILER_OPTIMIZATION_SIZE=y

package/registry/families/esp32-rust/files/validate-esp32.mjs

@@ -0,0 +1,54 @@
+// Structural validator for the esp32-rust starter. Does NOT run cargo
+// (xtensa toolchain isn't available during scaffold validation). Asserts
+// the file tree + critical strings so a downstream `cargo build --release`
+// has the preconditions it needs.
+
+import fs from "node:fs/promises";
+
+const [cargoToml, cargoConfig, toolchain, sdkconfig, mainRs] = await Promise.all([
+  fs.readFile("Cargo.toml", "utf8"),
+  fs.readFile(".cargo/config.toml", "utf8"),
+  fs.readFile("rust-toolchain.toml", "utf8"),
+  fs.readFile("sdkconfig.defaults", "utf8"),
+  fs.readFile("src/main.rs", "utf8"),
+]);
+
+if (!cargoToml.includes("esp-idf-svc")) {
+  throw new Error("Cargo.toml must depend on esp-idf-svc");
+}
+if (!cargoToml.includes("esp-idf-hal")) {
+  throw new Error("Cargo.toml must depend on esp-idf-hal");
+}
+if (!cargoToml.includes("esp-idf-sys")) {
+  throw new Error("Cargo.toml must depend on esp-idf-sys");
+}
+if (!cargoToml.includes("[package.metadata.esp-idf-sys]")) {
+  throw new Error("Cargo.toml must pin esp_idf_version under [package.metadata.esp-idf-sys]");
+}
+
+if (!cargoConfig.includes("xtensa-esp32-espidf")) {
+  throw new Error(".cargo/config.toml must set target = \"xtensa-esp32-espidf\"");
+}
+if (!cargoConfig.includes("ldproxy")) {
+  throw new Error(".cargo/config.toml must set linker = \"ldproxy\"");
+}
+
+if (!toolchain.includes('channel = "esp"')) {
+  throw new Error('rust-toolchain.toml must pin channel = "esp" (esp-rs forked rustc)');
+}
+
+if (!sdkconfig.includes("CONFIG_ESP_MAIN_TASK_STACK_SIZE")) {
+  throw new Error("sdkconfig.defaults must bump CONFIG_ESP_MAIN_TASK_STACK_SIZE (WiFi+HTTP overflows the 3584B default)");
+}
+
+if (!mainRs.includes("esp_idf_svc::sys::link_patches")) {
+  throw new Error("src/main.rs must call esp_idf_svc::sys::link_patches() — without it the linker drops the ESP-IDF init patches");
+}
+if (!mainRs.includes("EspHttpServer")) {
+  throw new Error("src/main.rs must instantiate EspHttpServer on :8080 per the spec");
+}
+if (!mainRs.includes("WifiDriver") && !mainRs.includes("EspWifi")) {
+  throw new Error("src/main.rs must set up a WiFi driver (scan or station mode)");
+}
+
+console.log("esp32-rust starter ok");

package/registry/families/esp32-rust/manifest.json

@@ -0,0 +1,168 @@
+{
+  "id": "esp32-rust",
+  "description": "ESP32 Rust firmware starter using the esp-idf-svc + esp-idf-hal stack on top of the ESP-IDF (FreeRTOS). Includes WiFi scan, GPIO LED task, and a tiny HTTP server on :8080. For IoT firmware where you want Rust ergonomics on Espressif's Xtensa silicon without going fully no_std.",
+  "tags": [
+    "embedded",
+    "rust",
+    "iot",
+    "firmware"
+  ],
+  "taxonomy": {
+    "language": "rust",
+    "runtime": "esp-idf",
+    "surface": "embedded"
+  },
+  "slots": {
+    "auth": {
+      "options": ["auth:none"],
+      "default": "auth:none"
+    },
+    "payments": {
+      "options": ["payments:none"],
+      "default": "payments:none"
+    },
+    "sdk": {
+      "options": ["sdk:none"],
+      "default": "sdk:none"
+    }
+  },
+  "defaults": {
+    "projectType": "embedded",
+    "crateName": "starter_foundry_esp32",
+    "packageName": "starter-foundry-esp32",
+    "headline": "Rust on ESP32, WiFi first-class",
+    "subheadline": "esp-idf-svc + esp-idf-hal — FreeRTOS tasks, WiFi, GPIO and an HTTP server on port 8080."
+  },
+  "files": [
+    {
+      "source": "files/Cargo.toml",
+      "target": "Cargo.toml"
+    },
+    {
+      "source": "files/cargo-config.toml",
+      "target": ".cargo/config.toml"
+    },
+    {
+      "source": "files/rust-toolchain.toml",
+      "target": "rust-toolchain.toml"
+    },
+    {
+      "source": "files/sdkconfig.defaults",
+      "target": "sdkconfig.defaults"
+    },
+    {
+      "source": "files/build.rs",
+      "target": "build.rs"
+    },
+    {
+      "source": "files/validate-esp32.mjs",
+      "target": "validate-esp32.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "Cargo.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": ".cargo/config.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/main.rs"
+    },
+    {
+      "type": "file-exists",
+      "path": "sdkconfig.defaults"
+    },
+    {
+      "type": "command-success",
+      "command": ["node", "validate-esp32.mjs"],
+      "expect": "esp32-rust starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "cargo build --release",
+      "cargo espflash flash --release --monitor"
+    ],
+    "entrypoints": [
+      "src/main.rs",
+      "Cargo.toml",
+      "sdkconfig.defaults",
+      ".cargo/config.toml"
+    ],
+    "preview": {
+      "path": "/"
+    },
+    "extensionPoints": [
+      "src/main.rs",
+      "sdkconfig.defaults"
+    ]
+  },
+  "keywords": [
+    "esp32",
+    "esp-idf",
+    "esp-idf-svc",
+    "esp-idf-hal",
+    "espressif",
+    "xtensa",
+    "esp32 rust",
+    "rust esp32",
+    "iot firmware",
+    "embedded wifi"
+  ],
+  "scoring": {
+    "boost": {
+      "esp32": 5,
+      "esp-idf": 5,
+      "espressif": 4,
+      "xtensa": 4,
+      "esp-idf-svc": 4,
+      "esp-idf-hal": 4
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "esp32",
+      "esp-idf",
+      "esp-idf-svc",
+      "esp-idf-hal",
+      "espressif",
+      "xtensa"
+    ],
+    "tier2": [
+      "esp32 rust",
+      "rust esp32",
+      "esp32 firmware",
+      "esp32 wifi"
+    ],
+    "archetypes": [
+      "esp32 iot firmware",
+      "wifi-connected sensor node",
+      "esp32 http server",
+      "esp32 mqtt client",
+      "embedded rust on espressif"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Pick for ESP32 / ESP32-S3 / ESP32-C3 firmware in Rust when you want ESP-IDF services (WiFi, BT, NVS, partition table, HTTP server). For bare-metal Rust on ESP32 without FreeRTOS, use esp-hal no_std instead — that's a different family.",
+    "firstSteps": [
+      "Install the esp-rs toolchain: cargo install espup && espup install",
+      "Source the exports: . $HOME/export-esp.sh (adds xtensa rustc + clang to PATH)",
+      "Install espflash: cargo install espflash cargo-espflash",
+      "Build: cargo build --release",
+      "Flash + monitor a connected board: cargo espflash flash --release --monitor"
+    ],
+    "gotchas": [
+      "xtensa-esp32-espidf requires the esp-rs forked rustc (installed by espup). Stock rustup nightly will NOT build this crate — rust-toolchain.toml must declare channel = \"esp\".",
+      "You MUST source $HOME/export-esp.sh in every shell before building. Without it, rustc cannot find the xtensa target and linking will fail with cryptic llvm errors.",
+      "esp-idf-sys builds the entire ESP-IDF C framework on first compile (~3-5 min). Cache .embuild/ between CI runs or every build is a cold build.",
+      "sdkconfig.defaults is the Kconfig seed. Editing it after first build requires deleting .embuild/ — runtime Kconfig is baked during the ESP-IDF cmake step, not re-read every cargo build.",
+      "FreeRTOS default task stack is 3584 bytes. WiFi + TLS + HTTP will blow it — bump CONFIG_ESP_MAIN_TASK_STACK_SIZE to 8192+ in sdkconfig.defaults (already set in this starter).",
+      "Logging with log::info! requires esp_idf_svc::log::EspLogger::initialize_default() early in main, before any println!. Raw println! over UART works but bypasses the ESP-IDF log level filters.",
+      "Cargo.toml must include [package.metadata.esp-idf-sys] with esp_idf_version — otherwise esp-idf-sys pins to an old IDF and WiFi APIs shift under you."
+    ]
+  }
+}

package/registry/families/expo-react-native-ts/files/package.json

@@ -8,11 +8,19 @@
   },
   "dependencies": {
     "expo": "^53.0.0",
-    "react": "^19.1.0",
+    "react": "^19.2.0",
     "react-native": "^0.79.0"
   },
   "devDependencies": {
-    "typescript": "^5.7.0",
-    "@types/react": "^19.0.0"
+    "typescript": "^5.9.0",
+    "@types/react": "^19.2.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
   }
 }

package/registry/families/expo-rn-rich/files/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "expo start --dev-client",
+    "prebuild": "expo prebuild --clean",
+    "validate": "node validate-expo-rn-rich.mjs"
+  },
+  "dependencies": {
+    "@react-navigation/bottom-tabs": "^7.2.0",
+    "@react-navigation/native": "^7.0.0",
+    "@react-navigation/native-stack": "^7.2.0",
+    "@shopify/react-native-skia": "^1.7.0",
+    "expo": "~52.0.0",
+    "expo-status-bar": "~2.0.0",
+    "react": "^19.2.0",
+    "react-native": "^0.79.0",
+    "react-native-gesture-handler": "~2.20.0",
+    "react-native-reanimated": "~3.16.0",
+    "react-native-safe-area-context": "~4.12.0",
+    "react-native-screens": "~4.1.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.0",
+    "@types/react": "^19.2.0",
+    "typescript": "^5.9.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
+  }
+}

package/registry/families/expo-rn-rich/files/validate-expo-rn-rich.mjs

@@ -0,0 +1,43 @@
+import fs from "node:fs/promises";
+
+const appSource = await fs.readFile("App.tsx", "utf8");
+JSON.parse(await fs.readFile("app.json", "utf8"));
+JSON.parse(await fs.readFile("tsconfig.json", "utf8"));
+
+// Must import react-native-gesture-handler FIRST — any imports before
+// it boot without the gesture patch applied.
+const firstImportLine = appSource.split("\n").find((line) => line.trim().startsWith("import"));
+if (!firstImportLine || !firstImportLine.includes("react-native-gesture-handler")) {
+  throw new Error("App.tsx must import react-native-gesture-handler as the FIRST import — gesture patches miss otherwise");
+}
+
+if (!appSource.includes("GestureHandlerRootView")) {
+  throw new Error("App.tsx must wrap the tree in GestureHandlerRootView — nested gestures drop events on Android otherwise");
+}
+
+if (!appSource.includes("NavigationContainer")) {
+  throw new Error("App.tsx must mount a NavigationContainer — React Navigation wiring is missing");
+}
+
+const babel = await fs.readFile("babel.config.js", "utf8");
+const reanimatedIdx = babel.indexOf("react-native-reanimated/plugin");
+if (reanimatedIdx === -1) {
+  throw new Error("babel.config.js must include react-native-reanimated/plugin");
+}
+// Crude last-plugin check: nothing substantial should appear after it
+// in the plugins array. Accept trailing whitespace, closing brackets,
+// commas, and comments.
+const trailing = babel.slice(reanimatedIdx + "react-native-reanimated/plugin".length);
+if (/['"]\s*,\s*['"]/.test(trailing)) {
+  throw new Error("react-native-reanimated/plugin must be the LAST plugin — Reanimated v3 worklets break silently otherwise");
+}
+
+const canvas = await fs.readFile("src/screens/CanvasScreen.tsx", "utf8");
+if (!canvas.includes("@shopify/react-native-skia")) {
+  throw new Error("src/screens/CanvasScreen.tsx must use @shopify/react-native-skia");
+}
+if (!canvas.includes("useSharedValue") && !canvas.includes("useDerivedValue")) {
+  throw new Error("src/screens/CanvasScreen.tsx should drive the Skia canvas from a Reanimated shared value");
+}
+
+console.log("expo rn rich ok");