@tangle-network/starter-foundry 0.5.4 → 0.7.0

package/registry/families/multimodal-agent/files/vite.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    port: {{port}},
+    proxy: {
+      '/api': {
+        target: 'http://localhost:8787',
+        changeOrigin: true,
+      },
+    },
+  },
+})

package/registry/families/multimodal-agent/manifest.json

@@ -0,0 +1,143 @@
+{
+  "id": "multimodal-agent",
+  "description": "React + Vite multimodal client — three concurrent inputs (text prompt, dropped image, recorded audio) are packed into a single multipart POST to /api/multimodal, and the multimodal LLM's streamed response renders back in the composer. For building GPT-4o/Claude/Gemini multimodal clients without picking a vendor SDK.",
+  "tags": [
+    "multimodal",
+    "react",
+    "vite",
+    "agent",
+    "frontend",
+    "typescript"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "browser",
+    "surface": "frontend"
+  },
+  "defaults": {
+    "projectType": "frontend",
+    "serviceName": "starter-foundry-multimodal",
+    "port": 4182,
+    "headline": "One message, three modalities",
+    "subheadline": "Drop an image, record 3 seconds of audio, type your question. Send — the multimodal LLM sees all three."
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/tsconfig.json",
+      "target": "tsconfig.json"
+    },
+    {
+      "source": "files/vite.config.ts",
+      "target": "vite.config.ts"
+    },
+    {
+      "source": "files/index.html",
+      "target": "index.html"
+    },
+    {
+      "source": "files/validate-multimodal.mjs",
+      "target": "validate-multimodal.mjs"
+    },
+    {
+      "source": "files/api/README.md",
+      "target": "api/README.md"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src/main.tsx"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/App.tsx"
+    },
+    {
+      "type": "file-exists",
+      "path": "index.html"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-multimodal.mjs"
+      ],
+      "expect": "multimodal-agent starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "pnpm install",
+      "pnpm run dev"
+    ],
+    "entrypoints": [
+      "src/App.tsx",
+      "src/main.tsx",
+      "index.html",
+      "api/README.md"
+    ],
+    "preview": {
+      "path": "/"
+    },
+    "extensionPoints": [
+      "src/App.tsx",
+      "api/"
+    ]
+  },
+  "keywords": [
+    "multimodal agent",
+    "multimodal chat",
+    "text image audio",
+    "gpt-4o client",
+    "claude vision voice",
+    "multimodal input",
+    "multimodal composer",
+    "multimodal ui",
+    "multimodal llm client",
+    "multimodal frontend"
+  ],
+  "scoring": {
+    "boost": {
+      "multimodal": 4,
+      "multimodal agent": 4,
+      "gpt-4o": 3
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "multimodal agent",
+      "multimodal chat",
+      "multimodal composer",
+      "text image audio"
+    ],
+    "tier2": [
+      "gpt-4o client",
+      "claude vision voice",
+      "multimodal input",
+      "multimodal llm client",
+      "multimodal ui"
+    ],
+    "archetypes": [
+      "point camera ask record chatbot",
+      "multi-input assistant",
+      "image plus voice chat",
+      "drag drop image to llm",
+      "gpt4o playground",
+      "claude vision audio demo"
+    ]
+  },
+  "buildHints": {
+    "gotchas": [
+      "multipart/form-data is the only format all three big multimodal APIs accept without re-encoding. Don't wrap image + audio in a JSON body — base64 + UTF-8 overhead bloats payloads and breaks streaming.",
+      "React 19 Strict Mode runs effects twice in dev — if you kick off getUserMedia inside useEffect without a cleanup, the second call races the first and you get NotReadableError. Always return a cleanup that stops the tracks.",
+      "Dropped files trigger both `dragover` and `drop` — you MUST preventDefault on dragover or the browser will navigate to the file instead of firing your drop handler.",
+      "Recording audio AND previewing an image AND typing text in the same component means three independent state machines. Keep them in separate useState hooks — one merged state object leads to stale-closure bugs.",
+      "The <audio>/<video> preview elements need `URL.revokeObjectURL` when the user re-records or removes the file, else Chrome leaks ~50MB per blob until GC eventually fires.",
+      "Safari's DataTransferItemList only exposes files synchronously inside the drop handler. If you await anything before reading `e.dataTransfer.files`, the list is already cleared."
+    ]
+  }
+}

package/registry/families/nextjs-ts/files/package.json

@@ -13,20 +13,28 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.468.0",
-    "next": "^15.2.0",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "next": "^16.0.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
     "tailwind-merge": "^2.6.0",
     "@tanstack/react-table": "latest",
     "recharts": "latest"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "latest",
-    "@types/node": "^20.0.0",
-    "@types/react": "latest",
-    "@types/react-dom": "latest",
+    "@types/node": "^20.17.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
     "postcss": "^8.4.49",
     "tailwindcss": "latest",
-    "typescript": "^5.7.0"
+    "typescript": "^5.9.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
   }
 }

package/registry/families/nextjs-ts/manifest.json

@@ -257,5 +257,40 @@
       "swagger",
       "openapi"
     ]
+  },
+  "buildHints": {
+    "whenToUse": "Next.js App Router for full-stack React products that need SEO, server-rendered routes, and a Node backend surface in one project. Chooses server-components by default; opt out per-route with `use client`.",
+    "firstSteps": [
+      "Install: `pnpm install` then `pnpm dev`. Next 16.x uses the App Router \u2014 files under `app/` are routes, files under `components/` are imported.",
+      "Brand strings live in `personalize.json` (at repo root OR src/). Compose writes it as the single source of truth \u2014 edit once, HMR picks up.",
+      "Color palette + Tailwind tokens live in `src/personalize.css` / `app/personalize.css`. Edit HSL custom properties on `:root` + `.dark`; Tailwind v4 `@theme` defaults already compose in.",
+      "shadcn/ui components pre-installed under `src/components/ui/` \u2014 import from `@/components/ui/button`, etc. Path alias `@/` \u2192 `src/`."
+    ],
+    "gotchas": [
+      "App Router is default. If you find yourself writing a pages/ directory, stop \u2014 you're in the wrong mental model for this scaffold.",
+      "Server Components are the default \u2014 every component is SSR unless marked `'use client'`. If a component uses hooks or browser APIs, add the directive at the top."
+    ],
+    "placeholders": [
+      {
+        "path": "app/dashboard/page.tsx",
+        "description": "Default renders generic KPI cards (Total Revenue $45k, Active Users 2,350, etc.). Replace with the product's primary dashboard view \u2014 remove KPI cards that don't apply, add ones that do."
+      },
+      {
+        "path": "app/admin/page.tsx",
+        "description": "Default renders a generic user table. Replace with the product's admin/management surface, or delete the route if no admin surface is needed."
+      },
+      {
+        "path": "app/page.tsx",
+        "description": "Landing / root page with placeholder hero copy. Rewrite the hero content for the product; keep layout shell."
+      },
+      {
+        "path": "app/layout.tsx",
+        "description": "Root layout + metadata. Update `metadata.title` and `metadata.description` for SEO \u2014 and review whether the default `<body>` structure fits the product."
+      },
+      {
+        "path": "personalize.json",
+        "description": "Brand strings (name, tagline, hero headline/subheadline). Edit for the product \u2014 but this is NOT a substitute for rewriting the placeholders above."
+      }
+    ]
   }
 }

package/registry/families/nextjs-ts/prompt-fragment.md

@@ -0,0 +1,12 @@
+<!-- Per-family prompt fragment. Consumers read ComposeResult.promptFragment
+     and splice this into their system prompt. Distinct from AGENTS.md
+     which is agent-turn-1 reading; this is identity/invariants that belong
+     at the system-prompt level. -->
+
+You are working on a Next.js 16 App Router project scaffolded by starter-foundry.
+
+Invariants for this stack:
+- App Router only. Do not create `pages/`. Server Components are default; add `'use client'` only where interactivity requires it.
+- Brand + product copy is centralized in `personalize.json` (render-time templated into served HTML + layout metadata). Editing it is a one-line change agents sometimes miss when writing feature code.
+- Tailwind v4 with `@theme` defaults composed in. shadcn/ui primitives are pre-installed under `src/components/ui/`. Import via the `@/` alias.
+- The `app/dashboard/page.tsx` you find is a scaffold default, not a product contract. Replace it before first preview; the user sees this surface.

package/registry/families/observable-notebook/files/index.md

@@ -0,0 +1,23 @@
+---
+title: {{headline}}
+toc: false
+---
+
+# {{headline}}
+
+{{subheadline}}
+
+```js
+const series = Array.from({ length: 30 }, (_, i) => ({
+  day: i,
+  value: Math.sin(i / 3) * 50 + 60 + i
+}));
+```
+
+```js
+Plot.plot({
+  marks: [Plot.line(series, { x: 'day', y: 'value' })]
+})
+```
+
+See [Overview](./overview) for a data-loader example.

package/registry/families/observable-notebook/files/observablehq.config.ts

@@ -0,0 +1,15 @@
+import type { Config } from '@observablehq/framework'
+
+const config: Config = {
+  title: '{{headline}}',
+  root: 'src',
+  output: 'dist',
+  theme: 'default',
+  pages: [
+    { name: 'Home', path: '/' },
+    { name: 'Overview', path: '/overview' },
+  ],
+  footer: '{{subheadline}}',
+}
+
+export default config

package/registry/families/observable-notebook/files/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "clean": "rm -rf dist .observablehq/cache",
+    "dev": "observable preview --port {{port}}",
+    "build": "observable build",
+    "deploy": "observable deploy",
+    "validate": "node validate-observable.mjs"
+  },
+  "dependencies": {
+    "@observablehq/framework": "^1.13.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "overrides": {
+    "vite": "^6.4.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "vite": "^6.4.2"
+    }
+  }
+}

package/registry/families/observable-notebook/files/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": []
+  },
+  "include": ["observablehq.config.ts", "src/**/*.ts", "src/**/*.tsx"]
+}

package/registry/families/observable-notebook/files/validate-observable.mjs

@@ -0,0 +1,24 @@
+import { existsSync, readFileSync } from 'node:fs'
+
+const must = (cond, msg) => {
+  if (!cond) {
+    console.error(`validate-observable: ${msg}`)
+    process.exit(1)
+  }
+}
+
+must(existsSync('observablehq.config.ts'), 'missing observablehq.config.ts')
+must(existsSync('src/index.md'), 'missing src/index.md')
+must(existsSync('src/overview.md'), 'missing src/overview.md')
+
+const cfg = readFileSync('observablehq.config.ts', 'utf8')
+must(/root:\s*['"]src['"]/.test(cfg), 'observablehq.config.ts must set root: "src"')
+must(/output:\s*['"]dist['"]/.test(cfg), 'observablehq.config.ts must set output: "dist"')
+
+const pkg = JSON.parse(readFileSync('package.json', 'utf8'))
+must(pkg.dependencies?.['@observablehq/framework'], 'package.json must depend on @observablehq/framework')
+
+const home = readFileSync('src/index.md', 'utf8')
+must(/^---/m.test(home), 'src/index.md must have YAML frontmatter')
+
+console.log('observable starter ok')

package/registry/families/observable-notebook/manifest.json

@@ -0,0 +1,110 @@
+{
+  "id": "observable-notebook",
+  "description": "Observable Framework starter — reactive data-app SSG that renders Markdown with JavaScript data loaders into a static site, no server runtime in production.",
+  "tags": [
+    "observable",
+    "observable-framework",
+    "data-app",
+    "notebook",
+    "frontend"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "node",
+    "surface": "frontend"
+  },
+  "defaults": {
+    "projectType": "frontend",
+    "serviceName": "starter-foundry-observable",
+    "port": 3000,
+    "headline": "Starter Foundry Observable",
+    "subheadline": "Reactive data dashboards with Observable Framework.",
+    "databaseProvider": "none"
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/observablehq.config.ts",
+      "target": "observablehq.config.ts"
+    },
+    {
+      "source": "files/tsconfig.json",
+      "target": "tsconfig.json"
+    },
+    {
+      "source": "files/index.md",
+      "target": "src/index.md"
+    },
+    {
+      "source": "files/validate-observable.mjs",
+      "target": "validate-observable.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "observablehq.config.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/index.md"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-observable.mjs"
+      ],
+      "expect": "observable starter ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "npm install",
+      "npm run dev",
+      "npm run build"
+    ],
+    "entrypoints": [
+      "observablehq.config.ts",
+      "src/index.md",
+      "src/overview.md"
+    ],
+    "preview": {
+      "port": "{{port}}",
+      "path": "/"
+    },
+    "extensionPoints": [
+      "starter-data.json",
+      "starter-brand.json"
+    ]
+  },
+  "keywords": [
+    "observable",
+    "observable framework",
+    "observablehq",
+    "observable notebook",
+    "reactive dashboard",
+    "data loader"
+  ],
+  "scoring": {
+    "boost": {
+      "observable": 3,
+      "observablehq": 3
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "observable framework",
+      "observablehq",
+      "observable notebook"
+    ],
+    "tier2": [
+      "observable",
+      "reactive dashboard",
+      "data loader"
+    ]
+  }
+}

package/registry/families/ollama-server/files/Modelfile

@@ -0,0 +1,10 @@
+FROM llama3.2
+
+SYSTEM """
+You are a helpful assistant scaffolded by starter-foundry.
+Replace this system prompt with the product's actual persona + constraints before shipping.
+"""
+
+PARAMETER temperature 0.7
+PARAMETER top_p 0.9
+PARAMETER num_ctx 8192

package/registry/families/ollama-server/files/README.md

@@ -0,0 +1,32 @@
+# {{serviceName}} — Ollama self-hosted LLM
+
+Local-first inference powered by Ollama (llama.cpp under the hood). OpenAI-style `/api/generate` and `/api/chat` endpoints on port 11434.
+
+## Quickstart
+
+```sh
+docker compose up -d
+docker compose exec ollama ollama pull llama3.2
+pnpm install
+pnpm dev
+```
+
+## Customize the model
+
+Edit `Modelfile`, then:
+
+```sh
+docker compose exec ollama ollama create my-model -f /root/.ollama/Modelfile
+```
+
+Mount the Modelfile into the container if you want `ollama create` to pick it up automatically.
+
+## Endpoints
+
+- `GET /api/tags` — list loaded models
+- `POST /api/generate` — non-streaming or newline-delimited JSON stream
+- `POST /api/chat` — multi-turn chat with role messages
+
+## GPU
+
+Uncomment the `deploy.resources` block in `docker-compose.yml`, install `nvidia-container-toolkit` on the host, and restart.

package/registry/families/ollama-server/files/docker-compose.yml

@@ -0,0 +1,23 @@
+services:
+  ollama:
+    image: ollama/ollama:latest
+    container_name: {{serviceName}}
+    restart: unless-stopped
+    ports:
+      - "11434:11434"
+    volumes:
+      - ollama:/root/.ollama
+    environment:
+      - OLLAMA_KEEP_ALIVE=5m
+      - OLLAMA_NUM_PARALLEL=1
+    # Uncomment for CUDA GPU inference (requires nvidia-container-toolkit on host):
+    # deploy:
+    #   resources:
+    #     reservations:
+    #       devices:
+    #         - driver: nvidia
+    #           count: all
+    #           capabilities: [gpu]
+
+volumes:
+  ollama:

package/registry/families/ollama-server/files/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "{{packageName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/client.ts",
+    "typecheck": "tsc --noEmit",
+    "validate": "node validate-ollama.mjs"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.0"
+  }
+}

package/registry/families/ollama-server/files/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "lib": ["ES2022"]
+  },
+  "include": ["src"]
+}

package/registry/families/ollama-server/files/validate-ollama.mjs

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { readFileSync, existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = dirname(fileURLToPath(import.meta.url))
+
+for (const rel of ['docker-compose.yml', 'Modelfile', 'README.md', 'package.json', 'src/client.ts']) {
+  if (!existsSync(join(here, rel))) throw new Error(`missing ${rel}`)
+}
+
+const compose = readFileSync(join(here, 'docker-compose.yml'), 'utf8')
+if (!compose.includes('ollama/ollama')) throw new Error('docker-compose.yml does not reference ollama/ollama image')
+if (!compose.includes('11434')) throw new Error('docker-compose.yml does not expose port 11434')
+
+const pkg = JSON.parse(readFileSync(join(here, 'package.json'), 'utf8'))
+if (!pkg.devDependencies?.tsx) throw new Error('tsx not in devDependencies')
+
+console.log('ollama starter ok')