@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/registry/families/deno-edge/manifest.json

@@ -0,0 +1,153 @@
+{
+  "id": "deno-edge",
+  "description": "Deno runtime HTTP API starter using Deno.serve \u2014 zero-transpile TS, secure-by-default permissions, Deno Deploy-compatible.",
+  "tags": [
+    "deno",
+    "api",
+    "backend",
+    "typescript",
+    "edge"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "deno",
+    "surface": "api"
+  },
+  "slots": {
+    "database": {
+      "options": [
+        "database:sqlite",
+        "database:postgres",
+        "database:mongodb",
+        "database:convex"
+      ],
+      "default": "database:sqlite"
+    },
+    "auth": {
+      "options": [
+        "auth:none",
+        "auth:better-auth",
+        "auth:clerk"
+      ],
+      "default": "auth:none"
+    },
+    "payments": {
+      "options": [
+        "payments:none",
+        "payments:stripe"
+      ],
+      "default": "payments:none"
+    },
+    "queue": {
+      "options": [
+        "queue:none",
+        "queue:bullmq",
+        "queue:trigger-dev"
+      ],
+      "default": "queue:none"
+    }
+  },
+  "defaults": {
+    "projectType": "api",
+    "serviceName": "starter-foundry-deno",
+    "port": 8096,
+    "databaseProvider": "sqlite"
+  },
+  "files": [
+    {
+      "source": "files/deno.json",
+      "target": "deno.json"
+    },
+    {
+      "source": "files/validate-deno.mjs",
+      "target": "validate-deno.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src/server.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "deno.json"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-deno.mjs"
+      ],
+      "expect": "deno starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "deno task dev",
+      "deno task test"
+    ],
+    "entrypoints": [
+      "src/server.ts",
+      "src/handlers.ts",
+      "deno.json"
+    ],
+    "preview": {
+      "path": "/health"
+    },
+    "extensionPoints": [
+      "database-config.json",
+      "auth-config.json",
+      "payments-config.json",
+      "queue-config.json"
+    ]
+  },
+  "keywords": [
+    "deno",
+    "deno runtime",
+    "deno.serve",
+    "deno deploy",
+    "deno edge"
+  ],
+  "scoring": {
+    "boost": {
+      "deno": 3
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "deno",
+      "deno.serve",
+      "deno runtime",
+      "deno deploy"
+    ],
+    "tier2": [
+      "deno edge",
+      "deno api"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Deno runtime HTTP server. Secure-by-default (explicit permissions), zero-transpile TS, Deno Deploy-compatible. Use when the prompt calls for Deno specifically or for edge-runtime compatibility.",
+    "firstSteps": [
+      "Run the dev server with `deno task dev` \u2014 NOT `pnpm dev` (no package.json here). Tasks live in deno.json.",
+      "Install deps by importing from URLs (https://deno.land/x/...) OR npm: specifiers (`import express from \"npm:express\"`). There is NO `node_modules` unless you opt in.",
+      "Tests: `deno task test`. Use the built-in `Deno.test` API. Do NOT add vitest/jest.",
+      "Extend `src/handlers.ts` \u2014 add routes to the `routes` map.",
+      "Env vars: `Deno.env.get('FOO')`, NOT `process.env.FOO`. Requires `--allow-env` permission."
+    ],
+    "gotchas": [
+      "Deno runs with deny-by-default permissions. `--allow-net --allow-env --allow-read` are already in deno.json tasks \u2014 add more only if the handler needs them.",
+      "npm: specifiers work but some Node libs assume `process.env` / `Buffer` / `__dirname`. Use Deno's `std/` modules first.",
+      "Deno Deploy has a 50MB deployment limit + no filesystem writes. Use Deno KV for state, not SQLite."
+    ],
+    "architectureNotes": [
+      "Deno.serve returns a Server; handlers are plain `(Request) => Response` \u2014 portable to Cloudflare Workers / Bun.",
+      "Prefer import maps in deno.json over inline URL imports for consistency across files."
+    ],
+    "placeholders": [
+      {
+        "path": "src/handlers.ts",
+        "description": "Default routes map with just `/health`. Add the product's endpoints here \u2014 handlers are `(Request) => Response`."
+      }
+    ]
+  }
+}

package/registry/families/ecommerce-headless/files/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "node --watch --experimental-strip-types src/server.ts",
+    "start": "node --experimental-strip-types src/server.ts",
+    "validate": "node validate-commerce.mjs",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate"
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.36.0",
+    "postgres": "^3.4.5",
+    "stripe": "^17.0.0"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.30.0",
+    "typescript": "^5.9.0",
+    "@types/node": "^20.17.0"
+  },
+  "overrides": { "vite": "^6.4.2" },
+  "pnpm": { "overrides": { "vite": "^6.4.2" } }
+}

package/registry/families/ecommerce-headless/files/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/registry/families/ecommerce-headless/files/validate-commerce.mjs

@@ -0,0 +1,37 @@
+import fs from "node:fs/promises";
+import { stripTypeScriptTypes } from "node:module";
+
+const paths = [
+  "src/server.ts",
+  "src/db/schema.ts",
+  "src/api/cart.ts",
+  "src/api/checkout.ts",
+  "src/webhooks/stripe.ts",
+];
+const sources = await Promise.all(paths.map((p) => fs.readFile(p, "utf8")));
+for (const s of sources) stripTypeScriptTypes(s);
+const [server, schema, cart, checkout, webhook] = sources;
+
+const required = ["products", "variants", "carts", "lineItems", "orders", "payments", "webhookEvents"];
+for (const t of required) {
+  if (!schema.includes(t)) throw new Error(`schema.ts missing table: ${t}`);
+}
+
+if (!checkout.includes("paymentIntent") && !checkout.includes("PaymentIntent")) {
+  throw new Error("checkout.ts must use Stripe PaymentIntent flow");
+}
+
+if (!webhook.includes("constructEvent") && !webhook.includes("signature")) {
+  throw new Error("stripe.ts webhook must verify the signature (stripe.webhooks.constructEvent)");
+}
+
+if (!webhook.includes("webhookEvents") && !webhook.includes("idempot")) {
+  throw new Error("stripe.ts webhook must be idempotent via webhookEvents table");
+}
+
+if (!server.includes('/health')) {
+  throw new Error("server.ts missing /health route");
+}
+
+JSON.parse(await fs.readFile("package.json", "utf8"));
+console.log("commerce starter ok");

package/registry/families/ecommerce-headless/manifest.json

@@ -0,0 +1,68 @@
+{
+  "id": "ecommerce-headless",
+  "description": "Headless commerce API — products / variants / carts / orders / payments / webhook events (idempotency-keyed), Stripe payment-intent checkout flow with signature-verified webhooks.",
+  "tags": ["ecommerce", "commerce", "api", "typescript"],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "node",
+    "surface": "api"
+  },
+  "slots": {
+    "database": { "options": ["database:sqlite", "database:postgres"], "default": "database:postgres" },
+    "auth": { "options": ["auth:none", "auth:better-auth", "auth:clerk"], "default": "auth:better-auth" },
+    "payments": { "options": ["payments:stripe"], "default": "payments:stripe" }
+  },
+  "defaults": {
+    "projectType": "api",
+    "serviceName": "starter-foundry-commerce",
+    "port": 8105,
+    "databaseProvider": "postgres",
+    "baseCurrency": "USD"
+  },
+  "files": [
+    { "source": "files/package.json", "target": "package.json" },
+    { "source": "files/tsconfig.json", "target": "tsconfig.json" },
+    { "source": "files/validate-commerce.mjs", "target": "validate-commerce.mjs" }
+  ],
+  "validationChecks": [
+    { "type": "file-exists", "path": "src/server.ts" },
+    { "type": "file-exists", "path": "src/db/schema.ts" },
+    { "type": "file-exists", "path": "src/api/cart.ts" },
+    { "type": "file-exists", "path": "src/api/checkout.ts" },
+    { "type": "file-exists", "path": "src/webhooks/stripe.ts" },
+    { "type": "command-success", "command": ["node", "validate-commerce.mjs"], "expect": "commerce starter ok" }
+  ],
+  "contextHints": {
+    "commands": ["pnpm install", "pnpm dev", "pnpm drizzle-kit generate", "pnpm drizzle-kit migrate"],
+    "entrypoints": ["src/server.ts", "src/db/schema.ts", "src/api/cart.ts", "src/api/checkout.ts", "src/webhooks/stripe.ts"],
+    "preview": { "path": "/health" },
+    "extensionPoints": ["src/db/schema.ts", "src/api/", "src/webhooks/"]
+  },
+  "keywords": [
+    "headless commerce",
+    "ecommerce backend",
+    "e-commerce backend",
+    "cart api",
+    "checkout api",
+    "product catalog",
+    "order management",
+    "shopify alternative",
+    "medusa alternative",
+    "commerce api",
+    "stripe checkout"
+  ],
+  "scoring": { "boost": { "ecommerce": 4, "commerce": 3 } },
+  "tieredKeywords": {
+    "tier1": [
+      "headless commerce",
+      "ecommerce backend",
+      "e-commerce backend",
+      "cart api",
+      "checkout api",
+      "product catalog",
+      "order management",
+      "commerce api"
+    ],
+    "tier2": ["shopify alternative", "medusa alternative", "stripe checkout", "product variants", "storefront api"]
+  }
+}

package/registry/families/electron-desktop-ts/files/package.json

@@ -8,6 +8,16 @@
     "validate": "node validate-types.mjs"
   },
   "devDependencies": {
-    "electron": "^36.0.0"
+    "electron": "^36.0.0",
+    "typescript": "^5.9.0",
+    "@types/node": "^20.17.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
   }
 }

package/registry/families/electron-native-os/files/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "main": "dist/main/index.cjs",
+  "scripts": {
+    "dev": "electron .",
+    "preview:instant": "node preview-server.mjs",
+    "validate": "node validate-types.mjs"
+  },
+  "dependencies": {
+    "electron-log": "^5.2.0",
+    "electron-updater": "^6.3.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^4.7.0",
+    "electron": "^36.0.0",
+    "electron-builder": "^25.0.0",
+    "typescript": "^5.9.0",
+    "vite": "^6.4.2"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
+  }
+}

package/registry/families/electron-native-os/files/preview-server.mjs

@@ -0,0 +1,34 @@
+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",
+  ".svg": "image/svg+xml"
+};
+
+const server = http.createServer(async (request, response) => {
+  const requestPath = request.url === "/" ? "/src/renderer/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/electron-native-os/files/validate-types.mjs

@@ -0,0 +1,39 @@
+import fs from "node:fs/promises";
+import { stripTypeScriptTypes } from "node:module";
+
+const files = [
+  "src/main/index.ts",
+  "src/main/menu.ts",
+  "src/main/protocol.ts",
+  "src/main/deeplinks.ts",
+  "src/main/updater.ts",
+  "src/preload/index.ts",
+  "src/renderer/App.tsx",
+  "src/renderer/main.tsx",
+];
+
+for (const file of files) {
+  const source = await fs.readFile(file, "utf8");
+  stripTypeScriptTypes(source);
+}
+
+JSON.parse(await fs.readFile("tsconfig.json", "utf8"));
+JSON.parse(await fs.readFile("electron-builder.json", "utf8"));
+
+// Assert the deep-link plumbing actually exists — catches partial templates.
+const main = await fs.readFile("src/main/index.ts", "utf8");
+if (!main.includes("requestSingleInstanceLock")) {
+  throw new Error("src/main/index.ts must acquire the single-instance lock (needed for Windows deep-link routing)");
+}
+
+const deeplinks = await fs.readFile("src/main/deeplinks.ts", "utf8");
+if (!deeplinks.includes("open-url") || !deeplinks.includes("second-instance")) {
+  throw new Error("src/main/deeplinks.ts must handle both macOS open-url and Win/Linux second-instance events");
+}
+
+const protocol = await fs.readFile("src/main/protocol.ts", "utf8");
+if (!protocol.includes("registerSchemesAsPrivileged") && !protocol.includes("registerFileProtocol") && !protocol.includes("handle")) {
+  throw new Error("src/main/protocol.ts must register a custom app:// protocol");
+}
+
+console.log("electron native os ok");

package/registry/families/electron-native-os/manifest.json

@@ -0,0 +1,200 @@
+{
+  "id": "electron-native-os",
+  "description": "Electron app with aggressive native-OS integration — file dialogs, notifications, custom protocols, deep links, auto-updater, Touch Bar / JumpList, platform menus.",
+  "tags": [
+    "desktop",
+    "electron",
+    "native-os",
+    "typescript"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "electron",
+    "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": 4198,
+    "headline": "Starter Foundry Native Desktop",
+    "subheadline": "An Electron shell wired deep into the host OS — dialogs, protocols, deep links, notifications, and auto-update."
+  },
+  "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/main/index.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/main/menu.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/main/protocol.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/main/deeplinks.ts"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-types.mjs"
+      ],
+      "expect": "electron native os ok"
+    },
+    {
+      "type": "http-start",
+      "command": [
+        "node",
+        "preview-server.mjs"
+      ],
+      "path": "/",
+      "expect": "{{headline}}"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "pnpm install",
+      "node preview-server.mjs",
+      "pnpm dev"
+    ],
+    "entrypoints": [
+      "src/main/index.ts",
+      "src/main/menu.ts",
+      "src/main/protocol.ts",
+      "src/main/deeplinks.ts",
+      "src/preload/index.ts",
+      "src/renderer/index.html",
+      "src/renderer/App.tsx"
+    ],
+    "preview": {
+      "path": "/"
+    },
+    "extensionPoints": [
+      "auth-config.json",
+      "payments-config.json",
+      "sdk-config.json"
+    ]
+  },
+  "keywords": [
+    "native os integration",
+    "electron native",
+    "file system integration",
+    "deep links desktop",
+    "custom protocol handler",
+    "os notifications desktop",
+    "touch bar app",
+    "jumplist",
+    "auto updater electron",
+    "electron dialog",
+    "native menu"
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "native os integration",
+      "electron native",
+      "custom protocol handler",
+      "deep links desktop",
+      "os notifications desktop",
+      "auto updater electron"
+    ],
+    "tier2": [
+      "file system integration",
+      "touch bar app",
+      "jumplist",
+      "electron dialog",
+      "native menu",
+      "protocol handler",
+      "open with default app"
+    ],
+    "tier3": [
+      "desktop app with file access",
+      "url scheme",
+      "deep link"
+    ],
+    "archetypes": [
+      "deeply native electron",
+      "file-handling desktop app",
+      "url-scheme-registered desktop app"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Pick electron-native-os when the app is a first-class citizen of the host OS — it registers a custom `app://` protocol, handles `myapp://` deep links from the browser, opens native file dialogs, fires rich OS notifications, shows a Touch Bar on macOS and JumpList on Windows, and auto-updates via electron-updater. If the user just needs a generic Electron renderer, use electron-desktop-ts — this family pulls in more wiring than a simple renderer shell needs.",
+    "architectureNotes": [
+      "src/main/index.ts is the orchestrator — it imports menu.ts / protocol.ts / deeplinks.ts / updater.ts and boots them in the right order (protocol handler MUST register before app.whenReady()).",
+      "src/main/menu.ts branches on process.platform to install the macOS app menu (with `about`, `services`, `hide`) and the Windows/Linux menu separately — macOS menus are built into the menu-bar, not the window.",
+      "src/main/protocol.ts registers `app://` for loading local assets AND declares `{{packageName}}://` in the `protocols` electron-builder block for OS-wide deep links.",
+      "src/main/deeplinks.ts handles `second-instance` (Windows/Linux single-instance lock) and `open-url` (macOS) events and forwards the URL to the renderer via IPC.",
+      "src/preload/index.ts exposes a minimal contextBridge API — NEVER enable nodeIntegration in the renderer.",
+      "Renderer is React + Vite; it talks to main only through the preload's typed bridge."
+    ],
+    "components": [
+      "Native file open/save dialogs via dialog.showOpenDialog / dialog.showSaveDialog, invoked over IPC.",
+      "Rich notifications via the Notification class with actions (macOS supports reply + action buttons).",
+      "Touch Bar (macOS) — TouchBarButton + TouchBarScrubber wired to renderer commands.",
+      "JumpList (Windows) — recent documents + tasks via app.setJumpList.",
+      "Custom `app://` protocol for serving renderer assets in production (CSP-safe).",
+      "Deep-link handler (macOS open-url, Win/Linux single-instance argv sniff).",
+      "Auto-updater via electron-updater wired to GitHub Releases."
+    ],
+    "gotchas": [
+      "macOS notarization: the auto-updater silently fails on unsigned / unnotarized builds. Ship with `afterSign` script calling `electron-notarize` — or users get 'app is damaged' errors.",
+      "Windows deep links: you MUST `app.setAsDefaultProtocolClient('myapp')` AND declare the protocol in electron-builder's `protocols` array, otherwise the URL scheme is registered but never routed.",
+      "Windows deep links require the single-instance lock (`app.requestSingleInstanceLock()`) — without it, clicking a `myapp://` URL launches a second copy instead of routing to the running one.",
+      "macOS `open-url` fires BEFORE `app.whenReady()` on cold launch. Cache the URL and replay after ready, otherwise deep links lose their payload on first invocation.",
+      "Custom protocol (`app://`) registered via `protocol.registerFileProtocol` must be called AFTER `app.whenReady()` but BEFORE any BrowserWindow loads — mis-order and the renderer hits 'file not found'.",
+      "Notifications require Info.plist entries on macOS (`NSUserNotificationsUsageDescription`) and a valid app identity — unsigned dev builds show 'Notification delivery failed' in console without surfacing to the user.",
+      "Auto-updater: electron-updater needs `publish` config in package.json/electron-builder.yml AND the `GH_TOKEN` env var on the CI build machine. Missing either produces silent no-op updates.",
+      "contextIsolation is ON by default in modern Electron — any renderer code that expects `window.require` will throw. Always expose via contextBridge.exposeInMainWorld.",
+      "Touch Bar and JumpList are platform-gated — guard with `process.platform === 'darwin'` / `'win32'` or you crash on the other OS."
+    ],
+    "integrations": [
+      "electron-updater — GitHub Releases auto-update channel",
+      "electron-builder — signing, notarization, protocol registration",
+      "electron-log — main-process logging that survives crashes"
+    ]
+  }
+}

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"
+    }
+  }
+}