[#36] Farcaster mini app manifest & SDK setup

lib/farcaster-detect.ts

@@ -0,0 +1,14 @@
+/**
+ * Detect whether we are running inside a Farcaster Mini App context.
+ * Safe to call on server (returns false) and outside Farcaster (returns false).
+ */
+export async function isFarcasterMiniApp(): Promise<boolean> {
+  if (typeof window === "undefined") return false;
+  try {
+    const { sdk } = await import("@farcaster/miniapp-sdk");
+    const ctx = await sdk.context;
+    return !!ctx;
+  } catch {
+    return false;
+  }
+}

lib/wagmi.ts

@@ -1,11 +1,11 @@
 import { http, createConfig } from "wagmi";
 import { base, baseSepolia } from "wagmi/chains";
 import { injected } from "wagmi/connectors";
-import { farcaster } from "./farcaster-connector";
+import { farcasterMiniApp } from "@farcaster/miniapp-wagmi-connector";
 
 export const config = createConfig({
   chains: [base, baseSepolia],
-  connectors: [farcaster(), injected()],
+  connectors: [farcasterMiniApp(), injected()],
   transports: {
     [base.id]: http(
       process.env.NEXT_PUBLIC_CHAIN_ID === "8453"

package.json

@@ -16,6 +16,7 @@
   "dependencies": {
     "@aws-sdk/client-s3": "^3.1009.0",
     "@farcaster/miniapp-sdk": "^0.2.3",
+    "@farcaster/miniapp-wagmi-connector": "^1.1.1",
     "@supabase/supabase-js": "^2.99.1",
     "@tanstack/react-query": "^5.90.21",
     "next": "16.1.6",

public/.well-known/farcaster.json

@@ -0,0 +1,18 @@
+{
+  "accountAssociation": {
+    "header": "",
+    "payload": "",
+    "signature": ""
+  },
+  "miniapp": {
+    "version": "1",
+    "name": "PlotLink",
+    "iconUrl": "https://plotlink.xyz/icon.png",
+    "homeUrl": "https://plotlink.xyz",
+    "splashBackgroundColor": "#0a0a0a",
+    "description": "Tokenise your story from day 1. Publish plots, drive trading, earn royalties from every trade.",
+    "primaryCategory": "entertainment",
+    "tags": ["stories", "writing", "onchain", "base"],
+    "requiredChains": ["eip155:8453"]
+  }
+}

src/components/ConnectWallet.tsx

@@ -2,7 +2,7 @@
 
 import { useEffect, useRef, useState } from "react";
 import { useAccount, useConnect, useDisconnect } from "wagmi";
-import { isFarcasterMiniApp } from "../../lib/farcaster-connector";
+import { isFarcasterMiniApp } from "../../lib/farcaster-detect";
 import { truncateAddress } from "../../lib/utils";
 import { useConnectedIdentity } from "../hooks/useConnectedIdentity";
 
@@ -25,7 +25,7 @@ export function ConnectWallet() {
     if (autoConnectAttempted.current || isConnected) return;
     autoConnectAttempted.current = true;
 
-    const farcasterConnector = connectors.find((c) => c.type === "farcaster");
+    const farcasterConnector = connectors.find((c) => c.type === "farcasterMiniApp");
     if (!farcasterConnector) return;
 
     farcasterConnector.isAuthorized().then((authorized) => {
@@ -66,7 +66,7 @@ export function ConnectWallet() {
       onClick={() => {
         // Use Farcaster connector only when confirmed inside a mini app
         const farcasterConnector = inMiniApp
-          ? connectors.find((c) => c.type === "farcaster")
+          ? connectors.find((c) => c.type === "farcasterMiniApp")
           : undefined;
         const fallback = connectors.find((c) => c.type === "injected");
         const connector = farcasterConnector ?? fallback;