@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/registry/layers/capability/evm-nft-mint-page/files/src/components/MintPage.tsx

@@ -0,0 +1,38 @@
+import React, { useState, useEffect } from 'react';
+import { useWallet } from '@binance-chain/bsc-use-wallet';
+import { Link } from 'react-router-dom';
+import { MintButton } from './MintButton';
+import { MintedCountDisplay } from './MintedCountDisplay';
+import { OpenSeaLink } from './OpenSeaLink';
+
+const MintPage = () => {
+  const [mintedCount, setMintedCount] = useState(0);
+  const wallet = useWallet();
+  const contractAddress = process.env.CONTRACT_ADDRESS;
+
+  useEffect(() => {
+    const fetchMintedCount = async () => {
+      // fetch minted count from contract
+      const response = await fetch(`https://api.${contractAddress}.com/minted-count`);
+      const data = await response.json();
+      setMintedCount(data.count);
+    };
+    fetchMintedCount();
+  }, [contractAddress]);
+
+  const handleMint = async () => {
+    // mint NFT logic
+  };
+
+  return (
+    <div>
+      <h1>Mint Page</h1>
+      <MintButton onMint={handleMint} />
+      <MintedCountDisplay count={mintedCount} />
+      <OpenSeaLink contractAddress={contractAddress} />
+      {wallet.account && <p>Connected to {wallet.account}</p>}
+    </div>
+  );
+};
+
+export default MintPage;

package/registry/layers/capability/evm-nft-mint-page/files/src/mint-page-config.json

@@ -0,0 +1 @@
+{"contractAddress": "0x...", "openseaLink": "https://opensea.io/", "mintButtonLabel": "Mint NFT", "mintedCountLabel": "Minted Count: "}

package/registry/layers/capability/evm-nft-mint-page/manifest.json

@@ -0,0 +1,75 @@
+{
+  "id": "evm-nft-mint-page",
+  "description": "EVM NFT mint page component — wallet connect + mint button + minted-count display + OpenSea link. Reads contract address from env.",
+  "appliesTo": [
+    "react-vite-ts",
+    "nextjs-ts",
+    "fullstack-ts"
+  ],
+  "defaults": {
+    "contractAddress": "0x...",
+    "walletProvider": "MetaMask",
+    "openSeaApiKey": "YOUR_API_KEY"
+  },
+  "files": [
+    {
+      "source": "files/src/mint-page-config.json",
+      "target": "src/mint-page-config.json"
+    },
+    {
+      "source": "files/src/components/MintPage.tsx",
+      "target": "src/components/MintPage.tsx"
+    },
+    {
+      "source": "files/evm-nft-mint.md",
+      "target": "evm-nft-mint.md"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "wallet connection customization",
+      "mint button configuration",
+      "OpenSea link modification",
+      "contract address injection"
+    ]
+  },
+  "capabilityRequires": [
+    "wallet integration",
+    "smart contract deployment",
+    "OpenSea API access",
+    "environment variable configuration"
+  ],
+  "keywords": [
+    "EVM",
+    "NFT",
+    "minting",
+    "wallet",
+    "OpenSea",
+    "blockchain",
+    "React",
+    "Vite",
+    "Next.js",
+    "TypeScript",
+    "fullstack development"
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "EVM",
+      "NFT",
+      "minting",
+      "wallet",
+      "OpenSea"
+    ],
+    "tier2": [
+      "blockchain",
+      "React",
+      "Vite",
+      "Next.js",
+      "TypeScript",
+      "fullstack development"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "When building blockchain-based applications that require a user-friendly interface for minting NFTs, especially in scenarios where users need to connect their wallets and track minted counts."
+  }
+}

package/registry/layers/capability/evm-wallet-dashboard/manifest.json

@@ -26,5 +26,10 @@
     "multicall",
     "wallet dashboard",
     "balance dashboard"
-  ]
+  ],
+  "packageDeps": {
+    "dependencies": {
+      "viem": "^2.21.0"
+    }
+  }
 }

package/registry/layers/capability/layout-admin/manifest.json

@@ -2,23 +2,64 @@
   "id": "layout-admin",
   "description": "Pre-built admin panel with data table (TanStack), entity forms, filters, and bulk actions.",
   "group": "capability",
-  "appliesTo": ["nextjs-ts", "react-vite-ts", "fullstack-ts"],
-  "keywords": ["admin", "admin panel", "crud", "data table", "back office", "management", "content management"],
-  "capabilityRequires": ["shadcn"],
+  "appliesTo": [
+    "nextjs-ts",
+    "react-vite-ts",
+    "fullstack-ts"
+  ],
+  "keywords": [
+    "admin",
+    "admin panel",
+    "crud",
+    "data table",
+    "back office",
+    "management",
+    "content management"
+  ],
+  "capabilityRequires": [
+    "shadcn"
+  ],
   "files": [
-    { "source": "files/data-table.tsx", "target": "src/components/admin/data-table.tsx" },
-    { "source": "files/entity-form.tsx", "target": "src/components/admin/entity-form.tsx" },
-    { "source": "files/admin-page.tsx", "target": "app/admin/page.tsx" },
-    { "source": "files/admin-page.tsx", "target": "app/page.tsx" },
-    { "source": "files/admin-page.tsx", "target": "src/App.tsx" },
-    { "source": "files/column-header.tsx", "target": "src/components/admin/column-header.tsx" },
-    { "source": "files/media-manifest.json", "target": "media-manifest.json" }
+    {
+      "source": "files/data-table.tsx",
+      "target": "src/components/admin/data-table.tsx"
+    },
+    {
+      "source": "files/entity-form.tsx",
+      "target": "src/components/admin/entity-form.tsx"
+    },
+    {
+      "source": "files/admin-page.tsx",
+      "target": "app/admin/page.tsx"
+    },
+    {
+      "source": "files/column-header.tsx",
+      "target": "src/components/admin/column-header.tsx"
+    },
+    {
+      "source": "files/media-manifest.json",
+      "target": "media-manifest.json"
+    }
   ],
   "buildHints": {
-    "pages": ["/admin", "/admin/[entity]", "/admin/[entity]/[id]"],
-    "apiRoutes": ["/api/admin/[entity]"],
-    "components": ["DataTable", "EntityForm", "ColumnHeader", "BulkActionBar", "FilterBar"],
-    "integrations": ["@tanstack/react-table for headless table logic"],
+    "pages": [
+      "/admin",
+      "/admin/[entity]",
+      "/admin/[entity]/[id]"
+    ],
+    "apiRoutes": [
+      "/api/admin/[entity]"
+    ],
+    "components": [
+      "DataTable",
+      "EntityForm",
+      "ColumnHeader",
+      "BulkActionBar",
+      "FilterBar"
+    ],
+    "integrations": [
+      "@tanstack/react-table for headless table logic"
+    ],
     "architectureNotes": [
       "DataTable is powered by @tanstack/react-table with sorting, filtering, and pagination.",
       "Column definitions are typed — add your entity columns in the page file.",
@@ -26,5 +67,34 @@
       "Bulk actions bar appears when rows are selected (delete, export, etc.).",
       "Wire API routes to your database (Drizzle, Prisma, etc.)."
     ]
+  },
+  "packageDeps": {
+    "dependencies": {
+      "@tanstack/react-table": "^8.21.0"
+    }
+  },
+  "tieredKeywords": {
+    "archetypes": [
+      "onboarding tool",
+      "onboarding app",
+      "employee onboarding",
+      "vendor onboarding",
+      "approval workflow",
+      "approval flow",
+      "back office",
+      "content management",
+      "data table",
+      "crud operations",
+      "role-based",
+      "multi-step sign-off",
+      "dues collection",
+      "maintenance requests",
+      "document storage",
+      "collects documents",
+      "auto-assign",
+      "assigns tasks",
+      "hr tool",
+      "admin panel"
+    ]
   }
 }

package/registry/layers/capability/layout-auth/manifest.json

@@ -47,5 +47,17 @@
       "The two-column layout shows a branded panel on desktop, form-only on mobile.",
       "Add middleware.ts to protect routes and redirect unauthenticated users."
     ]
+  },
+  "tieredKeywords": {
+    "archetypes": [
+      "client portal",
+      "customer portal",
+      "tenant portal",
+      "accounting firm",
+      "document portal",
+      "share tax returns",
+      "patient portal",
+      "secure login"
+    ]
   }
 }

package/registry/layers/capability/layout-chat/manifest.json

@@ -2,23 +2,76 @@
   "id": "layout-chat",
   "description": "Pre-built AI chat interface with message list, streaming input, code blocks, and tool-call display.",
   "group": "capability",
-  "appliesTo": ["nextjs-ts", "react-vite-ts", "fullstack-ts", "remix-ts"],
-  "keywords": ["chat", "ai chat", "chatbot", "chat interface", "messaging", "conversation", "chat app", "chat room", "ai assistant"],
-  "capabilityRequires": ["shadcn"],
+  "appliesTo": [
+    "nextjs-ts",
+    "react-vite-ts",
+    "fullstack-ts",
+    "remix-ts"
+  ],
+  "keywords": [
+    "chat",
+    "ai chat",
+    "chatbot",
+    "chat interface",
+    "messaging",
+    "conversation",
+    "chat app",
+    "chat room",
+    "ai assistant"
+  ],
+  "capabilityRequires": [
+    "shadcn"
+  ],
   "files": [
-    { "source": "files/chat-page.tsx", "target": "app/chat/page.tsx" },
-    { "source": "files/chat-page.tsx", "target": "app/page.tsx" },
-    { "source": "files/chat-page.tsx", "target": "src/App.tsx" },
-    { "source": "files/chat-message.tsx", "target": "src/components/chat/chat-message.tsx" },
-    { "source": "files/chat-input.tsx", "target": "src/components/chat/chat-input.tsx" },
-    { "source": "files/chat-sidebar.tsx", "target": "src/components/chat/chat-sidebar.tsx" },
-    { "source": "files/media-manifest.json", "target": "media-manifest.json" }
+    {
+      "source": "files/chat-page.tsx",
+      "target": "app/chat/page.tsx"
+    },
+    {
+      "source": "files/chat-page.tsx",
+      "target": "app/page.tsx"
+    },
+    {
+      "source": "files/chat-page.tsx",
+      "target": "src/App.tsx"
+    },
+    {
+      "source": "files/chat-message.tsx",
+      "target": "src/components/chat/chat-message.tsx"
+    },
+    {
+      "source": "files/chat-input.tsx",
+      "target": "src/components/chat/chat-input.tsx"
+    },
+    {
+      "source": "files/chat-sidebar.tsx",
+      "target": "src/components/chat/chat-sidebar.tsx"
+    },
+    {
+      "source": "files/media-manifest.json",
+      "target": "media-manifest.json"
+    }
   ],
   "buildHints": {
-    "pages": ["/chat", "/chat/[id]"],
-    "apiRoutes": ["/api/chat"],
-    "components": ["ChatPage", "ChatMessage", "ChatInput", "ChatSidebar", "CodeBlock", "StreamingDots"],
-    "integrations": ["Server-Sent Events or WebSocket for streaming", "Markdown rendering via react-markdown or similar"],
+    "pages": [
+      "/chat",
+      "/chat/[id]"
+    ],
+    "apiRoutes": [
+      "/api/chat"
+    ],
+    "components": [
+      "ChatPage",
+      "ChatMessage",
+      "ChatInput",
+      "ChatSidebar",
+      "CodeBlock",
+      "StreamingDots"
+    ],
+    "integrations": [
+      "Server-Sent Events or WebSocket for streaming",
+      "Markdown rendering via react-markdown or similar"
+    ],
     "architectureNotes": [
       "Chat layout is pre-built with sidebar for conversation history and main chat area.",
       "ChatMessage renders user and assistant messages with avatar, timestamp, and markdown.",
@@ -26,5 +79,38 @@
       "Wire /api/chat to your LLM provider (OpenAI, Anthropic, etc.) with streaming response.",
       "Code blocks in assistant messages use syntax highlighting placeholder — add shiki or prism."
     ]
+  },
+  "tieredKeywords": {
+    "archetypes": [
+      "chatbot",
+      "chat bot",
+      "support bot",
+      "ai assistant",
+      "cooking assistant",
+      "shopping assistant",
+      "writing assistant",
+      "personal assistant",
+      "ai tutor",
+      "language tutor",
+      "homework help",
+      "homework helper",
+      "bedtime stor",
+      "voice companion",
+      "ai companion",
+      "symptom checker",
+      "describe what",
+      "i describe",
+      "conversations with",
+      "conversation with me",
+      "has conversations",
+      "chat with me",
+      "chats with me",
+      "texts me",
+      "explains concepts",
+      "tell it ",
+      "ask it ",
+      "tells me",
+      "tells you"
+    ]
   }
 }

package/registry/layers/capability/layout-dashboard/manifest.json

@@ -5,7 +5,6 @@
   "files": [
     { "source": "files/sidebar-layout.tsx", "target": "src/components/layout/sidebar-layout.tsx" },
     { "source": "files/dashboard-page.tsx", "target": "app/dashboard/page.tsx" },
-    { "source": "files/dashboard-page.tsx", "target": "src/App.tsx" },
     { "source": "files/nav-config.ts", "target": "src/config/nav.ts" },
     { "source": "files/media-manifest.json", "target": "media-manifest.json" }
   ],

package/registry/layers/capability/logging/manifest.json

@@ -29,19 +29,15 @@
     "json logging"
   ],
   "buildHints": {
-    "architecture": [
-      "createLogger(service) → tagged Logger instance with .withRequestId() for child loggers",
-      "requestLogger middleware → attaches logger + requestId to request context, logs method/path/status/duration on response end",
-      "errorHandler middleware → catches errors, logs stack at error level, returns sanitized JSON response in production"
-    ],
-    "middlewareChain": [
-      "requestLogger (first — sets up context)",
-      "...route handlers...",
-      "errorHandler (last — catches thrown errors)"
-    ],
-    "environmentBehavior": {
-      "development": "Human-readable log lines to stdout",
-      "production": "JSON lines to stdout/stderr, debug level suppressed, error messages sanitized"
-    }
+    "architectureNotes": [
+      "architecture: createLogger(service) \u2192 tagged Logger instance with .withRequestId() for child loggers",
+      "architecture: requestLogger middleware \u2192 attaches logger + requestId to request context, logs method/path/status/duration on response end",
+      "architecture: errorHandler middleware \u2192 catches errors, logs stack at error level, returns sanitized JSON response in production",
+      "middlewareChain: requestLogger (first \u2014 sets up context)",
+      "middlewareChain: ...route handlers...",
+      "middlewareChain: errorHandler (last \u2014 catches thrown errors)",
+      "environmentBehavior.development: Human-readable log lines to stdout",
+      "environmentBehavior.production: JSON lines to stdout/stderr, debug level suppressed, error messages sanitized"
+    ]
   }
 }

package/registry/layers/capability/multi-tenancy/manifest.json

@@ -0,0 +1,60 @@
+{
+  "id": "multi-tenancy",
+  "description": "Multi-tenancy primitives for SaaS scaffolds — tenant context resolver, middleware, and schema extension helpers.",
+  "group": "capability",
+  "appliesTo": [
+    "fullstack-ts",
+    "nextjs-ts",
+    "api-service",
+    "bun-http",
+    "cloudflare-worker-ts",
+    "python-api",
+    "rust-service",
+    "go-api",
+    "crm-backend",
+    "ecommerce-headless",
+    "k12-edtech",
+    "legal-case-mgmt"
+  ],
+  "keywords": [
+    "multi-tenant",
+    "multi tenancy",
+    "per-tenant",
+    "workspace tenant",
+    "subdomain tenant",
+    "tenant isolation"
+  ],
+  "tieredKeywords": {
+    "archetypes": [
+      "saas",
+      "saas app",
+      "saas product",
+      "saas platform",
+      "saas tool",
+      "team management",
+      "teams and members",
+      "organization",
+      "organizations",
+      "workspace",
+      "workspaces",
+      "customer accounts",
+      "customer portal",
+      "subscription tiers",
+      "subscription plans",
+      "billing plans",
+      "usage-based billing",
+      "per-seat billing",
+      "tenant",
+      "tenants",
+      "multi-tenant",
+      "multi tenancy",
+      "per-tenant",
+      "tenant isolation",
+      "workspace-level",
+      "org-level",
+      "account-scoped"
+    ]
+  },
+  "files": [],
+  "packageDeps": { "dependencies": {} }
+}

package/registry/layers/capability/passkey-onboarding/files/passkey-onboarding.md

@@ -0,0 +1,37 @@
+# Passkey Onboarding Capability
+The passkey onboarding capability provides a seamless WebAuthn passkey-based sign-in and account creation flow. It includes passkey registration UI, biometric-gated sign-in, and a recovery flow.
+
+## Overview
+This capability is designed to enhance the security and usability of authentication processes in applications. By leveraging WebAuthn standards, it enables users to securely authenticate using passkeys, which are resistant to phishing and other types of attacks.
+
+## Applies To
+The passkey onboarding capability applies to the following families:
+- nextjs-ts
+- react-vite-ts
+- kyc-onboarding
+
+## Use Cases
+- Implementing secure and user-friendly authentication flows in web applications.
+- Enhancing account creation processes with passkey registration.
+- Providing biometric-gated sign-in for an additional layer of security.
+- Offering a recovery flow for users who encounter issues during the sign-in process.
+
+## Extension Points
+- Customizing the passkey registration UI to fit specific application branding and requirements.
+- Integrating the biometric-gated sign-in with existing authentication systems.
+- Developing additional recovery flow mechanisms tailored to specific user needs.
+
+## Gotchas
+- Ensuring compatibility with various browsers and devices that support WebAuthn.
+- Handling potential issues with biometric authentication, such as false negatives or positives.
+- Implementing proper security measures to protect user passkeys and sensitive information.
+
+## Peer Capabilities
+The passkey onboarding capability can be used in conjunction with other capabilities, such as:
+- Agent Intel for AI-powered data intelligence.
+- AI Agent Dashboard for agent observability.
+- AI Agent Orchestrator for multi-agent orchestration.
+- AI Chat Sessions for managing chat conversations.
+- AI Chat UI for streaming AI chat interfaces.
+
+By combining these capabilities, developers can create comprehensive and secure applications that leverage the latest advancements in authentication, AI, and user experience.

package/registry/layers/capability/passkey-onboarding/files/src/components/PasskeyRegister.tsx

@@ -0,0 +1,25 @@
+import React, { useState } from 'react';
+            import type { NextPage } from 'next';
+            import { WebAuthnPasskey } from '@components/WebAuthnPasskey';
+
+            const PasskeyRegister: NextPage = () => {
+              const [registered, setRegistered] = useState(false);
+
+              const handleRegister = async () => {
+                // Implement passkey registration logic here
+                setRegistered(true);
+              };
+
+              return (
+                <div>
+                  <h1>Passkey Registration</h1>
+                  {registered ? (
+                    <p>Passkey registered successfully!</p>
+                  ) : (
+                    <WebAuthnPasskey onRegister={handleRegister} />
+                  )}
+                </div>
+              );
+            };
+
+            export default PasskeyRegister;

package/registry/layers/capability/passkey-onboarding/files/src/components/PasskeySignIn.tsx

@@ -0,0 +1,84 @@
+import React, { useState, useEffect } from 'react';
+import { WebAuthnPasskey } from '@webauthn/passkey';
+
+const PasskeySignIn = () => {
+  const [username, setUsername] = useState('');
+  const [password, setPassword] = useState('');
+  const [passkey, setPasskey] = useState(null);
+
+  useEffect(() => {
+    const initPasskey = async () => {
+      try {
+        const passkey = await WebAuthnPasskey.init();
+        setPasskey(passkey);
+      } catch (error) {
+        console.error(error);
+      }
+    };
+    initPasskey();
+  }, []);
+
+  const handleSignIn = async (event) => {
+    event.preventDefault();
+    try {
+      const credentials = await passkey.getCredentials();
+      const response = await fetch('/api/signin', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ username, password, credentials }),
+      });
+      const data = await response.json();
+      if (data.success) {
+        // Sign in successful, redirect to dashboard
+      } else {
+        // Handle sign in error
+      }
+    } catch (error) {
+      console.error(error);
+    }
+  };
+
+  const handleRegister = async (event) => {
+    event.preventDefault();
+    try {
+      const credentials = await passkey.createCredentials();
+      const response = await fetch('/api/register', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ username, password, credentials }),
+      });
+      const data = await response.json();
+      if (data.success) {
+        // Registration successful, redirect to dashboard
+      } else {
+        // Handle registration error
+      }
+    } catch (error) {
+      console.error(error);
+    }
+  };
+
+  return (
+    <div>
+      <h1>Passkey Sign In</h1>
+      <form onSubmit={handleSignIn}>
+        <label>
+          Username:
+          <input type="text" value={username} onChange={(event) => setUsername(event.target.value)} />
+        </label>
+        <label>
+          Password:
+          <input type="password" value={password} onChange={(event) => setPassword(event.target.value)} />
+        </label>
+        <button type="submit">Sign In</button>
+      </form>
+      <button onClick={handleRegister}>Register</button>
+    </div>
+  );
+};
+
+export default PasskeySignIn;

package/registry/layers/capability/passkey-onboarding/files/src/passkey-onboarding-config.json

@@ -0,0 +1 @@
+{"passkeyOnboardingEnabled": true, "registrationUI": {"biometricGatedSignIn": true, "recoveryFlow": true}}