@tangle-network/starter-foundry 0.5.3 → 0.7.0

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

@@ -0,0 +1,141 @@
+{
+  "id": "astro-static",
+  "description": "Astro 5.x static site starter — islands architecture, zero-JS by default, Vite-powered dev server, MDX-ready content.",
+  "tags": [
+    "astro",
+    "ssg",
+    "frontend",
+    "static"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "node",
+    "surface": "frontend"
+  },
+  "defaults": {
+    "projectType": "frontend",
+    "serviceName": "starter-foundry-astro",
+    "port": 4321,
+    "headline": "Starter Foundry landing page",
+    "subheadline": "Astro static starter."
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/tsconfig.json",
+      "target": "tsconfig.json"
+    },
+    {
+      "source": "files/validate-astro.mjs",
+      "target": "validate-astro.mjs"
+    },
+    {
+      "source": "files/.gitignore",
+      "target": ".gitignore"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "astro.config.mjs"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/pages/index.astro"
+    },
+    {
+      "type": "file-exists",
+      "path": "package.json"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-astro.mjs"
+      ],
+      "expect": "astro starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "npm install",
+      "npm run dev",
+      "npm run build"
+    ],
+    "entrypoints": [
+      "src/pages/index.astro",
+      "src/layouts/Base.astro",
+      "astro.config.mjs"
+    ],
+    "preview": {
+      "port": "{{port}}",
+      "path": "/"
+    },
+    "extensionPoints": [
+      "src/pages",
+      "src/components",
+      "src/content",
+      "public"
+    ]
+  },
+  "keywords": [
+    "astro",
+    "astrojs",
+    "astro site",
+    "astro static",
+    "astro islands",
+    "islands architecture",
+    "mdx site"
+  ],
+  "scoring": {
+    "boost": {
+      "astro": 3
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "astro",
+      "astrojs",
+      "astro islands"
+    ],
+    "tier2": [
+      "astro site",
+      "astro static",
+      "islands architecture",
+      "mdx site"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Content-focused static sites (marketing, docs, blogs) where you want islands of interactivity without shipping a full SPA runtime.",
+    "firstSteps": [
+      "Install deps with `npm install`. Astro works with pnpm/yarn too but the lockfile here is npm by default.",
+      "Run `npm run dev` — Astro's Vite dev server binds to http://localhost:4321 with HMR.",
+      "Add pages by dropping `.astro` / `.md` / `.mdx` files into `src/pages/` — every file becomes a route (file-based routing).",
+      "Shared layout lives in `src/layouts/Base.astro`. Wrap each page with `<Base title=\"...\">...</Base>`.",
+      "Build production output with `npm run build` — emits fully static HTML/CSS/JS into `./dist`. Preview locally with `npm run preview`."
+    ],
+    "gotchas": [
+      "Frontmatter in `.astro` files runs at BUILD time on the server — you cannot reference browser globals (`window`, `document`) there. Put client code inside `<script>` tags or `client:*` directives.",
+      "To add a React/Vue/Svelte island you must install `@astrojs/<framework>` AND add it to `astro.config.mjs`'s `integrations` array. Just importing a `.jsx` file silently fails.",
+      "Content Collections (v5) replace loose `src/content/*.md` conventions — define a schema in `src/content.config.ts` or file-based content will not be typed.",
+      "`import.meta.env.PUBLIC_*` is the only prefix exposed to client bundles. Non-prefixed env vars are build-time server-only."
+    ],
+    "architectureNotes": [
+      "Astro ships ZERO JS by default. Adding interactivity is opt-in per component via `client:load`, `client:idle`, `client:visible`, or `client:only`.",
+      "Output mode in `astro.config.mjs` defaults to `static`. Switch to `server` / `hybrid` only if the product actually needs SSR — this family is static-only."
+    ],
+    "placeholders": [
+      {
+        "path": "src/pages/index.astro",
+        "description": "Default landing page with placeholder hero + feature grid. Replace ALL visible copy with the product's real content before shipping — treat it as boilerplate, not a template."
+      },
+      {
+        "path": "src/layouts/Base.astro",
+        "description": "Shared HTML shell: <head>, meta tags, global CSS import, <slot /> for page body. Edit meta/OG tags before production."
+      }
+    ]
+  }
+}

package/registry/families/bevy-web/files/Cargo.toml

@@ -0,0 +1,27 @@
+[package]
+name = "{{crateName}}"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+bevy = { version = "0.14", features = ["default"] }
+
+# wasm-bindgen is pulled in transitively by Bevy's web backend, but we
+# pin a floor here so the direct dependency is visible and patchable.
+[target.'cfg(target_arch = "wasm32")'.dependencies]
+wasm-bindgen = "0.2"
+console_error_panic_hook = "0.1"
+
+[profile.release]
+# `opt-level = "s"` trades a small amount of runtime speed for meaningful
+# bundle-size reductions; Bevy release WASM is dominated by code size,
+# not hot-loop perf. lto = "fat" shaves another 5–10% at the cost of
+# longer builds; enable once iteration speed matters less than ship size.
+opt-level = "s"
+lto = "thin"
+codegen-units = 1
+
+[profile.dev]
+# Debug builds in Bevy WASM are painfully slow without some opt; 1 is
+# the sweet spot for iteration.
+opt-level = 1

package/registry/families/bevy-web/files/Trunk.toml

@@ -0,0 +1,20 @@
+# Trunk config — the standard Bevy-web build tool. Wraps wasm-bindgen +
+# wasm-opt and serves the page. `trunk serve` for dev, `trunk build
+# --release` for production.
+
+[build]
+target = "index.html"
+dist = "dist"
+# Relative public_url lets the bundle be served from any subpath, which
+# matters for static hosts that deploy under /project-name/.
+public_url = "./"
+
+[serve]
+addresses = ["127.0.0.1"]
+port = 8080
+open = false
+
+[[hooks]]
+stage = "post_build"
+command = "sh"
+command_arguments = ["-c", "echo 'bevy-web build complete — dist/ ready to serve'"]

package/registry/families/bevy-web/files/build.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Bevy-web build script. Trunk is the canonical path — this wrapper
+# exists for CI systems that need a single reproducible entrypoint.
+set -euo pipefail
+
+# Prerequisites (install once per machine):
+#   rustup target add wasm32-unknown-unknown
+#   cargo install --locked trunk wasm-bindgen-cli
+
+if ! command -v trunk >/dev/null 2>&1; then
+  echo "error: trunk not found. Install with: cargo install --locked trunk" >&2
+  exit 1
+fi
+
+MODE="${1:-release}"
+case "$MODE" in
+  dev)
+    trunk build
+    ;;
+  release)
+    trunk build --release
+    ;;
+  serve)
+    exec trunk serve
+    ;;
+  *)
+    echo "usage: $0 [dev|release|serve]" >&2
+    exit 1
+    ;;
+esac
+
+echo "bevy-web build done → dist/"

package/registry/families/bevy-web/files/index.html

@@ -0,0 +1,30 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{serviceName}}</title>
+    <!-- Trunk directives: `data-trunk` tells Trunk to build the Rust crate
+         to WASM, run wasm-bindgen, and inject the loader script here. -->
+    <link data-trunk rel="rust" data-wasm-opt="z" />
+    <style>
+      html, body { margin: 0; padding: 0; height: 100%; background: #0b0d10; overflow: hidden; }
+      canvas { display: block; outline: none; }
+      #loading { position: fixed; inset: 0; display: grid; place-items: center; color: #e7ecf3; font: 14px/1.5 ui-monospace, Menlo, monospace; }
+    </style>
+  </head>
+  <body>
+    <div id="loading">Compiling Bevy WASM…</div>
+    <script>
+      // Bevy creates its canvas on load; hide the loading overlay as
+      // soon as the canvas appears.
+      const observer = new MutationObserver(() => {
+        if (document.querySelector('canvas')) {
+          document.getElementById('loading')?.remove();
+          observer.disconnect();
+        }
+      });
+      observer.observe(document.body, { childList: true, subtree: true });
+    </script>
+  </body>
+</html>

package/registry/families/bevy-web/files/validate-bevy-web.mjs

@@ -0,0 +1,46 @@
+// Structural validator for the bevy-web starter. Does NOT run cargo or
+// trunk (both require the Rust + wasm32 toolchain, which scaffold
+// validation runs without). Confirms the Cargo/Trunk/main.rs wiring is
+// internally consistent.
+
+import fs from "node:fs/promises";
+
+const [cargoToml, trunkToml, mainRs, indexHtml] = await Promise.all([
+  fs.readFile("Cargo.toml", "utf8"),
+  fs.readFile("Trunk.toml", "utf8"),
+  fs.readFile("src/main.rs", "utf8"),
+  fs.readFile("index.html", "utf8"),
+]);
+
+if (!/name\s*=\s*"\{\{crateName\}\}"/.test(cargoToml)) {
+  throw new Error('Cargo.toml must declare `name = "{{crateName}}"`');
+}
+if (!/bevy\s*=/.test(cargoToml)) {
+  throw new Error("Cargo.toml missing `bevy` dependency");
+}
+if (!cargoToml.includes('target_arch = "wasm32"')) {
+  throw new Error("Cargo.toml should gate wasm32-specific deps under cfg(target_arch = \"wasm32\")");
+}
+
+if (!/target\s*=\s*"index\.html"/.test(trunkToml)) {
+  throw new Error('Trunk.toml must set `target = "index.html"` under [build]');
+}
+if (!/dist\s*=\s*"dist"/.test(trunkToml)) {
+  throw new Error('Trunk.toml must set `dist = "dist"` under [build]');
+}
+
+if (!mainRs.includes("App::new()")) {
+  throw new Error("src/main.rs must construct a Bevy `App::new()`");
+}
+if (!mainRs.includes("DefaultPlugins")) {
+  throw new Error("src/main.rs must register DefaultPlugins (or a narrower plugin group)");
+}
+if (!/fn\s+main\s*\(\s*\)/.test(mainRs)) {
+  throw new Error("src/main.rs must declare `fn main()`");
+}
+
+if (!indexHtml.includes('data-trunk')) {
+  throw new Error('index.html must include a <link data-trunk ...> directive so Trunk builds the crate');
+}
+
+console.log("bevy-web starter ok");

package/registry/families/bevy-web/manifest.json

@@ -0,0 +1,171 @@
+{
+  "id": "bevy-web",
+  "description": "Bevy game engine (Rust) targeting the browser via WebAssembly. Ships a minimal DefaultPlugins app — camera + 3D cube + rotation system — plus a Trunk.toml so `trunk serve` builds WASM, runs wasm-bindgen, and hosts the page in one command. Foundation for Bevy web games, interactive demos, and Rust-first 3D content.",
+  "tags": [
+    "frontend",
+    "rust",
+    "wasm",
+    "bevy",
+    "game-engine",
+    "3d"
+  ],
+  "taxonomy": {
+    "language": "rust",
+    "runtime": "wasm",
+    "surface": "frontend"
+  },
+  "defaults": {
+    "projectType": "frontend",
+    "crateName": "starter_foundry_bevy",
+    "port": 8080
+  },
+  "files": [
+    {
+      "source": "files/Cargo.toml",
+      "target": "Cargo.toml"
+    },
+    {
+      "source": "files/Trunk.toml",
+      "target": "Trunk.toml"
+    },
+    {
+      "source": "files/index.html",
+      "target": "index.html"
+    },
+    {
+      "source": "files/build.sh",
+      "target": "build.sh"
+    },
+    {
+      "source": "files/validate-bevy-web.mjs",
+      "target": "validate-bevy-web.mjs"
+    },
+    {
+      "source": "files/.gitignore",
+      "target": ".gitignore"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "Cargo.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": "Trunk.toml"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/main.rs"
+    },
+    {
+      "type": "file-exists",
+      "path": "index.html"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-bevy-web.mjs"
+      ],
+      "expect": "bevy-web starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "rustup target add wasm32-unknown-unknown",
+      "cargo install --locked trunk",
+      "trunk serve",
+      "trunk build --release"
+    ],
+    "entrypoints": [
+      "src/main.rs",
+      "Cargo.toml",
+      "Trunk.toml",
+      "index.html"
+    ],
+    "preview": {
+      "path": "/"
+    },
+    "extensionPoints": [
+      "src/main.rs"
+    ]
+  },
+  "keywords": [
+    "bevy",
+    "bevy web",
+    "rust web game",
+    "wasm game engine",
+    "bevy wasm",
+    "bevy engine",
+    "rust game engine",
+    "trunk bevy",
+    "bevy browser"
+  ],
+  "scoring": {
+    "boost": {
+      "bevy": 5,
+      "bevy web": 5,
+      "bevy wasm": 5,
+      "rust web game": 4,
+      "wasm game engine": 4
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "bevy",
+      "bevy web",
+      "bevy wasm",
+      "rust web game",
+      "wasm game engine"
+    ],
+    "tier2": [
+      "bevy engine",
+      "rust game engine",
+      "trunk bevy",
+      "bevy browser",
+      "ecs game rust"
+    ],
+    "archetypes": [
+      "bevy browser game",
+      "rust 3d demo",
+      "bevy jam entry",
+      "ecs tech demo",
+      "bevy shader toy",
+      "rust physics playground",
+      "wasm voxel renderer",
+      "bevy card game",
+      "rust roguelike web",
+      "bevy multiplayer demo"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Rust-first game or interactive 3D content that needs to run in a browser. Bevy gives you an ECS, rendering, input, audio, and a plugin ecosystem; Trunk handles the WASM build + asset pipeline. Pick wasm-rust instead if you only need a pure compute module with no engine.",
+    "firstSteps": [
+      "Install the toolchain once: `rustup target add wasm32-unknown-unknown` then `cargo install --locked trunk wasm-bindgen-cli`. Trunk is the standard Bevy-web build tool — it wraps wasm-bindgen + wasm-opt and serves the page.",
+      "Run: `trunk serve` — it compiles Rust to WASM, runs wasm-bindgen, writes `dist/`, and opens http://localhost:8080 with hot-reload on Rust changes.",
+      "Edit `src/main.rs` — the Bevy app adds DefaultPlugins, spawns a camera + light + rotating cube, and registers a system that rotates it. Replace the cube with your geometry and add systems/resources as the game grows.",
+      "Ship: `trunk build --release` emits `dist/` with a hashed WASM bundle, JS shim, and HTML; deploy to any static host.",
+      "For audio + advanced renderer features, enable the right Bevy features in Cargo.toml (`bevy = { version = \"0.14\", features = [\"default\"] }`); strip defaults for a smaller bundle when you only need 2D."
+    ],
+    "gotchas": [
+      "Bevy requires the `wasm32-unknown-unknown` target AND wasm-bindgen at the exact version pinned in Cargo.lock — drift gives cryptic `imported memory` link errors. Always install with `--locked`.",
+      "WebGPU backend is Chrome/Edge 113+ and Safari 18+ stable; on Firefox (stable) Bevy falls back to WebGL2. If you depend on a WebGPU-only feature (compute shaders, bindless resources), guard it and expose a fallback or gate the app.",
+      "Asset loading uses fetch() relative to the page — `bevy::asset::AssetServer` expects files under the Trunk `public_url` (set in Trunk.toml). Dropping assets next to src/ will 404.",
+      "Bevy's WASM binary is large even for small apps (~10–20 MB debug, ~3–6 MB release with wasm-opt). Always ship release builds with `wasm-opt -Oz` (Trunk does this by default).",
+      "The default Bevy logger uses ANSI escape codes — on the browser console they render as garbage. Swap in `bevy::log::LogPlugin` with `level: Level::INFO` and a custom filter for clean WASM logs.",
+      "Bevy 0.14 removed some 0.13 re-exports; if you're porting an older example, check the migration guide — API churn is real between minor versions."
+    ],
+    "architectureNotes": [
+      "One `App::new()` per process — Bevy is not reentrant. All plugins, systems, and resources attach to that single app.",
+      "Systems are stateless functions operating on queries + resources; do not hold handles across frames in locals. State belongs in `Resource`s or `Component`s.",
+      "Keep WASM-specific code under `#[cfg(target_arch = \"wasm32\")]` so the same crate still runs natively for fast iteration."
+    ],
+    "placeholders": [
+      {
+        "path": "src/main.rs",
+        "description": "Minimal Bevy app — DefaultPlugins, camera, light, rotating cube, and a system that updates rotation each frame. Replace the cube with real geometry, add input systems, swap DefaultPlugins for a narrower plugin group for smaller bundles."
+      }
+    ]
+  }
+}

package/registry/families/browser-extension-ts/files/package.json

@@ -7,6 +7,9 @@
     "validate": "node validate-types.mjs"
   },
   "devDependencies": {
-    "vite": "^6.2.0"
+    "vite": "^6.4.2",
+    "typescript": "^5.9.0",
+    "@types/chrome": "^0.0.280",
+    "@types/node": "^20.17.0"
   }
 }

package/registry/families/bun-http/files/bunfig.toml

@@ -0,0 +1,9 @@
+# Bun runtime configuration. See https://bun.sh/docs/runtime/bunfig.
+
+[install]
+# Lockfile is committed. Set to false to skip writing.
+saveTextLockfile = true
+
+[test]
+# Per-file timeout for Bun's built-in test runner.
+timeout = 5000

package/registry/families/bun-http/files/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --watch src/server.ts",
+    "start": "bun run src/server.ts",
+    "test": "bun test",
+    "validate": "node validate-bun.mjs"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.10",
+    "typescript": "^5.7.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
+  }
+}

package/registry/families/bun-http/files/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "types": ["bun"],
+    "noEmit": true,
+    "allowJs": true,
+    "jsx": "preserve",
+    "lib": ["ESNext", "DOM"]
+  },
+  "include": ["src/**/*.ts", "validate-bun.mjs"]
+}

package/registry/families/bun-http/files/validate-bun.mjs

@@ -0,0 +1,21 @@
+import fs from "node:fs/promises";
+
+const [serverSource, pkgSource] = await Promise.all([
+  fs.readFile("src/server.ts", "utf8"),
+  fs.readFile("package.json", "utf8"),
+]);
+
+const pkg = JSON.parse(pkgSource);
+if (pkg.name !== "{{packageName}}") {
+  throw new Error(`package.json name should be "{{packageName}}", got "${pkg.name}"`);
+}
+
+if (!serverSource.includes("Bun.serve") && !serverSource.includes("export default")) {
+  throw new Error("src/server.ts should export a Bun.serve-compatible config or call Bun.serve directly");
+}
+
+if (!serverSource.includes('"/health"')) {
+  throw new Error("src/server.ts missing /health route contract");
+}
+
+console.log("bun starter ok");