@tangle-network/starter-foundry 0.5.3 → 0.7.0

package/registry/families/expo-rn-rich/manifest.json

@@ -0,0 +1,181 @@
+{
+  "id": "expo-rn-rich",
+  "description": "Expo React Native app with the rich client-side native stack — Skia canvas, Reanimated v3 worklets, Gesture Handler, React Navigation stack + tabs.",
+  "tags": [
+    "mobile",
+    "react-native",
+    "expo",
+    "skia",
+    "reanimated",
+    "typescript"
+  ],
+  "taxonomy": {
+    "language": "typescript",
+    "runtime": "expo",
+    "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": "mobile",
+    "headline": "Starter Foundry Rich Mobile",
+    "subheadline": "An Expo shell with Skia, Reanimated, Gesture Handler, and navigation — ready for GPU-rich UI."
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/validate-expo-rn-rich.mjs",
+      "target": "validate-expo-rn-rich.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "App.tsx"
+    },
+    {
+      "type": "file-exists",
+      "path": "app.json"
+    },
+    {
+      "type": "file-exists",
+      "path": "babel.config.js"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-expo-rn-rich.mjs"
+      ],
+      "expect": "expo rn rich ok"
+    }
+  ],
+  "contextHints": {
+    "commands": [
+      "pnpm install",
+      "npx expo start",
+      "node validate-expo-rn-rich.mjs"
+    ],
+    "entrypoints": [
+      "App.tsx",
+      "app.json",
+      "babel.config.js",
+      "src/screens/HomeScreen.tsx",
+      "src/screens/CanvasScreen.tsx",
+      "src/navigation/RootNavigator.tsx"
+    ],
+    "preview": null,
+    "extensionPoints": [
+      "auth-config.json",
+      "payments-config.json",
+      "sdk-config.json"
+    ]
+  },
+  "keywords": [
+    "skia",
+    "react native skia",
+    "reanimated",
+    "rich animations mobile",
+    "native gestures mobile",
+    "expo skia",
+    "expo reanimated",
+    "react navigation",
+    "gesture handler",
+    "gpu mobile",
+    "animated mobile ui"
+  ],
+  "tieredKeywords": {
+    "tier1": [
+      "skia",
+      "react native skia",
+      "reanimated",
+      "rich animations mobile",
+      "native gestures mobile",
+      "expo skia",
+      "expo reanimated"
+    ],
+    "tier2": [
+      "react navigation",
+      "gesture handler",
+      "animated mobile ui",
+      "gpu mobile canvas",
+      "60fps mobile animations",
+      "shared element transitions",
+      "interactive mobile charts"
+    ],
+    "tier3": [
+      "animated ios app",
+      "animated android app",
+      "fluid mobile ui"
+    ],
+    "archetypes": [
+      "rich-animations mobile app",
+      "skia canvas mobile app",
+      "reanimated gesture-driven mobile"
+    ]
+  },
+  "buildHints": {
+    "whenToUse": "Pick expo-rn-rich when the app needs GPU-backed 2D drawing (Skia), worklet-driven 60fps animations (Reanimated v3), native gesture composition (Gesture Handler), and stack+tab navigation (React Navigation). If the user just needs a plain React Native shell without the animation stack, use expo-react-native-ts — this family pulls in ~15MB of extra native deps that need a dev client build.",
+    "architectureNotes": [
+      "Reanimated v3 requires its Babel plugin to be the LAST plugin in babel.config.js — misordering silently breaks worklets with a 'Reanimated 2 failed to create a worklet' runtime error.",
+      "Gesture Handler's GestureHandlerRootView MUST wrap the entire app tree (in App.tsx), not just individual screens, or nested gestures drop events on Android.",
+      "@shopify/react-native-skia ships its own native module — it WILL NOT run inside Expo Go. The project requires a dev client (`eas build --profile development`) or `expo prebuild` to generate ios/android folders.",
+      "React Navigation uses screens from react-native-screens under the hood — enable via `enableScreens()` before the navigator renders for 30–40% lower memory on large stacks.",
+      "Screens go under src/screens/, navigators under src/navigation/. Keeping them split lets agents add new screens without rewriting the root."
+    ],
+    "components": [
+      "RootNavigator — a Native Stack with a Bottom Tabs nested inside.",
+      "HomeScreen — plain RN list to contrast with the canvas screen.",
+      "CanvasScreen — a Skia <Canvas> driving an animated shader/shape via useSharedValue + useDerivedValue.",
+      "GestureHandlerRootView wrapper at the app root.",
+      "SafeAreaProvider wrapping the navigator for notched devices."
+    ],
+    "gotchas": [
+      "Expo Go INCOMPATIBILITY: Skia + Reanimated v3 require a custom dev client. Document in README — users who run `npx expo start` and scan the QR with Expo Go will see 'Native module RNReanimated is not installed'.",
+      "Reanimated babel plugin order: `react-native-reanimated/plugin` MUST be the LAST entry in plugins array. This is the #1 Reanimated crash and the error message does not surface the cause.",
+      "iOS: Add 'NSCameraUsageDescription' / 'NSMicrophoneUsageDescription' to app.json → ios.infoPlist if any Skia shader loads a camera feed — iOS will silently crash the app on access without it.",
+      "Android: The `android.useLegacyPackaging` flag in app.json is needed for hermes-compatible Reanimated — without it the APK balloons by ~20MB.",
+      "`react-native-gesture-handler` must be imported at the TOP of the entry file (index.ts/App.tsx) — any imports BEFORE it will initialize without gesture handler patched in and fire warnings in production.",
+      "React Navigation v7 requires `@react-navigation/native`, `@react-navigation/native-stack`, and `@react-navigation/bottom-tabs` as separate installs. Missing one silently breaks the tab bar.",
+      "Worklet constraints: code inside `useAnimatedStyle` / `useAnimatedReaction` runs on the UI thread and cannot close over JS-thread variables unless marked with `'worklet'`. Mis-use shows up as 'ReferenceError: X is not defined' on interaction.",
+      "EAS Build: Reanimated + Skia push the build past Expo's free-tier 45-minute build limit on first run — set `cache.key` in eas.json to cache the native pods, or upgrade to a paid tier."
+    ],
+    "integrations": [
+      "@shopify/react-native-skia — GPU-backed 2D canvas",
+      "react-native-reanimated v3 — UI-thread animations + worklets",
+      "react-native-gesture-handler — native gesture composition",
+      "@react-navigation/native + native-stack + bottom-tabs — typed navigation",
+      "react-native-safe-area-context — notch/home-indicator insets",
+      "react-native-screens — native screen containers (memory win)"
+    ]
+  }
+}

package/registry/families/fhenix-contracts/files/package.json

@@ -11,6 +11,6 @@
     "@nomicfoundation/hardhat-toolbox": "^5.0.0",
     "@cofhe/hardhat-plugin": "latest",
     "@fhenixprotocol/cofhe-contracts": "latest",
-    "cofhejs": "^0.4.1"
+    "cofhejs": "^0.3.1"
   }
 }

package/registry/families/fhevm-contracts/files/package.json

@@ -9,7 +9,7 @@
   "devDependencies": {
     "hardhat": "^2.22.0",
     "@nomicfoundation/hardhat-toolbox": "^5.0.0",
-    "@fhevm/solidity": "^0.6.2",
+    "@fhevm/solidity": "^0.11.1",
     "@fhevm/hardhat-plugin": "latest",
     "@fhevm-sdk/core": "^0.1.6"
   }

package/registry/families/fintech-ledger-backend/files/package.json

@@ -0,0 +1,30 @@
+{
+  "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-fintech.mjs",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate"
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.36.0",
+    "postgres": "^3.4.5",
+    "decimal.js": "^10.4.3"
+  },
+  "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/fintech-ledger-backend/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/fintech-ledger-backend/files/validate-fintech.mjs

@@ -0,0 +1,43 @@
+import fs from "node:fs/promises";
+import { stripTypeScriptTypes } from "node:module";
+
+const paths = [
+  "src/server.ts",
+  "src/db/schema.ts",
+  "src/ledger/post.ts",
+  "src/ledger/query.ts",
+];
+const sources = await Promise.all(paths.map((p) => fs.readFile(p, "utf8")));
+for (const s of sources) stripTypeScriptTypes(s);
+const [server, schema, post, query] = sources;
+
+if (!schema.includes("accounts") || !schema.includes("entries") || !schema.includes("transactions")) {
+  throw new Error("schema.ts missing required tables (accounts, transactions, entries)");
+}
+
+if (!schema.includes("numeric") && !schema.includes("NUMERIC")) {
+  throw new Error("schema.ts amounts MUST use numeric (not real/float) — float destroys cents");
+}
+
+if (/\bfloat\b|\bdouble\b|\breal\b/i.test(schema)) {
+  throw new Error("schema.ts appears to use float/double/real for money — that's a data-integrity bug");
+}
+
+if (!post.includes("Decimal") && !post.includes("decimal.js")) {
+  throw new Error("post.ts must use decimal.js for amount arithmetic — never JavaScript numbers");
+}
+
+if (!/debit\s*[+=]|debits|sum.*debit/i.test(post) || !/credit/i.test(post)) {
+  throw new Error("post.ts must enforce debit = credit balance per transaction");
+}
+
+if (!query.includes("balance") && !query.includes("Balance")) {
+  throw new Error("query.ts missing balance function");
+}
+
+if (!server.includes('/health')) {
+  throw new Error("server.ts missing /health route");
+}
+
+JSON.parse(await fs.readFile("package.json", "utf8"));
+console.log("ledger starter ok");

package/registry/families/fintech-ledger-backend/manifest.json

@@ -0,0 +1,138 @@
+{
+  "id": "fintech-ledger-backend",
+  "description": "Double-entry ledger API — accounts / transactions / entries schema, decimal-safe money, atomic post_transaction with debit=credit invariant.",
+  "tags": [
+    "fintech",
+    "ledger",
+    "accounting",
+    "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"
+    }
+  },
+  "defaults": {
+    "projectType": "api",
+    "serviceName": "starter-foundry-ledger",
+    "port": 8101,
+    "databaseProvider": "postgres",
+    "baseCurrency": "USD"
+  },
+  "files": [
+    {
+      "source": "files/package.json",
+      "target": "package.json"
+    },
+    {
+      "source": "files/tsconfig.json",
+      "target": "tsconfig.json"
+    },
+    {
+      "source": "files/validate-fintech.mjs",
+      "target": "validate-fintech.mjs"
+    }
+  ],
+  "validationChecks": [
+    {
+      "type": "file-exists",
+      "path": "src/server.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/db/schema.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/ledger/post.ts"
+    },
+    {
+      "type": "file-exists",
+      "path": "src/ledger/query.ts"
+    },
+    {
+      "type": "command-success",
+      "command": [
+        "node",
+        "validate-fintech.mjs"
+      ],
+      "expect": "ledger 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/ledger/post.ts",
+      "src/ledger/query.ts"
+    ],
+    "preview": {
+      "path": "/health"
+    },
+    "extensionPoints": [
+      "src/db/schema.ts",
+      "src/ledger/",
+      "src/api/"
+    ]
+  },
+  "keywords": [
+    "ledger",
+    "double entry",
+    "double-entry",
+    "fintech accounting",
+    "financial backend",
+    "transaction ledger",
+    "debit credit",
+    "accounting api",
+    "general ledger",
+    "chart of accounts",
+    "ledger api"
+  ],
+  "scoring": {
+    "boost": {
+      "ledger": 4,
+      "fintech": 3
+    }
+  },
+  "tieredKeywords": {
+    "tier1": [
+      "ledger",
+      "double entry",
+      "double-entry",
+      "transaction ledger",
+      "debit credit",
+      "general ledger",
+      "ledger api"
+    ],
+    "tier2": [
+      "fintech accounting",
+      "financial backend",
+      "accounting api",
+      "chart of accounts"
+    ]
+  }
+}

package/registry/families/flutter-app/files/analysis_options.yaml

@@ -0,0 +1,17 @@
+include: package:flutter_lints/flutter.yaml
+
+analyzer:
+  language:
+    strict-casts: true
+    strict-inference: true
+    strict-raw-types: true
+  errors:
+    invalid_annotation_target: ignore
+
+linter:
+  rules:
+    - prefer_const_constructors
+    - prefer_const_literals_to_create_immutables
+    - prefer_final_locals
+    - avoid_print
+    - require_trailing_commas

package/registry/families/flutter-app/files/android/app/build.gradle

@@ -0,0 +1,38 @@
+plugins {
+    id "com.android.application"
+    id "kotlin-android"
+    id "dev.flutter.flutter-gradle-plugin"
+}
+
+android {
+    namespace "com.starterfoundry.{{packageName}}"
+    compileSdk 34
+    ndkVersion flutter.ndkVersion
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+
+    defaultConfig {
+        applicationId "com.starterfoundry.{{packageName}}"
+        minSdk 23
+        targetSdk 34
+        versionCode flutterVersionCode.toInteger()
+        versionName flutterVersionName
+    }
+
+    buildTypes {
+        release {
+            signingConfig signingConfigs.debug
+        }
+    }
+}
+
+flutter {
+    source "../.."
+}

package/registry/families/flutter-app/files/ios/Runner/Info.plist

@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleDisplayName</key>
+	<string>{{projectName}}</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>{{packageName}}</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>$(FLUTTER_BUILD_NAME)</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>$(FLUTTER_BUILD_NUMBER)</string>
+	<key>LSRequiresIPhoneOS</key>
+	<true/>
+	<key>UILaunchStoryboardName</key>
+	<string>LaunchScreen</string>
+	<key>UIMainStoryboardFile</key>
+	<string>Main</string>
+	<key>UIApplicationSupportsIndirectInputEvents</key>
+	<true/>
+	<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>UISupportedInterfaceOrientations~ipad</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+		<string>UIInterfaceOrientationPortraitUpsideDown</string>
+		<string>UIInterfaceOrientationLandscapeLeft</string>
+		<string>UIInterfaceOrientationLandscapeRight</string>
+	</array>
+	<key>CADisableMinimumFrameDurationOnPhone</key>
+	<true/>
+</dict>
+</plist>

package/registry/families/flutter-app/files/pubspec.yaml

@@ -0,0 +1,24 @@
+name: {{packageName}}
+description: {{subheadline}}
+publish_to: 'none'
+version: 1.0.0+1
+
+environment:
+  sdk: ^3.5.0
+  flutter: ">=3.24.0"
+
+dependencies:
+  flutter:
+    sdk: flutter
+  cupertino_icons: ^1.0.8
+  go_router: ^14.6.2
+  provider: ^6.1.2
+  dio: ^5.7.0
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^5.0.0
+
+flutter:
+  uses-material-design: true

package/registry/families/flutter-app/files/validate-flutter.mjs

@@ -0,0 +1,43 @@
+// Structural validator for the flutter-app starter. Does NOT run `flutter
+// analyze` (that requires the Flutter SDK which scaffold validation runs
+// without). Confirms entry files exist and reference each other correctly.
+
+import fs from "node:fs/promises";
+
+const [pubspec, mainDart, analysis] = await Promise.all([
+  fs.readFile("pubspec.yaml", "utf8"),
+  fs.readFile("lib/main.dart", "utf8"),
+  fs.readFile("analysis_options.yaml", "utf8"),
+]);
+
+if (!pubspec.includes("flutter:\n    sdk: flutter")) {
+  throw new Error("pubspec.yaml must declare flutter SDK dependency");
+}
+if (!pubspec.includes("go_router:")) {
+  throw new Error("pubspec.yaml must depend on go_router");
+}
+if (!pubspec.includes("provider:")) {
+  throw new Error("pubspec.yaml must depend on provider");
+}
+if (!pubspec.includes("dio:")) {
+  throw new Error("pubspec.yaml must depend on dio");
+}
+
+if (!mainDart.includes("MaterialApp.router")) {
+  throw new Error("lib/main.dart must bootstrap MaterialApp.router for GoRouter integration");
+}
+if (!mainDart.includes("GoRouter(")) {
+  throw new Error("lib/main.dart must instantiate a GoRouter");
+}
+if (!mainDart.includes("ChangeNotifierProvider") && !mainDart.includes("MultiProvider")) {
+  throw new Error("lib/main.dart must wire a Provider / ChangeNotifierProvider at the root");
+}
+if (!mainDart.includes("void main()")) {
+  throw new Error("lib/main.dart must define a `void main()` entrypoint");
+}
+
+if (!analysis.includes("flutter_lints")) {
+  throw new Error("analysis_options.yaml must include flutter_lints");
+}
+
+console.log("flutter starter ok");