@tangle-network/starter-foundry 0.5.4 → 0.7.0

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

@@ -0,0 +1,170 @@
+{
+  "id": "stm32-rust",
+  "description": "STM32 bare-metal Rust firmware using the Embassy async framework — #[embassy_executor::main], async GPIO blink on an LED, and an async UART echo loop. Targets the STM32F4 family (STM32F411 Nucleo/Black Pill by default; swap HAL feature + memory.x for other chips). Flash + RTT via probe-rs.",
+  "tags": [
+    "embedded",
+    "rust",
+    "bare-metal",
+    "firmware"
+  ],
+  "taxonomy": {
+    "language": "rust",
+    "runtime": "embassy",
+    "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_stm32",
+    "packageName": "starter-foundry-stm32",
+    "headline": "Async Rust on Cortex-M with Embassy",
+    "subheadline": "embassy-stm32 + embassy-executor — async GPIO + UART echo on bare-metal STM32F4."
+  },
+  "files": [
+    {
+      "source": "files/Cargo.toml",
+      "target": "Cargo.toml"
+    },
+    {
+      "source": "files/cargo-config.toml",
+      "target": ".cargo/config.toml"
+    },
+    {
+      "source": "files/memory.x",
+      "target": "memory.x"
+    },
+    {
+      "source": "files/build.rs",
+      "target": "build.rs"
+    },
+    {
+      "source": "files/Embed.toml",
+      "target": "Embed.toml"
+    },
+    {
+      "source": "files/validate-stm32.mjs",
+      "target": "validate-stm32.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "Cargo.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": ".cargo/config.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": "memory.x"
+    },
+    {
+      "type": "file-exists",
+      "path": "Embed.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/main.rs"
+    },
+    {
+      "type": "command-success",
+      "command": ["node", "validate-stm32.mjs"],
+      "expect": "stm32-rust starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "cargo build --release",
+      "cargo run --release"
+    ],
+    "entrypoints": [
+      "src/main.rs",
+      "Cargo.toml",
+      "memory.x",
+      ".cargo/config.toml"
+    ],
+    "preview": {
+      "path": "/"
+    },
+    "extensionPoints": [
+      "src/main.rs",
+      "memory.x"
+    ]
+  },
+  "keywords": [
+    "stm32",
+    "embassy",
+    "embassy-stm32",
+    "cortex-m",
+    "bare metal rust",
+    "stm32f4",
+    "probe-rs",
+    "no_std",
+    "thumbv7em"
+  ],
+  "scoring": {
+    "boost": {
+      "stm32": 5,
+      "embassy": 4,
+      "cortex-m": 3,
+      "probe-rs": 3,
+      "stm32f4": 4,
+      "thumbv7em": 4
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "stm32",
+      "embassy",
+      "embassy-stm32",
+      "stm32f4",
+      "cortex-m"
+    ],
+    "tier2": [
+      "bare metal rust",
+      "probe-rs",
+      "thumbv7em",
+      "stm32 firmware"
+    ],
+    "archetypes": [
+      "stm32 bare metal",
+      "embassy async firmware",
+      "cortex-m blinky",
+      "stm32 uart echo",
+      "motor controller firmware"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Pick for STM32F/L/G series firmware in Rust when you want async/await (Embassy). For synchronous cortex-m-rt + RTIC, pick a different starter. For Raspberry Pi Pico, use rp2040-embassy.",
+    "firstSteps": [
+      "Install the Cortex-M4F target: rustup target add thumbv7em-none-eabihf",
+      "Install the flasher: cargo install probe-rs --features cli --locked",
+      "Connect an ST-Link (or any CMSIS-DAP probe) to the board",
+      "Build: cargo build --release",
+      "Flash + RTT: cargo run --release     # runs `probe-rs run --chip STM32F411RETx` via the cargo runner"
+    ],
+    "gotchas": [
+      "memory.x must match the actual chip. STM32F411RE = 512K flash + 128K RAM; STM32F401RE = 512K flash + 96K RAM; STM32F103C8 = 64K flash + 20K RAM. Wrong values silently let the linker succeed then crash at boot.",
+      "embassy-stm32 requires exactly one chip feature — e.g. `stm32f411re`. Enabling two (or none) is a compile error with a misleading `time_driver_tim5 not found` message.",
+      "The cortex-m-rt link args (`-Tlink.x`, `-Tdefmt.x`) must be in .cargo/config.toml rustflags. If you put them in build.rs alone they only apply when the `build.rs` crate links, not the downstream bin.",
+      "defmt-rtt requires a running probe-rs to drain the RTT buffer. Without a probe attached at runtime the firmware will spin waiting for the RTT reader after ~1KB of logs.",
+      "Stock embassy-executor wants a time driver. `embassy-time/tick-hz-32_768` + a chip TIM peripheral is the default; forgetting to enable a time-driver feature is the #1 new-user compile error.",
+      "Changing memory.x requires `cargo clean` — cargo does not see memory.x as a build input so the linker will use a stale copy from target/.",
+      "No_std environments have no default panic handler. panic-probe (defmt-flavored) or panic-halt is MANDATORY — the build fails with `#[panic_handler] function required` otherwise."
+    ]
+  }
+}

package/registry/families/streamlit-advanced/files/config.toml

@@ -0,0 +1,12 @@
+[server]
+headless = true
+port = {{port}}
+address = "0.0.0.0"
+runOnSave = true
+
+[browser]
+gatherUsageStats = false
+
+[theme]
+base = "light"
+primaryColor = "#2563eb"

package/registry/families/streamlit-advanced/files/requirements.txt

@@ -0,0 +1,5 @@
+streamlit>=1.38
+plotly>=5.24
+pandas>=2.2
+pydantic>=2.8
+pydantic-settings>=2.5

package/registry/families/streamlit-advanced/files/validate-streamlit.mjs

@@ -0,0 +1,27 @@
+import { existsSync, readFileSync } from 'node:fs'
+
+const must = (cond, msg) => {
+  if (!cond) {
+    console.error(`validate-streamlit: ${msg}`)
+    process.exit(1)
+  }
+}
+
+must(existsSync('app.py'), 'missing app.py entrypoint')
+must(existsSync('pages/1_analysis.py'), 'missing pages/1_analysis.py (Streamlit multipage convention: pages/<number>_<name>.py)')
+must(existsSync('requirements.txt'), 'missing requirements.txt')
+must(existsSync('.streamlit/config.toml'), 'missing .streamlit/config.toml')
+
+const reqs = readFileSync('requirements.txt', 'utf8')
+must(/streamlit/.test(reqs), 'requirements.txt must pin streamlit')
+must(/plotly/.test(reqs), 'requirements.txt must pin plotly')
+must(/pydantic/.test(reqs), 'requirements.txt must pin pydantic')
+
+const app = readFileSync('app.py', 'utf8')
+must(/st\.set_page_config/.test(app), 'app.py must call st.set_page_config (required before any other Streamlit call)')
+must(/@st\.cache_data|@st\.cache_resource/.test(app), 'app.py should use st.cache_data or st.cache_resource to demonstrate caching')
+
+const cfg = readFileSync('.streamlit/config.toml', 'utf8')
+must(/\[server\]/.test(cfg), '.streamlit/config.toml must have a [server] section')
+
+console.log('streamlit-advanced starter ok')

package/registry/families/streamlit-advanced/manifest.json

@@ -0,0 +1,109 @@
+{
+  "id": "streamlit-advanced",
+  "description": "Production-grade Streamlit starter — multipage app with sidebar nav, st.cache_data, Plotly charts, and a typed Pydantic settings layer.",
+  "tags": [
+    "streamlit",
+    "multipage",
+    "data-app",
+    "python",
+    "dashboard"
+  ],
+  "taxonomy": {
+    "language": "python",
+    "runtime": "python",
+    "surface": "data-app"
+  },
+  "defaults": {
+    "projectType": "data-app",
+    "serviceName": "starter-foundry-streamlit",
+    "port": 8501,
+    "headline": "Streamlit Production Dashboard",
+    "subheadline": "Multipage Streamlit app with caching, Plotly, and typed settings."
+  },
+  "files": [
+    {
+      "source": "files/requirements.txt",
+      "target": "requirements.txt"
+    },
+    {
+      "source": "files/config.toml",
+      "target": ".streamlit/config.toml"
+    },
+    {
+      "source": "files/validate-streamlit.mjs",
+      "target": "validate-streamlit.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "app.py"
+    },
+    {
+      "type": "file-exists",
+      "path": "pages/1_analysis.py"
+    },
+    {
+      "type": "python-compile",
+      "path": "app.py"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-streamlit.mjs"
+      ],
+      "expect": "streamlit-advanced starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "pip install -r requirements.txt",
+      "streamlit run app.py --server.port {{port}}"
+    ],
+    "entrypoints": [
+      "app.py",
+      "pages/1_analysis.py",
+      ".streamlit/config.toml"
+    ],
+    "preview": {
+      "port": "{{port}}",
+      "path": "/"
+    },
+    "extensionPoints": [
+      "starter-data.json",
+      "starter-brand.json"
+    ]
+  },
+  "keywords": [
+    "streamlit multipage",
+    "multipage streamlit",
+    "streamlit dashboard app",
+    "production streamlit",
+    "streamlit plotly",
+    "streamlit caching",
+    "streamlit app with tabs",
+    "streamlit sidebar"
+  ],
+  "scoring": {
+    "boost": {
+      "streamlit multipage": 5,
+      "multipage streamlit": 5,
+      "production streamlit": 4
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "streamlit multipage",
+      "multipage streamlit",
+      "production streamlit",
+      "streamlit dashboard app"
+    ],
+    "tier2": [
+      "streamlit plotly",
+      "streamlit caching",
+      "streamlit sidebar",
+      "streamlit app with tabs"
+    ]
+  }
+}

package/registry/families/tauri-desktop/files/package.json

@@ -8,14 +8,14 @@
     "validate": "node validate-types.mjs"
   },
   "dependencies": {
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0"
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
   },
   "devDependencies": {
-    "vite": "^6.2.0",
-    "@vitejs/plugin-react": "^4.4.0",
+    "vite": "^6.4.2",
+    "@vitejs/plugin-react": "^4.7.0",
     "@tauri-apps/cli": "^2.0.0",
-    "typescript": "^5.7.0",
-    "@types/node": "^20.0.0"
+    "typescript": "^5.9.0",
+    "@types/node": "^20.17.0"
   }
 }

package/registry/families/tauri-menubar/files/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "cargo tauri dev",
+    "preview:instant": "node preview-server.mjs",
+    "validate": "node validate-types.mjs"
+  },
+  "dependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@tauri-apps/cli": "^2.0.0",
+    "@types/node": "^20.17.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^4.7.0",
+    "typescript": "^5.9.0",
+    "vite": "^6.4.2"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
+  }
+}

package/registry/families/tauri-menubar/files/preview-server.mjs

@@ -0,0 +1,36 @@
+import fs from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const port = Number.parseInt(process.env.PORT || "{{port}}", 10);
+const mimeTypes = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".json": "application/json; charset=utf-8"
+};
+
+// Menu-bar popover preview: same index.html / app bundle as production,
+// just served over HTTP instead of the Tauri webview so humans can see
+// the compact panel layout at its native 320x400 size.
+const server = http.createServer(async (request, response) => {
+  const requestPath = request.url === "/" ? "/index.html" : request.url;
+  const filePath = path.join(__dirname, requestPath.slice(1));
+
+  try {
+    const content = await fs.readFile(filePath);
+    response.writeHead(200, {
+      "content-type": mimeTypes[path.extname(filePath)] || "text/plain; charset=utf-8"
+    });
+    response.end(content);
+  } catch {
+    response.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
+    response.end("not found");
+  }
+});
+
+server.listen(port, "0.0.0.0", () => {
+  console.log(`preview listening on ${port}`);
+});

package/registry/families/tauri-menubar/files/validate-types.mjs

@@ -0,0 +1,31 @@
+import fs from "node:fs/promises";
+import { stripTypeScriptTypes } from "node:module";
+
+const appSource = await fs.readFile("src/App.tsx", "utf8");
+stripTypeScriptTypes(appSource);
+
+const mainSource = await fs.readFile("src/main.tsx", "utf8");
+stripTypeScriptTypes(mainSource);
+
+JSON.parse(await fs.readFile("tsconfig.json", "utf8"));
+
+const tauriConf = JSON.parse(await fs.readFile("src-tauri/tauri.conf.json", "utf8"));
+const win = tauriConf.app?.windows?.[0];
+if (!win || win.decorations !== false || win.alwaysOnTop !== true || win.skipTaskbar !== true) {
+  throw new Error("tauri.conf.json window is not configured as a popover panel (decorations:false, alwaysOnTop:true, skipTaskbar:true)");
+}
+
+const cargoToml = await fs.readFile("src-tauri/Cargo.toml", "utf8");
+if (!cargoToml.includes("[package]")) {
+  throw new Error("missing tauri Cargo package block");
+}
+if (!cargoToml.includes("tauri-plugin-positioner") && !cargoToml.includes("tray")) {
+  throw new Error("tauri-menubar expects a tray/positioner dep so the popover anchors to the menu-bar icon");
+}
+
+const libRs = await fs.readFile("src-tauri/src/lib.rs", "utf8");
+if (!libRs.includes("TrayIconBuilder")) {
+  throw new Error("src-tauri/src/lib.rs must build a TrayIcon for the menu-bar surface");
+}
+
+console.log("tauri menubar ok");

package/registry/families/tauri-menubar/manifest.json

@@ -0,0 +1,174 @@
+{
+  "id": "tauri-menubar",
+  "description": "Tauri menu-bar / tray-anchored popover panel app (Raycast-like floating panel).",
+  "tags": [
+    "desktop",
+    "tauri",
+    "menubar",
+    "popover",
+    "typescript"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "tauri",
+    "surface": "frontend"
+  },
+  "slots": {
+    "auth": {
+      "options": [
+        "auth:none",
+        "auth:better-auth",
+        "auth:clerk",
+        "auth:supabase-auth"
+      ],
+      "default": "auth:none"
+    },
+    "payments": {
+      "options": [
+        "payments:none",
+        "payments:stripe",
+        "payments:coinbase-commerce"
+      ],
+      "default": "payments:none"
+    },
+    "sdk": {
+      "options": [
+        "sdk:none",
+        "sdk:coinbase-cdp",
+        "sdk:solana-web3",
+        "sdk:evm-wallet"
+      ],
+      "default": "sdk:none"
+    }
+  },
+  "defaults": {
+    "projectType": "desktop",
+    "port": 4196,
+    "headline": "Starter Foundry Menu Bar",
+    "subheadline": "A tray-anchored popover panel for quick actions, search, and commands."
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/preview-server.mjs",
+      "target": "preview-server.mjs"
+    },
+    {
+      "source": "files/validate-types.mjs",
+      "target": "validate-types.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src-tauri/Cargo.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": "src-tauri/src/lib.rs"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-types.mjs"
+      ],
+      "expect": "tauri menubar ok"
+    },
+    {
+      "type": "http-start",
+      "command": [
+        "node",
+        "preview-server.mjs"
+      ],
+      "path": "/",
+      "expect": "{{headline}}"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "pnpm install",
+      "node preview-server.mjs",
+      "cargo tauri dev"
+    ],
+    "entrypoints": [
+      "src-tauri/src/lib.rs",
+      "src-tauri/tauri.conf.json",
+      "src/App.tsx"
+    ],
+    "preview": {
+      "path": "/"
+    },
+    "extensionPoints": [
+      "auth-config.json",
+      "payments-config.json",
+      "sdk-config.json"
+    ]
+  },
+  "keywords": [
+    "menu bar app",
+    "macos menubar",
+    "menubar app",
+    "tray popover",
+    "floating panel app",
+    "raycast",
+    "alfred clone",
+    "tauri menubar"
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "menu bar app",
+      "macos menubar",
+      "menubar",
+      "raycast-like",
+      "floating panel app"
+    ],
+    "tier2": [
+      "tauri popover",
+      "tray popover",
+      "alfred clone",
+      "quick launcher",
+      "command palette desktop"
+    ],
+    "tier3": [
+      "small utility app",
+      "always on top"
+    ],
+    "archetypes": [
+      "raycast clone",
+      "menu bar utility",
+      "spotlight-style launcher"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Pick tauri-menubar when the app lives in the macOS menu bar or Windows system tray and opens a small floating popover on click (Raycast, Bartender, 1Password mini). The primary window is a short-lived panel positioned near the tray icon — NOT a long-lived workspace window. If the user wants a full desktop window, use tauri-desktop instead. If they want a tray icon with ONLY a menu (no popover), use tauri-tray.",
+    "architectureNotes": [
+      "src-tauri/src/lib.rs owns the TrayIconBuilder and positions the window under the tray icon on show; main.rs just forwards to lib::run().",
+      "The popover window is decorations:false, alwaysOnTop:true, skipTaskbar:true, resizable:false at 320x400.",
+      "Hide-on-blur is wired via the on_window_event focus handler so the panel dismisses like a native menu.",
+      "On macOS set activation policy to Accessory so no dock icon appears; on Windows skipTaskbar achieves the same effect.",
+      "Global shortcut (cmd+shift+space default) toggles the popover — register through tauri-plugin-global-shortcut."
+    ],
+    "components": [
+      "TrayIcon handler (Rust) — opens/positions the popover relative to the click location.",
+      "Compact popover shell (React) — fixed 320x400, scrollable list, single-column layout.",
+      "Command input / fuzzy search row as the primary interaction pattern."
+    ],
+    "gotchas": [
+      "macOS: set `LSUIElement` (activation policy Accessory) or the app shows a dock icon AND the menu-bar icon. Use tauri::ActivationPolicy::Accessory on macOS at setup time.",
+      "macOS notarization: menu-bar apps still need notarization for Gatekeeper — ship with `tauri-build` signing and run `xcrun notarytool submit` before distribution.",
+      "Windows: tray icons need a real .ico file; Tauri default sizing is 16x16 — ship multi-resolution icons or they render blurry on HiDPI.",
+      "Positioning: macOS menu-bar Y coordinate is measured from the top, but some multi-monitor setups put the menu bar on a non-primary display — read `monitor.position()` from the tray event, don't hardcode.",
+      "Hide-on-blur on Windows fires focus-lost when the user clicks the tray icon itself, causing a show-then-immediately-hide loop; gate the hide with a 100ms debounce.",
+      "Auto-launch at login uses tauri-plugin-autostart — on macOS this creates a LaunchAgent plist, on Windows a registry Run key. Users must grant the permission explicitly."
+    ],
+    "integrations": [
+      "tauri-plugin-global-shortcut — hotkey to toggle the popover",
+      "tauri-plugin-autostart — launch at login",
+      "tauri-plugin-positioner — canonical popover positioning relative to tray"
+    ]
+  }
+}

package/registry/families/tauri-tray/files/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "cargo tauri dev",
+    "preview:instant": "node preview-server.mjs",
+    "validate": "node validate-types.mjs"
+  },
+  "devDependencies": {
+    "@tauri-apps/cli": "^2.0.0",
+    "@types/node": "^20.17.0",
+    "typescript": "^5.9.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
+  }
+}