fix: update protocol guild donation addresses to latest

Merge pull request #30 from vaibhavmule/fix/add-pigment-css-react-dependency
fix: add @pigment-css/react as dependency
2025-12-16 06:12:31 -05:00 · 2025-12-01 09:01:00 -08:00 · 2025-12-01 10:49:46 -06:00 · 2025-11-30 13:01:09 +05:30 · 2025-10-29 17:16:48 -07:00 · 2025-10-13 14:50:57 -07:00
31 changed files with 2372 additions and 1746 deletions
--- a/.env.example
+++ b/.env.example
@@ -4,8 +4,3 @@ KV_REST_API_TOKEN=''
 KV_REST_API_URL=''
 NEXT_PUBLIC_URL='http://localhost:3000'
 NEXTAUTH_URL='http://localhost:3000'
-
-NEXTAUTH_SECRET=""
-NEYNAR_API_KEY=""
-NEYNAR_CLIENT_ID=""
-USE_TUNNEL="false"
--- a/.eslintrc.json
+++ b/.eslintrc.json
@@ -1,3 +1,32 @@
 {
-  "extends": ["next/core-web-vitals", "next/typescript"]
+  "extends": ["next/core-web-vitals", "next/typescript"],
+  "rules": {
+    // Disable img warnings since you're using them intentionally in specific contexts
+    "@next/next/no-img-element": "off",
+
+    // Allow @ts-ignore comments (though @ts-expect-error is preferred)
+    "@typescript-eslint/ban-ts-comment": "off",
+
+    // Allow explicit any types (sometimes necessary for dynamic imports and APIs)
+    "@typescript-eslint/no-explicit-any": "off",
+
+    // Allow unused variables that start with underscore
+    "@typescript-eslint/no-unused-vars": [
+      "warn",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_",
+        "caughtErrorsIgnorePattern": "^_"
+      }
+    ],
+
+    // Make display name warnings instead of errors for dynamic components
+    "react/display-name": "warn",
+
+    // Allow module assignment for dynamic imports
+    "@next/next/no-assign-module-variable": "warn",
+
+    // Make exhaustive deps a warning instead of error for complex hooks
+    "react-hooks/exhaustive-deps": "warn"
+  }
 }
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,30 @@
+name: Publish to npm 🚀
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - package.json
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Publish to npm
+        run: npm publish --access public 
--- a/bin/index.js
+++ b/bin/index.js
@@ -6,6 +6,11 @@ import { init } from './init.js';
 const args = process.argv.slice(2);
 let projectName = null;
 let autoAcceptDefaults = false;
+let apiKey = null;
+let noWallet = false;
+let sponsoredSigner = false;
+let seedPhrase = null;
+let returnUrl = null;

 // Check for -y flag
 const yIndex = args.indexOf('-y');
@@ -14,18 +19,82 @@ if (yIndex !== -1) {
  args.splice(yIndex, 1); // Remove -y from args
 }

-// If there's a remaining argument, it's the project name
-if (args.length > 0) {
-  projectName = args[0];
-}
+  // Parse other arguments
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
    
-// If -y is used without project name, we still need to ask for project name
+    if (arg === '-p' || arg === '--project') {
+      if (i + 1 < args.length) {
+        projectName = args[i + 1];
+        if (projectName.startsWith('-')) {
+          console.error('Error: Project name cannot start with a dash (-)');
+          process.exit(1);
+        }
+        args.splice(i, 2); // Remove both the flag and its value
+        i--; // Adjust index since we removed 2 elements
+      } else {
+        console.error('Error: -p/--project requires a project name');
+        process.exit(1);
+      }
+    } else if (arg === '-k' || arg === '--api-key') {
+      if (i + 1 < args.length) {
+        apiKey = args[i + 1];
+        if (apiKey.startsWith('-')) {
+          console.error('Error: API key cannot start with a dash (-)');
+          process.exit(1);
+        }
+        args.splice(i, 2); // Remove both the flag and its value
+        i--; // Adjust index since we removed 2 elements
+      } else {
+        console.error('Error: -k/--api-key requires an API key');
+        process.exit(1);
+      }
+    } else if (arg === '--no-wallet') {
+      noWallet = true;
+      args.splice(i, 1); // Remove the flag
+      i--; // Adjust index since we removed 1 element
+    } else if (arg === '--sponsored-signer') {
+      sponsoredSigner = true;
+      args.splice(i, 1); // Remove the flag
+      i--; // Adjust index since we removed 1 element
+    } else if (arg === '--seed-phrase') {
+      if (i + 1 < args.length) {
+        seedPhrase = args[i + 1];
+        if (seedPhrase.startsWith('-')) {
+          console.error('Error: Seed phrase cannot start with a dash (-)');
+          process.exit(1);
+        }
+        args.splice(i, 2); // Remove both the flag and its value
+        i--; // Adjust index since we removed 2 elements
+      } else {
+        console.error('Error: --seed-phrase requires a seed phrase');
+        process.exit(1);
+      }
+    } else if (arg === '-r' || arg === '--return-url') {
+      if (i + 1 < args.length) {
+        returnUrl = args[i + 1];
+        if (returnUrl.startsWith('-')) {
+          console.error('Error: Return URL cannot start with a dash (-)');
+          process.exit(1);
+        }
+        args.splice(i, 2); // Remove both the flag and its value
+        i--; // Adjust index since we removed 2 elements
+      } else {
+        console.error('Error: -r/--return-url requires a return URL');
+        process.exit(1);
+      }
+    }
+  }
+
+
+
+// Validate that if -y is used, a project name must be provided
 if (autoAcceptDefaults && !projectName) {
-  // We'll handle this case in the init function by asking only for project name
-  autoAcceptDefaults = false;
+  console.error('Error: -y flag requires a project name. Use -p/--project to specify the project name.');
+  process.exit(1);
 }

-init(projectName, autoAcceptDefaults).catch((err) => {
+init(projectName, autoAcceptDefaults, apiKey, noWallet, sponsoredSigner, seedPhrase, returnUrl).catch((err) => {
  console.error('Error:', err);
  process.exit(1);
 });
--- a/bin/init.js
+++ b/bin/init.js
@@ -63,7 +63,15 @@ async function queryNeynarApp(apiKey) {
 }

 // Export the main CLI function for programmatic use
-export async function init(projectName = null, autoAcceptDefaults = false) {
+export async function init(
+  projectName = null,
+  autoAcceptDefaults = false,
+  apiKey = null,
+  noWallet = false,
+  sponsoredSigner = false,
+  seedPhrase = null,
+  returnUrl = null
+) {
  printWelcomeMessage();

  // Ask about Neynar usage
@@ -101,9 +109,15 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
      break;
    }

+    // Use provided API key if available, otherwise prompt for it
+    if (apiKey) {
+      neynarApiKey = apiKey;
+    } else {
+      if (!autoAcceptDefaults) {
        console.log(
          '\n🪐 Find your Neynar API key at: https://dev.neynar.com/app\n'
        );
+      }

      let neynarKeyAnswer;
      if (autoAcceptDefaults) {
@@ -149,6 +163,7 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
          neynarApiKey = 'FARCASTER_V2_FRAMES_DEMO';
        }
      }
+    }

    if (!neynarApiKey) {
      if (autoAcceptDefaults) {
@@ -212,17 +227,33 @@ export async function init(projectName = null, autoAcceptDefaults = false) {

  let answers;
  if (autoAcceptDefaults) {
+    // Handle SIWN logic for autoAcceptDefaults
+    let seedPhraseValue = null;
+    let useSponsoredSignerValue = false;
+    
+    // Only set seed phrase and sponsored signer if explicitly provided via flags
+    if (seedPhrase) {
+      // Validate the provided seed phrase
+      if (!seedPhrase || seedPhrase.trim().split(' ').length < 12) {
+        console.error('Error: Seed phrase must be at least 12 words');
+        process.exit(1);
+      }
+      seedPhraseValue = seedPhrase;
+      // If sponsoredSigner flag is provided, enable it; otherwise default to false
+      useSponsoredSignerValue = sponsoredSigner;
+    }
+    
    answers = {
      projectName: projectName || defaultMiniAppName || 'my-farcaster-mini-app',
      description: 'A Farcaster mini app created with Neynar',
      primaryCategory: null,
      tags: [],
      buttonText: 'Launch Mini App',
-      useWallet: true,
-      useTunnel: true,
+      useWallet: !noWallet,
      enableAnalytics: true,
-      seedPhrase: null,
-      sponsorSigner: false,
+      seedPhrase: seedPhraseValue,
+      useSponsoredSigner: useSponsoredSignerValue,
+      returnUrl: returnUrl,
    };
  } else {
    // If autoAcceptDefaults is false but we have a projectName, we still need to ask for other options
@@ -305,7 +336,10 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
    // Merge project name from the first prompt
    answers.projectName = projectNamePrompt.projectName;

-    // Ask about wallet and transaction tooling
+    // Ask about wallet and transaction tooling (skip if --no-wallet flag is used)
+    if (noWallet) {
+      answers.useWallet = false;
+    } else {
      const walletAnswer = await inquirer.prompt([
        {
          type: 'confirm',
@@ -323,20 +357,64 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
        },
      ]);
      answers.useWallet = walletAnswer.useWallet;
+    }

-    // Ask about localhost vs tunnel
-    const hostingAnswer = await inquirer.prompt([
+    // Ask about Sign In With Neynar (SIWN) - requires seed phrase
+    if (seedPhrase) {
+      // If --seed-phrase flag is used, validate it
+      if (!seedPhrase || seedPhrase.trim().split(' ').length < 12) {
+        console.error('Error: Seed phrase must be at least 12 words');
+        process.exit(1);
+      }
+      answers.seedPhrase = seedPhrase;
+      // If --sponsored-signer flag is also provided, enable it
+      answers.useSponsoredSigner = sponsoredSigner;
+    } else {
+      const siwnAnswer = await inquirer.prompt([
        {
          type: 'confirm',
-        name: 'useTunnel',
+          name: 'useSIWN',
          message:
-          'Would you like to test on mobile and/or test the app with Warpcast developer tools?\n' +
-          `⚠️ ${yellow}${italic}Both mobile testing and the Warpcast debugger require setting up a tunnel to serve your app from localhost to the broader internet.\n${reset}` +
-          'Configure a tunnel for mobile testing and/or Warpcast developer tools?',
-        default: true,
+            'Would you like to enable Sign In With Neynar (SIWN)? This allows your mini app to write data to Farcaster on behalf of users.\n' +
+            '\n⚠️ A seed phrase is required for this option.\n',
+          default: false,
        },
      ]);
-    answers.useTunnel = hostingAnswer.useTunnel;
+      
+      if (siwnAnswer.useSIWN) {
+        const { seedPhrase } = await inquirer.prompt([
+          {
+            type: 'password',
+            name: 'seedPhrase',
+            message: 'Enter your Farcaster custody account seed phrase (required for SIWN):',
+            validate: (input) => {
+              if (!input || input.trim().split(' ').length < 12) {
+                return 'Seed phrase must be at least 12 words';
+              }
+              return true;
+            },
+          },
+        ]);
+        answers.seedPhrase = seedPhrase;
+        
+        // Ask about sponsor signer if seed phrase is provided
+        const { sponsorSigner } = await inquirer.prompt([
+          {
+            type: 'confirm',
+            name: 'sponsorSigner',
+            message:
+              'You have provided a seed phrase, which enables Sign In With Neynar (SIWN).\n' +
+              'Do you want to sponsor the signer? (This will be used in Sign In With Neynar)\n' +
+              'Note: If you choose to sponsor the signer, Neynar will sponsor it for you and you will be charged in CUs.\n' +
+              'For more information, see https://docs.neynar.com/docs/two-ways-to-sponsor-a-farcaster-signer-via-neynar#sponsor-signers',
+            default: false,
+          },
+        ]);
+        answers.useSponsoredSigner = sponsorSigner;
+      } else {
+        answers.useSponsoredSigner = false;
+      }
+    }

    // Ask about analytics opt-out
    const analyticsAnswer = await inquirer.prompt([
@@ -409,14 +487,16 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
  delete packageJson.devDependencies;

  // Add dependencies
+  // question: remove auth-client?
  packageJson.dependencies = {
    '@farcaster/auth-client': '>=0.3.0 <1.0.0',
-    '@farcaster/auth-kit': '>=0.6.0 <1.0.0',
    '@farcaster/miniapp-node': '>=0.1.5 <1.0.0',
    '@farcaster/miniapp-sdk': '>=0.1.6 <1.0.0',
    '@farcaster/miniapp-wagmi-connector': '^1.0.0',
    '@farcaster/mini-app-solana': '>=0.0.17 <1.0.0',
-    '@neynar/react': '^1.2.5',
+    '@farcaster/quick-auth': '>=0.0.7 <1.0.0',
+    '@neynar/react': '^1.2.15',
+    '@pigment-css/react': '^0.0.30',
    '@radix-ui/react-label': '^2.1.1',
    '@solana/wallet-adapter-react': '^0.15.38',
    '@tanstack/react-query': '^5.61.0',
@@ -427,7 +507,6 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
    'lucide-react': '^0.469.0',
    mipd: '^0.0.7',
    next: '^15',
-    'next-auth': '^4.24.11',
    react: '^19',
    'react-dom': '^19',
    'tailwind-merge': '^2.6.0',
@@ -439,18 +518,21 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
  };

  packageJson.devDependencies = {
-    '@types/node': '^20',
-    '@types/react': '^19',
-    '@types/react-dom': '^19',
-    '@vercel/sdk': '^1.9.0',
-    crypto: '^1.0.1',
-    eslint: '^8',
-    'eslint-config-next': '15.0.3',
-    localtunnel: '^2.0.2',
-    'pino-pretty': '^13.0.0',
-    postcss: '^8',
-    tailwindcss: '^3.4.1',
-    typescript: '^5',
+    "@types/inquirer": "^9.0.8",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@vercel/sdk": "^1.9.0",
+    "crypto": "^1.0.1",
+    "eslint": "^8",
+    "eslint-config-next": "15.0.3",
+    "inquirer": "^10.2.2",
+    "pino-pretty": "^13.0.0",
+    "postcss": "^8",
+    "tailwindcss": "^3.4.1",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.20.5",
+    "typescript": "^5"
  };

  // Add Neynar SDK if selected
@@ -458,6 +540,44 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
    packageJson.dependencies['@neynar/nodejs-sdk'] = '^2.19.0';
  }

+  // Add auth-kit and next-auth dependencies if SIWN is enabled (seed phrase is present)
+  if (answers.seedPhrase) {
+    packageJson.dependencies['@farcaster/auth-kit'] = '>=0.6.0 <1.0.0';
+    packageJson.dependencies['next-auth'] = '^4.24.11';
+  }
+
+  // Add security overrides for vulnerable packages (compatible with npm, Yarn, and pnpm)
+  const securityOverrides = {
+    "backslash": "0.2.0",
+    "chalk-template": "1.1.0", 
+    "supports-hyperlinks": "4.1.0",
+    "has-ansi": "6.0.0",
+    "simple-swizzle": "0.2.2",
+    "color-string": "2.1.0",
+    "error-ex": "1.3.2",
+    "color-name": "2.0.0",
+    "is-arrayish": "0.3.2",
+    "slice-ansi": "7.1.0",
+    "color-convert": "3.1.0",
+    "wrap-ansi": "9.0.0",
+    "ansi-regex": "6.2.0",
+    "supports-color": "10.2.0",
+    "strip-ansi": "7.1.0",
+    "chalk": "5.6.0",
+    "ansi-styles": "6.2.1"
+  };
+
+  // npm v8.3+ overrides
+  packageJson.overrides = securityOverrides;
+  
+  // Yarn (v1 and Berry) resolutions
+  packageJson.resolutions = securityOverrides;
+  
+  // pnpm overrides (namespaced)
+  packageJson.pnpm = {
+    overrides: securityOverrides
+  };
+
  fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));

  // Handle .env file
@@ -501,26 +621,27 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
        return content;
      };

-      // Regex patterns that match whole lines with export const
+      // Regex patterns that match whole lines with export const (with TypeScript types)
      const patterns = {
-        APP_NAME: /^export const APP_NAME\s*=\s*['"`][^'"`]*['"`];$/m,
+        APP_NAME: /^export const APP_NAME\s*:\s*string\s*=\s*['"`][^'"`]*['"`];$/m,
        APP_DESCRIPTION:
-          /^export const APP_DESCRIPTION\s*=\s*['"`][^'"`]*['"`];$/m,
+          /^export const APP_DESCRIPTION\s*:\s*string\s*=\s*['"`][^'"`]*['"`];$/m,
        APP_PRIMARY_CATEGORY:
-          /^export const APP_PRIMARY_CATEGORY\s*=\s*['"`][^'"`]*['"`];$/m,
-        APP_TAGS: /^export const APP_TAGS\s*=\s*\[[^\]]*\];$/m,
+          /^export const APP_PRIMARY_CATEGORY\s*:\s*string\s*=\s*['"`][^'"`]*['"`];$/m,
+        APP_TAGS: /^export const APP_TAGS\s*:\s*string\[\]\s*=\s*\[[^\]]*\];$/m,
        APP_BUTTON_TEXT:
-          /^export const APP_BUTTON_TEXT\s*=\s*['"`][^'"`]*['"`];$/m,
-        USE_WALLET: /^export const USE_WALLET\s*=\s*(true|false);$/m,
+          /^export const APP_BUTTON_TEXT\s*:\s*string\s*=\s*['"`][^'"`]*['"`];$/m,
+        USE_WALLET: /^export const USE_WALLET\s*:\s*boolean\s*=\s*(true|false);$/m,
        ANALYTICS_ENABLED:
-          /^export const ANALYTICS_ENABLED\s*=\s*(true|false);$/m,
+          /^export const ANALYTICS_ENABLED\s*:\s*boolean\s*=\s*(true|false);$/m,
+        RETURN_URL: /^export const RETURN_URL\s*:\s*string\s*\|\s*undefined\s*=\s*(undefined|['"`][^'"`]*['"`]);$/m,
      };

      // Update APP_NAME
      constantsContent = safeReplace(
        constantsContent,
        patterns.APP_NAME,
-        `export const APP_NAME = '${escapeString(answers.projectName)}';`,
+        `export const APP_NAME: string = '${escapeString(answers.projectName)}';`,
        'APP_NAME'
      );

@@ -528,7 +649,7 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
      constantsContent = safeReplace(
        constantsContent,
        patterns.APP_DESCRIPTION,
-        `export const APP_DESCRIPTION = '${escapeString(
+        `export const APP_DESCRIPTION: string = '${escapeString(
          answers.description
        )}';`,
        'APP_DESCRIPTION'
@@ -538,7 +659,7 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
      constantsContent = safeReplace(
        constantsContent,
        patterns.APP_PRIMARY_CATEGORY,
-        `export const APP_PRIMARY_CATEGORY = '${escapeString(
+        `export const APP_PRIMARY_CATEGORY: string = '${escapeString(
          answers.primaryCategory || ''
        )}';`,
        'APP_PRIMARY_CATEGORY'
@@ -552,7 +673,7 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
      constantsContent = safeReplace(
        constantsContent,
        patterns.APP_TAGS,
-        `export const APP_TAGS = ${tagsString};`,
+        `export const APP_TAGS: string[] = ${tagsString};`,
        'APP_TAGS'
      );

@@ -560,7 +681,7 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
      constantsContent = safeReplace(
        constantsContent,
        patterns.APP_BUTTON_TEXT,
-        `export const APP_BUTTON_TEXT = '${escapeString(
+        `export const APP_BUTTON_TEXT: string = '${escapeString(
          answers.buttonText || ''
        )}';`,
        'APP_BUTTON_TEXT'
@@ -570,7 +691,7 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
      constantsContent = safeReplace(
        constantsContent,
        patterns.USE_WALLET,
-        `export const USE_WALLET = ${answers.useWallet};`,
+        `export const USE_WALLET: boolean = ${answers.useWallet};`,
        'USE_WALLET'
      );

@@ -578,19 +699,25 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
      constantsContent = safeReplace(
        constantsContent,
        patterns.ANALYTICS_ENABLED,
-        `export const ANALYTICS_ENABLED = ${answers.enableAnalytics};`,
+        `export const ANALYTICS_ENABLED: boolean = ${answers.enableAnalytics};`,
        'ANALYTICS_ENABLED'
      );

+      // Update RETURN_URL
+      const returnUrlValue = answers.returnUrl ? `'${escapeString(answers.returnUrl)}'` : 'undefined';
+      constantsContent = safeReplace(
+        constantsContent,
+        patterns.RETURN_URL,
+        `export const RETURN_URL: string | undefined = ${returnUrlValue};`,
+        'RETURN_URL'
+      );
+
      fs.writeFileSync(constantsPath, constantsContent);
    } else {
      console.log('⚠️  constants.ts not found, skipping constants update');
    }

-    fs.appendFileSync(
-      envPath,
-      `\nNEXTAUTH_SECRET="${crypto.randomBytes(32).toString('hex')}"`
-    );
+    
    if (useNeynar && neynarApiKey && neynarClientId) {
      fs.appendFileSync(envPath, `\nNEYNAR_API_KEY="${neynarApiKey}"`);
      fs.appendFileSync(envPath, `\nNEYNAR_CLIENT_ID="${neynarClientId}"`);
@@ -600,10 +727,17 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
      );
    }
    if (answers.seedPhrase) {
+      console.log('✅ Writing SEED_PHRASE and NEXTAUTH_SECRET to .env.local');
      fs.appendFileSync(envPath, `\nSEED_PHRASE="${answers.seedPhrase}"`);
-      fs.appendFileSync(envPath, `\nSPONSOR_SIGNER="${answers.sponsorSigner}"`);
+      // Add NextAuth secret for SIWN
+      fs.appendFileSync(
+        envPath,
+        `\nNEXTAUTH_SECRET="${crypto.randomBytes(32).toString('hex')}"`
+      );
+    }
+    if (answers.useSponsoredSigner) {
+      fs.appendFileSync(envPath, `\nSPONSOR_SIGNER="true"`);
    }
-    fs.appendFileSync(envPath, `\nUSE_TUNNEL="${answers.useTunnel}"`);

    fs.unlinkSync(envExamplePath);
  } else {
@@ -647,6 +781,87 @@ export async function init(projectName = null, autoAcceptDefaults = false) {
    fs.rmSync(binPath, { recursive: true, force: true });
  }

+  // Handle SIWN-related files based on whether seed phrase is provided
+  if (!answers.seedPhrase) {
+    // Remove SIWN-related files when SIWN is not enabled (no seed phrase)
+    console.log('\nRemoving SIWN-related files (SIWN not enabled)...');
+    
+    // Remove NeynarAuthButton directory
+    const neynarAuthButtonPath = path.join(projectPath, 'src', 'components', 'ui', 'NeynarAuthButton');
+    if (fs.existsSync(neynarAuthButtonPath)) {
+      fs.rmSync(neynarAuthButtonPath, { recursive: true, force: true });
+    }
+    
+    // Remove NextAuth API routes
+    const nextAuthRoutePath = path.join(projectPath, 'src', 'app', 'api', 'auth', '[...nextauth]', 'route.ts');
+    if (fs.existsSync(nextAuthRoutePath)) {
+      fs.rmSync(nextAuthRoutePath, { force: true });
+      // Remove the directory if it's empty
+      const nextAuthDir = path.dirname(nextAuthRoutePath);
+      if (fs.readdirSync(nextAuthDir).length === 0) {
+        fs.rmSync(nextAuthDir, { recursive: true, force: true });
+      }
+    }
+    
+    // Remove src/auth.ts file
+    const authFilePath = path.join(projectPath, 'src', 'auth.ts');
+    if (fs.existsSync(authFilePath)) {
+      fs.rmSync(authFilePath, { force: true });
+    }
+    
+    // Remove SIWN-specific files
+    const actionsTabNeynarAuthPath = path.join(projectPath, 'src', 'components', 'ui', 'tabs', 'ActionsTab.NeynarAuth.tsx');
+    if (fs.existsSync(actionsTabNeynarAuthPath)) {
+      fs.rmSync(actionsTabNeynarAuthPath, { force: true });
+    }
+    
+    const layoutNeynarAuthPath = path.join(projectPath, 'src', 'app', 'layout.NeynarAuth.tsx');
+    if (fs.existsSync(layoutNeynarAuthPath)) {
+      fs.rmSync(layoutNeynarAuthPath, { force: true });
+    }
+    
+    const providersNeynarAuthPath = path.join(projectPath, 'src', 'app', 'providers.NeynarAuth.tsx');
+    if (fs.existsSync(providersNeynarAuthPath)) {
+      fs.rmSync(providersNeynarAuthPath, { force: true });
+    }
+  } else {
+    // Move SIWN-specific files to replace the regular versions when SIWN is enabled
+    console.log('\nMoving SIWN-specific files to replace regular versions (SIWN enabled)...');
+    
+    // Move ActionsTab.NeynarAuth.tsx to ActionsTab.tsx
+    const actionsTabNeynarAuthPath = path.join(projectPath, 'src', 'components', 'ui', 'tabs', 'ActionsTab.NeynarAuth.tsx');
+    const actionsTabPath = path.join(projectPath, 'src', 'components', 'ui', 'tabs', 'ActionsTab.tsx');
+    if (fs.existsSync(actionsTabNeynarAuthPath)) {
+      if (fs.existsSync(actionsTabPath)) {
+        fs.rmSync(actionsTabPath, { force: true }); // Delete original
+      }
+      fs.renameSync(actionsTabNeynarAuthPath, actionsTabPath);
+      console.log('✅ Moved ActionsTab.NeynarAuth.tsx to ActionsTab.tsx');
+    }
+    
+    // Move layout.NeynarAuth.tsx to layout.tsx
+    const layoutNeynarAuthPath = path.join(projectPath, 'src', 'app', 'layout.NeynarAuth.tsx');
+    const layoutPath = path.join(projectPath, 'src', 'app', 'layout.tsx');
+    if (fs.existsSync(layoutNeynarAuthPath)) {
+      if (fs.existsSync(layoutPath)) {
+        fs.rmSync(layoutPath, { force: true }); // Delete original
+      }
+      fs.renameSync(layoutNeynarAuthPath, layoutPath);
+      console.log('✅ Moved layout.NeynarAuth.tsx to layout.tsx');
+    }
+    
+    // Move providers.NeynarAuth.tsx to providers.tsx
+    const providersNeynarAuthPath = path.join(projectPath, 'src', 'app', 'providers.NeynarAuth.tsx');
+    const providersPath = path.join(projectPath, 'src', 'app', 'providers.tsx');
+    if (fs.existsSync(providersNeynarAuthPath)) {
+      if (fs.existsSync(providersPath)) {
+        fs.rmSync(providersPath, { force: true }); // Delete original
+      }
+      fs.renameSync(providersNeynarAuthPath, providersPath);
+      console.log('✅ Moved providers.NeynarAuth.tsx to providers.tsx');
+    }
+  }
+
  // Initialize git repository
  console.log('\nInitializing git repository...');
  execSync('git init', { cwd: projectPath });
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@neynar/create-farcaster-mini-app",
-  "version": "1.5.7",
+  "version": "1.9.0",
  "type": "module",
  "private": false,
  "access": "public",
@@ -31,11 +31,11 @@
  ],
  "scripts": {
    "dev": "node scripts/dev.js",
-    "build": "node scripts/build.js",
+    "build": "next build",
    "build:raw": "next build",
    "start": "next start",
    "lint": "next lint",
-    "deploy:vercel": "node scripts/deploy.js",
+    "deploy:vercel": "tsx scripts/deploy.ts",
    "deploy:raw": "vercel --prod",
    "cleanup": "node scripts/cleanup.js"
  },
@@ -51,5 +51,17 @@
    "@neynar/nodejs-sdk": "^2.19.0",
    "@types/node": "^22.13.10",
    "typescript": "^5.6.3"
+  },
+  "overrides": {
+    "chalk": "5.3.0",
+    "strip-ansi": "6.0.1",
+    "wrap-ansi": "8.1.0",
+    "ansi-styles": "6.2.3",
+    "color-convert": "2.0.1",
+    "color-name": "1.1.4",
+    "is-core-module": "2.13.1",
+    "error-ex": "1.3.2",
+    "simple-swizzle": "0.2.2",
+    "has-ansi": "5.0.1"
  }
 }
--- a/scripts/build.js
+++ b/scripts/build.js
@@ -1,359 +0,0 @@
-import { execSync } from "child_process";
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-import inquirer from "inquirer";
-import dotenv from "dotenv";
-import crypto from "crypto";
-
-// Load environment variables in specific order
-// First load .env for main config
-dotenv.config({ path: ".env" });
-
-async function loadEnvLocal() {
-  try {
-    if (fs.existsSync(".env.local")) {
-      const { loadLocal } = await inquirer.prompt([
-        {
-          type: "confirm",
-          name: "loadLocal",
-          message:
-            "Found .env.local, likely created by the install script - would you like to load its values?",
-          default: false,
-        },
-      ]);
-
-      if (loadLocal) {
-        console.log("Loading values from .env.local...");
-        const localEnv = dotenv.parse(fs.readFileSync(".env.local"));
-
-        // Copy all values to .env
-        const envContent = fs.existsSync(".env")
-          ? fs.readFileSync(".env", "utf8") + "\n"
-          : "";
-        let newEnvContent = envContent;
-
-        for (const [key, value] of Object.entries(localEnv)) {
-          // Update process.env
-          process.env[key] = value;
-          // Add to .env content if not already there
-          if (!envContent.includes(`${key}=`)) {
-            newEnvContent += `${key}="${value}"\n`;
-          }
-        }
-
-        // Write updated content to .env
-        fs.writeFileSync(".env", newEnvContent);
-        console.log("✅ Values from .env.local have been written to .env");
-      }
-      if (localEnv.SPONSOR_SIGNER) {
-        process.env.SPONSOR_SIGNER = localEnv.SPONSOR_SIGNER;
-      }
-    }
-  } catch (error) {
-    // Error reading .env.local, which is fine
-    console.log("Note: No .env.local file found");
-  }
-}
-
-// TODO: make sure rebuilding is supported
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const projectRoot = path.join(__dirname, "..");
-
-async function validateDomain(domain) {
-  // Remove http:// or https:// if present
-  const cleanDomain = domain.replace(/^https?:\/\//, "");
-
-  // Basic domain validation
-  if (
-    !cleanDomain.match(
-      /^[a-zA-Z0-9][a-zA-Z0-9-]{1,61}[a-zA-Z0-9](?:\.[a-zA-Z]{2,})+$/
-    )
-  ) {
-    throw new Error("Invalid domain format");
-  }
-
-  return cleanDomain;
-}
-
-async function queryNeynarApp(apiKey) {
-  if (!apiKey) {
-    return null;
-  }
-  try {
-    const response = await fetch(
-      `https://api.neynar.com/portal/app_by_api_key`,
-      {
-        headers: {
-          "x-api-key": apiKey,
-        },
-      }
-    );
-    const data = await response.json();
-    return data;
-  } catch (error) {
-    console.error("Error querying Neynar app data:", error);
-    return null;
-  }
-}
-
-async function generateFarcasterMetadata(domain, webhookUrl) {
-  const tags = process.env.NEXT_PUBLIC_MINI_APP_TAGS?.split(",");
-
-  return {
-    accountAssociation: {
-      header: "",
-      payload: "",
-      signature: "",
-    },
-    frame: {
-      version: "1",
-      name: process.env.NEXT_PUBLIC_MINI_APP_NAME,
-      iconUrl: `https://${domain}/icon.png`,
-      homeUrl: `https://${domain}`,
-      imageUrl: `https://${domain}/api/opengraph-image`,
-      buttonTitle: process.env.NEXT_PUBLIC_MINI_APP_BUTTON_TEXT,
-      splashImageUrl: `https://${domain}/splash.png`,
-      splashBackgroundColor: "#f7f7f7",
-      webhookUrl,
-      description: process.env.NEXT_PUBLIC_MINI_APP_DESCRIPTION,
-      primaryCategory: process.env.NEXT_PUBLIC_MINI_APP_PRIMARY_CATEGORY,
-      tags,
-    },
-  };
-}
-
-async function main() {
-  try {
-    console.log("\n📝 Checking environment variables...");
-    console.log("Loading values from .env...");
-
-    // Load .env.local if user wants to
-    await loadEnvLocal();
-
-    // Get domain from user
-    const { domain } = await inquirer.prompt([
-      {
-        type: "input",
-        name: "domain",
-        message:
-          "Enter the domain where your mini app will be deployed (e.g., example.com):",
-        validate: async (input) => {
-          try {
-            await validateDomain(input);
-            return true;
-          } catch (error) {
-            return error.message;
-          }
-        },
-      },
-    ]);
-
-    // Get frame name from user
-    const { frameName } = await inquirer.prompt([
-      {
-        type: "input",
-        name: "frameName",
-        message: "Enter the name for your mini app (e.g., My Cool Mini App):",
-        default: process.env.NEXT_PUBLIC_MINI_APP_NAME,
-        validate: (input) => {
-          if (input.trim() === "") {
-            return "Mini app name cannot be empty";
-          }
-          return true;
-        },
-      },
-    ]);
-
-    // Get button text from user
-    const { buttonText } = await inquirer.prompt([
-      {
-        type: "input",
-        name: "buttonText",
-        message: "Enter the text for your mini app button:",
-        default:
-          process.env.NEXT_PUBLIC_MINI_APP_BUTTON_TEXT || "Launch Mini App",
-        validate: (input) => {
-          if (input.trim() === "") {
-            return "Button text cannot be empty";
-          }
-          return true;
-        },
-      },
-    ]);
-
-    // Get Neynar configuration
-    let neynarApiKey = process.env.NEYNAR_API_KEY;
-    let neynarClientId = process.env.NEYNAR_CLIENT_ID;
-    let useNeynar = true;
-
-    while (useNeynar) {
-      if (!neynarApiKey) {
-        const { neynarApiKey: inputNeynarApiKey } = await inquirer.prompt([
-          {
-            type: "password",
-            name: "neynarApiKey",
-            message:
-              "Enter your Neynar API key (optional - leave blank to skip):",
-            default: null,
-          },
-        ]);
-        neynarApiKey = inputNeynarApiKey;
-      } else {
-        console.log("Using existing Neynar API key from .env");
-      }
-
-      if (!neynarApiKey) {
-        useNeynar = false;
-        break;
-      }
-
-      // Try to get client ID from API
-      if (!neynarClientId) {
-        const appInfo = await queryNeynarApp(neynarApiKey);
-        if (appInfo) {
-          neynarClientId = appInfo.app_uuid;
-          console.log("✅ Fetched Neynar app client ID");
-          break;
-        }
-      }
-
-      // We have a client ID (either from .env or fetched from API), so we can break out of the loop
-      if (neynarClientId) {
-        break;
-      }
-
-      // If we get here, the API key was invalid
-      console.log(
-        "\n⚠️  Could not find Neynar app information. The API key may be incorrect."
-      );
-      const { retry } = await inquirer.prompt([
-        {
-          type: "confirm",
-          name: "retry",
-          message: "Would you like to try a different API key?",
-          default: true,
-        },
-      ]);
-
-      // Reset for retry
-      neynarApiKey = null;
-      neynarClientId = null;
-
-      if (!retry) {
-        useNeynar = false;
-        break;
-      }
-    }
-
-    // Generate manifest
-    console.log("\n🔨 Generating mini app manifest...");
-
-    // Determine webhook URL based on environment variables
-    const webhookUrl =
-      neynarApiKey && neynarClientId
-        ? `https://api.neynar.com/f/app/${neynarClientId}/event`
-        : `https://${domain}/api/webhook`;
-
-    const metadata = await generateFarcasterMetadata(domain, webhookUrl);
-    console.log("\n✅ Mini app manifest generated");
-
-    // Read existing .env file or create new one
-    const envPath = path.join(projectRoot, ".env");
-    let envContent = fs.existsSync(envPath)
-      ? fs.readFileSync(envPath, "utf8")
-      : "";
-
-    // Add or update environment variables
-    const newEnvVars = [
-      // Base URL
-      `NEXT_PUBLIC_URL=https://${domain}`,
-
-      // Mini app metadata
-      `NEXT_PUBLIC_MINI_APP_NAME="${frameName}"`,
-      `NEXT_PUBLIC_MINI_APP_DESCRIPTION="${
-        process.env.NEXT_PUBLIC_MINI_APP_DESCRIPTION || ""
-      }"`,
-      `NEXT_PUBLIC_MINI_APP_PRIMARY_CATEGORY="${
-        process.env.NEXT_PUBLIC_MINI_APP_PRIMARY_CATEGORY || ""
-      }"`,
-      `NEXT_PUBLIC_MINI_APP_TAGS="${
-        process.env.NEXT_PUBLIC_MINI_APP_TAGS || ""
-      }"`,
-      `NEXT_PUBLIC_MINI_APP_BUTTON_TEXT="${buttonText}"`,
-
-      // Analytics
-      `NEXT_PUBLIC_ANALYTICS_ENABLED="${
-        process.env.NEXT_PUBLIC_ANALYTICS_ENABLED || "false"
-      }"`,
-
-      // Neynar configuration (if it exists in current env)
-      ...(process.env.NEYNAR_API_KEY
-        ? [`NEYNAR_API_KEY="${process.env.NEYNAR_API_KEY}"`]
-        : []),
-      ...(neynarClientId ? [`NEYNAR_CLIENT_ID="${neynarClientId}"`] : []),
-      ...(process.env.SPONSOR_SIGNER ? 
-        [`SPONSOR_SIGNER="${process.env.SPONSOR_SIGNER}"`] : []),
-
-      // FID (if it exists in current env)
-      ...(process.env.FID ? [`FID="${process.env.FID}"`] : []),
-      `NEXT_PUBLIC_USE_WALLET="${
-        process.env.NEXT_PUBLIC_USE_WALLET || "false"
-      }"`,
-
-      // NextAuth configuration
-      `NEXTAUTH_SECRET="${
-        process.env.NEXTAUTH_SECRET || crypto.randomBytes(32).toString("hex")
-      }"`,
-      `NEXTAUTH_URL="https://${domain}"`,
-
-      // Mini app manifest with signature
-      `MINI_APP_METADATA=${JSON.stringify(metadata)}`,
-    ];
-
-    // Filter out empty values and join with newlines
-    const validEnvVars = newEnvVars.filter((line) => {
-      const [, value] = line.split("=");
-      return value && value !== '""';
-    });
-
-    // Update or append each environment variable
-    validEnvVars.forEach((varLine) => {
-      const [key] = varLine.split("=");
-      if (envContent.includes(`${key}=`)) {
-        envContent = envContent.replace(new RegExp(`${key}=.*`), varLine);
-      } else {
-        envContent += `\n${varLine}`;
-      }
-    });
-
-    // Write updated .env file
-    fs.writeFileSync(envPath, envContent);
-
-    console.log("\n✅ Environment variables updated");
-
-    // Run next build
-    console.log("\nBuilding Next.js application...");
-    const nextBin = path.normalize(
-      path.join(projectRoot, "node_modules", ".bin", "next")
-    );
-    execSync(`"${nextBin}" build`, {
-      cwd: projectRoot,
-      stdio: "inherit",
-      shell: process.platform === "win32",
-    });
-
-    console.log(
-      "\n✨ Build complete! Your mini app is ready for deployment. 🪐"
-    );
-    console.log(
-      "📝 Make sure to configure the environment variables from .env in your hosting provider"
-    );
-  } catch (error) {
-    console.error("\n❌ Error:", error.message);
-    process.exit(1);
-  }
-}
-
-main();
--- a/scripts/deploy.ts
+++ b/scripts/deploy.ts
@@ -7,6 +7,7 @@ import inquirer from 'inquirer';
 import dotenv from 'dotenv';
 import crypto from 'crypto';
 import { Vercel } from '@vercel/sdk';
+import { APP_NAME, APP_BUTTON_TEXT } from '../src/lib/constants.js';

 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const projectRoot = path.join(__dirname, '..');
@@ -14,32 +15,10 @@ const projectRoot = path.join(__dirname, '..');
 // Load environment variables in specific order
 dotenv.config({ path: '.env' });

-async function generateFarcasterMetadata(domain, webhookUrl) {
-  const trimmedDomain = domain.trim();
-  const tags = process.env.NEXT_PUBLIC_MINI_APP_TAGS?.split(',');
-
-  return {
-    frame: {
-      version: '1',
-      name: process.env.NEXT_PUBLIC_MINI_APP_NAME,
-      iconUrl: `https://${trimmedDomain}/icon.png`,
-      homeUrl: `https://${trimmedDomain}`,
-      imageUrl: `https://${trimmedDomain}/api/opengraph-image`,
-      buttonTitle: process.env.NEXT_PUBLIC_MINI_APP_BUTTON_TEXT,
-      splashImageUrl: `https://${trimmedDomain}/splash.png`,
-      splashBackgroundColor: '#f7f7f7',
-      webhookUrl: webhookUrl?.trim(),
-      description: process.env.NEXT_PUBLIC_MINI_APP_DESCRIPTION,
-      primaryCategory: process.env.NEXT_PUBLIC_MINI_APP_PRIMARY_CATEGORY,
-      tags,
-    },
-  };
-}
-
-async function loadEnvLocal() {
+async function loadEnvLocal(): Promise<void> {
  try {
    if (fs.existsSync('.env.local')) {
-      const { loadLocal } = await inquirer.prompt([
+      const { loadLocal }: { loadLocal: boolean } = await inquirer.prompt([
        {
          type: 'confirm',
          name: 'loadLocal',
@@ -54,12 +33,7 @@ async function loadEnvLocal() {
        const localEnv = dotenv.parse(fs.readFileSync('.env.local'));

        const allowedVars = [
-          'NEXT_PUBLIC_MINI_APP_NAME',
-          'NEXT_PUBLIC_MINI_APP_DESCRIPTION',
-          'NEXT_PUBLIC_MINI_APP_PRIMARY_CATEGORY',
-          'NEXT_PUBLIC_MINI_APP_TAGS',
-          'NEXT_PUBLIC_MINI_APP_BUTTON_TEXT',
-          'NEXT_PUBLIC_ANALYTICS_ENABLED',
+          'SEED_PHRASE',
          'NEYNAR_API_KEY',
          'NEYNAR_CLIENT_ID',
          'SPONSOR_SIGNER',
@@ -83,12 +57,12 @@ async function loadEnvLocal() {
        console.log('✅ Values from .env.local have been written to .env');
      }
    }
-  } catch (error) {
+  } catch (error: unknown) {
    console.log('Note: No .env.local file found');
  }
 }

-async function checkRequiredEnvVars() {
+async function checkRequiredEnvVars(): Promise<void> {
  console.log('\n📝 Checking environment variables...');
  console.log('Loading values from .env...');

@@ -98,21 +72,21 @@ async function checkRequiredEnvVars() {
    {
      name: 'NEXT_PUBLIC_MINI_APP_NAME',
      message: 'Enter the name for your frame (e.g., My Cool Mini App):',
-      default: process.env.NEXT_PUBLIC_MINI_APP_NAME,
-      validate: (input) =>
+      default: APP_NAME,
+      validate: (input: string) =>
        input.trim() !== '' || 'Mini app name cannot be empty',
    },
    {
      name: 'NEXT_PUBLIC_MINI_APP_BUTTON_TEXT',
      message: 'Enter the text for your frame button:',
-      default:
-        process.env.NEXT_PUBLIC_MINI_APP_BUTTON_TEXT ?? 'Launch Mini App',
-      validate: (input) => input.trim() !== '' || 'Button text cannot be empty',
+      default: APP_BUTTON_TEXT ?? 'Launch Mini App',
+      validate: (input: string) =>
+        input.trim() !== '' || 'Button text cannot be empty',
    },
  ];

  const missingVars = requiredVars.filter(
-    (varConfig) => !process.env[varConfig.name]
+    varConfig => !process.env[varConfig.name],
  );

  if (missingVars.length > 0) {
@@ -138,17 +112,19 @@ async function checkRequiredEnvVars() {
        const newLine = envContent ? '\n' : '';
        fs.appendFileSync(
          '.env',
-          `${newLine}${varConfig.name}="${value.trim()}"`
+          `${newLine}${varConfig.name}="${value.trim()}"`,
        );
      }
+    }

-      // Ask about sponsor signer if SEED_PHRASE is provided
-      if (!process.env.SPONSOR_SIGNER) {
+    // Ask about SIWN if SEED_PHRASE is provided (moved outside the loop)
+    if (process.env.SEED_PHRASE && !process.env.SPONSOR_SIGNER) {
      const { sponsorSigner } = await inquirer.prompt([
        {
          type: 'confirm',
          name: 'sponsorSigner',
          message:
+            'You have provided a seed phrase, which enables Sign In With Neynar (SIWN).\n' +
            'Do you want to sponsor the signer? (This will be used in Sign In With Neynar)\n' +
            'Note: If you choose to sponsor the signer, Neynar will sponsor it for you and you will be charged in CUs.\n' +
            'For more information, see https://docs.neynar.com/docs/two-ways-to-sponsor-a-farcaster-signer-via-neynar#sponsor-signers',
@@ -158,18 +134,128 @@ async function checkRequiredEnvVars() {

      process.env.SPONSOR_SIGNER = sponsorSigner.toString();

-        if (storeSeedPhrase) {
      fs.appendFileSync(
        '.env.local',
-            `\nSPONSOR_SIGNER="${sponsorSigner}"`
+        `\nSPONSOR_SIGNER="${sponsorSigner}"`,
      );
      console.log('✅ Sponsor signer preference stored in .env.local');
    }
+
+    // Ask about required chains (moved outside the loop)
+    const { useRequiredChains } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'useRequiredChains',
+        message:
+          'Does your mini app require support for specific blockchains?\n' +
+          'If yes, the host will only render your mini app if it supports all the chains you specify.\n' +
+          'If no, the mini app will be rendered regardless of chain support.',
+        default: false,
+      },
+    ]);
+
+    let requiredChains: string[] = [];
+    if (useRequiredChains) {
+      const { selectedChains } = await inquirer.prompt([
+        {
+          type: 'checkbox',
+          name: 'selectedChains',
+          message: 'Select the required chains (CAIP-2 identifiers):',
+          choices: [
+            { name: 'Ethereum Mainnet (eip155:1)', value: 'eip155:1' },
+            { name: 'Polygon (eip155:137)', value: 'eip155:137' },
+            { name: 'Arbitrum One (eip155:42161)', value: 'eip155:42161' },
+            { name: 'Optimism (eip155:10)', value: 'eip155:10' },
+            { name: 'Base (eip155:8453)', value: 'eip155:8453' },
+            { name: 'Solana (solana:mainnet)', value: 'solana:mainnet' },
+            { name: 'Solana Devnet (solana:devnet)', value: 'solana:devnet' },
+          ],
+        },
+      ]);
+      requiredChains = selectedChains;
    }
+
+    // Update constants.ts with required chains
+    const constantsPath = path.join(projectRoot, 'src', 'lib', 'constants.ts');
+    if (fs.existsSync(constantsPath)) {
+      let constantsContent = fs.readFileSync(constantsPath, 'utf8');
+      
+      // Replace the APP_REQUIRED_CHAINS line
+      const requiredChainsString = JSON.stringify(requiredChains);
+      constantsContent = constantsContent.replace(
+        /^export const APP_REQUIRED_CHAINS\s*:\s*string\[\]\s*=\s*\[[^\]]*\];$/m,
+        `export const APP_REQUIRED_CHAINS: string[] = ${requiredChainsString};`,
+      );
+      
+      fs.writeFileSync(constantsPath, constantsContent);
+      console.log('✅ Required chains updated in constants.ts');
+    }
+
+    // Ask for account association
+    console.log(
+      `\n⚠️  To complete your mini app manifest, you need to sign it using the Farcaster developer portal.`,
+    );
+    console.log(
+      '1. Go to: https://farcaster.xyz/~/developers/mini-apps/manifest',
+    );
+    console.log(
+      '2. Enter your app domain (you\'ll get this after deployment)',
+    );
+    console.log(
+      '3. Click "Transfer Ownership" and follow the instructions to sign the manifest.',
+    );
+    console.log(
+      '4. Copy the resulting accountAssociation JSON.',
+    );
+    console.log('5. Paste it below when prompted.');
+    console.log(
+      '\nNote: If you don\'t have the accountAssociation yet, you can press Ctrl+C to skip and add it later.',
+    );
+
+    try {
+      const { userAccountAssociation } = await inquirer.prompt([
+        {
+          type: 'editor',
+          name: 'userAccountAssociation',
+          message: 'Paste the accountAssociation JSON here (or press Ctrl+C to skip):',
+          validate: (input: string) => {
+            if (!input.trim()) {
+              return 'You can press Ctrl+C to skip this step';
+            }
+            try {
+              const parsed = JSON.parse(input);
+              if (parsed.header && parsed.payload && parsed.signature) {
+                return true;
+              }
+              return 'Invalid accountAssociation: must have header, payload, and signature';
+            } catch (e) {
+              return 'Invalid JSON';
+            }
+          },
+        },
+      ]);
+      
+      const parsedAccountAssociation = JSON.parse(userAccountAssociation);
+
+      // Write APP_ACCOUNT_ASSOCIATION to constants.ts
+      if (fs.existsSync(constantsPath)) {
+        let constantsContent = fs.readFileSync(constantsPath, 'utf8');
+        
+        // Replace the APP_ACCOUNT_ASSOCIATION line
+        const newAccountAssociation = `export const APP_ACCOUNT_ASSOCIATION: AccountAssociation | undefined = ${JSON.stringify(parsedAccountAssociation, null, 2)};`;
+        constantsContent = constantsContent.replace(
+          /^export const APP_ACCOUNT_ASSOCIATION\s*:\s*AccountAssociation \| undefined\s*=\s*[^;]*;/m,
+          newAccountAssociation,
+        );
+        fs.writeFileSync(constantsPath, constantsContent);
+        console.log('✅ APP_ACCOUNT_ASSOCIATION updated in constants.ts');
+      }
+    } catch (error) {
+      console.log('\nℹ️  Skipping account association for now. You can add it later by updating APP_ACCOUNT_ASSOCIATION in src/lib/constants.ts');
    }
  }

-  // Load SPONSOR_SIGNER from .env.local if SEED_PHRASE exists but SPONSOR_SIGNER doesn't
+  // Load SPONSOR_SIGNER from .env.local if SEED_PHRASE exists (SIWN enabled) but SPONSOR_SIGNER doesn't
  if (
    process.env.SEED_PHRASE &&
    !process.env.SPONSOR_SIGNER &&
@@ -182,39 +268,43 @@ async function checkRequiredEnvVars() {
  }
 }

-async function getGitRemote() {
+async function getGitRemote(): Promise<string | null> {
  try {
    const remoteUrl = execSync('git remote get-url origin', {
      cwd: projectRoot,
      encoding: 'utf8',
    }).trim();
    return remoteUrl;
-  } catch (error) {
+  } catch (error: unknown) {
+    if (error instanceof Error) {
      return null;
    }
+    throw error;
+  }
 }

-async function checkVercelCLI() {
+async function checkVercelCLI(): Promise<boolean> {
  try {
    execSync('vercel --version', {
      stdio: 'ignore',
-      shell: process.platform === 'win32',
    });
    return true;
-  } catch (error) {
+  } catch (error: unknown) {
+    if (error instanceof Error) {
      return false;
    }
+    throw error;
+  }
 }

-async function installVercelCLI() {
+async function installVercelCLI(): Promise<void> {
  console.log('Installing Vercel CLI...');
  execSync('npm install -g vercel', {
    stdio: 'inherit',
-    shell: process.platform === 'win32',
  });
 }

-async function getVercelToken() {
+async function getVercelToken(): Promise<string | null> {
  try {
    // Try to get token from Vercel CLI config
    const configPath = path.join(os.homedir(), '.vercel', 'auth.json');
@@ -222,9 +312,11 @@ async function getVercelToken() {
      const authConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
      return authConfig.token;
    }
-  } catch (error) {
+  } catch (error: unknown) {
+    if (error instanceof Error) {
      console.warn('Could not read Vercel token from config file');
    }
+  }

  // Try environment variable
  if (process.env.VERCEL_TOKEN) {
@@ -242,14 +334,17 @@ async function getVercelToken() {
    // The token isn't directly exposed, so we'll need to use CLI for some operations
    console.log('✅ Verified Vercel CLI authentication');
    return null; // We'll fall back to CLI operations
-  } catch (error) {
+  } catch (error: unknown) {
+    if (error instanceof Error) {
      throw new Error(
-      'Not logged in to Vercel CLI. Please run this script again to login.'
+        'Not logged in to Vercel CLI. Please run this script again to login.',
      );
    }
+    throw error;
+  }
 }

-async function loginToVercel() {
+async function loginToVercel(): Promise<boolean> {
  console.log('\n🔑 Vercel Login');
  console.log('You can either:');
  console.log('1. Log in to an existing Vercel account');
@@ -260,22 +355,22 @@ async function loginToVercel() {
  console.log('3. Complete the Vercel account setup in your browser');
  console.log('4. Return here once your Vercel account is created\n');
  console.log(
-    '\nNote: you may need to cancel this script with ctrl+c and run it again if creating a new vercel account'
+    '\nNote: you may need to cancel this script with ctrl+c and run it again if creating a new vercel account',
  );

  const child = spawn('vercel', ['login'], {
    stdio: 'inherit',
  });

-  await new Promise((resolve, reject) => {
-    child.on('close', (code) => {
+  await new Promise<void>((resolve, reject) => {
+    child.on('close', code => {
      resolve();
    });
  });

  console.log('\n📱 Waiting for login to complete...');
  console.log(
-    "If you're creating a new account, please complete the Vercel account setup in your browser first."
+    "If you're creating a new account, please complete the Vercel account setup in your browser first.",
  );

  for (let i = 0; i < 150; i++) {
@@ -283,11 +378,14 @@ async function loginToVercel() {
      execSync('vercel whoami', { stdio: 'ignore' });
      console.log('✅ Successfully logged in to Vercel!');
      return true;
-    } catch (error) {
-      if (error.message.includes('Account not found')) {
+    } catch (error: unknown) {
+      if (
+        error instanceof Error &&
+        error.message.includes('Account not found')
+      ) {
        console.log('ℹ️  Waiting for Vercel account setup to complete...');
      }
-      await new Promise((resolve) => setTimeout(resolve, 2000));
+      await new Promise(resolve => setTimeout(resolve, 2000));
    }
  }

@@ -298,9 +396,14 @@ async function loginToVercel() {
  return false;
 }

-async function setVercelEnvVarSDK(vercelClient, projectId, key, value) {
+async function setVercelEnvVarSDK(
+  vercelClient: Vercel,
+  projectId: string,
+  key: string,
+  value: string | object,
+): Promise<boolean> {
  try {
-    let processedValue;
+    let processedValue: string;
    if (typeof value === 'object') {
      processedValue = JSON.stringify(value);
    } else {
@@ -308,17 +411,26 @@ async function setVercelEnvVarSDK(vercelClient, projectId, key, value) {
    }

    // Get existing environment variables
-    const existingVars = await vercelClient.projects.getEnvironmentVariables({
+    const existingVars = await vercelClient.projects.filterProjectEnvs({
      idOrName: projectId,
    });

-    const existingVar = existingVars.envs?.find(
-      (env) => env.key === key && env.target?.includes('production')
+    // Handle different response types
+    let envs: any[] = [];
+    if ('envs' in existingVars && Array.isArray(existingVars.envs)) {
+      envs = existingVars.envs;
+    } else if ('target' in existingVars && 'key' in existingVars) {
+      // Single environment variable response
+      envs = [existingVars];
+    }
+
+    const existingVar = envs.find(
+      (env: any) => env.key === key && env.target?.includes('production'),
    );

-    if (existingVar) {
+    if (existingVar && existingVar.id) {
      // Update existing variable
-      await vercelClient.projects.editEnvironmentVariable({
+      await vercelClient.projects.editProjectEnv({
        idOrName: projectId,
        id: existingVar.id,
        requestBody: {
@@ -329,7 +441,7 @@ async function setVercelEnvVarSDK(vercelClient, projectId, key, value) {
      console.log(`✅ Updated environment variable: ${key}`);
    } else {
      // Create new variable
-      await vercelClient.projects.createEnvironmentVariable({
+      await vercelClient.projects.createProjectEnv({
        idOrName: projectId,
        requestBody: {
          key: key,
@@ -342,16 +454,23 @@ async function setVercelEnvVarSDK(vercelClient, projectId, key, value) {
    }

    return true;
-  } catch (error) {
+  } catch (error: unknown) {
+    if (error instanceof Error) {
      console.warn(
        `⚠️  Warning: Failed to set environment variable ${key}:`,
-      error.message
+        error.message,
      );
      return false;
    }
+    throw error;
+  }
 }

-async function setVercelEnvVarCLI(key, value, projectRoot) {
+async function setVercelEnvVarCLI(
+  key: string,
+  value: string | object,
+  projectRoot: string,
+): Promise<boolean> {
  try {
    // Remove existing env var
    try {
@@ -360,11 +479,11 @@ async function setVercelEnvVarCLI(key, value, projectRoot) {
        stdio: 'ignore',
        env: process.env,
      });
-    } catch (error) {
+    } catch (error: unknown) {
      // Ignore errors from removal
    }

-    let processedValue;
+    let processedValue: string;
    if (typeof value === 'object') {
      processedValue = JSON.stringify(value);
    } else {
@@ -376,7 +495,7 @@ async function setVercelEnvVarCLI(key, value, projectRoot) {
    fs.writeFileSync(tempFilePath, processedValue, 'utf8');

    // Use appropriate command based on platform
-    let command;
+    let command: string;
    if (process.platform === 'win32') {
      command = `type "${tempFilePath}" | vercel env add ${key} production`;
    } else {
@@ -386,35 +505,37 @@ async function setVercelEnvVarCLI(key, value, projectRoot) {
    execSync(command, {
      cwd: projectRoot,
      stdio: 'pipe', // Changed from 'inherit' to avoid interactive prompts
-      shell: true,
      env: process.env,
    });

    fs.unlinkSync(tempFilePath);
    console.log(`✅ Set environment variable: ${key}`);
    return true;
-  } catch (error) {
+  } catch (error: unknown) {
    const tempFilePath = path.join(projectRoot, `${key}_temp.txt`);
    if (fs.existsSync(tempFilePath)) {
      fs.unlinkSync(tempFilePath);
    }
+    if (error instanceof Error) {
      console.warn(
        `⚠️  Warning: Failed to set environment variable ${key}:`,
-      error.message
+        error.message,
      );
      return false;
    }
+    throw error;
+  }
 }

 async function setEnvironmentVariables(
-  vercelClient,
-  projectId,
-  envVars,
-  projectRoot
-) {
+  vercelClient: Vercel | null,
+  projectId: string | null,
+  envVars: Record<string, string | object>,
+  projectRoot: string,
+): Promise<Array<{ key: string; success: boolean }>> {
  console.log('\n📝 Setting up environment variables...');

-  const results = [];
+  const results: Array<{ key: string; success: boolean }> = [];

  for (const [key, value] of Object.entries(envVars)) {
    if (!value) continue;
@@ -435,12 +556,12 @@ async function setEnvironmentVariables(
  }

  // Report results
-  const failed = results.filter((r) => !r.success);
+  const failed = results.filter(r => !r.success);
  if (failed.length > 0) {
    console.warn(`\n⚠️  Failed to set ${failed.length} environment variables:`);
-    failed.forEach((r) => console.warn(`   - ${r.key}`));
+    failed.forEach(r => console.warn(`   - ${r.key}`));
    console.warn(
-      '\nYou may need to set these manually in the Vercel dashboard.'
+      '\nYou may need to set these manually in the Vercel dashboard.',
    );
  }

@@ -448,22 +569,22 @@ async function setEnvironmentVariables(
 }

 async function waitForDeployment(
-  vercelClient,
-  projectId,
-  maxWaitTime = 300000
-) {
+  vercelClient: Vercel | null,
+  projectId: string,
+  maxWaitTime = 300000,
+): Promise<any> {
  // 5 minutes
  console.log('\n⏳ Waiting for deployment to complete...');
  const startTime = Date.now();

  while (Date.now() - startTime < maxWaitTime) {
    try {
-      const deployments = await vercelClient.deployments.list({
+      const deployments = await vercelClient?.deployments.getDeployments({
        projectId: projectId,
        limit: 1,
      });

-      if (deployments.deployments?.[0]) {
+      if (deployments?.deployments?.[0]) {
        const deployment = deployments.deployments[0];
        console.log(`📊 Deployment status: ${deployment.state}`);

@@ -477,21 +598,24 @@ async function waitForDeployment(
        }

        // Still building, wait and check again
-        await new Promise((resolve) => setTimeout(resolve, 5000)); // Wait 5 seconds
+        await new Promise(resolve => setTimeout(resolve, 5000)); // Wait 5 seconds
      } else {
        console.log('⏳ No deployment found yet, waiting...');
-        await new Promise((resolve) => setTimeout(resolve, 5000));
+        await new Promise(resolve => setTimeout(resolve, 5000));
      }
-    } catch (error) {
+    } catch (error: unknown) {
+      if (error instanceof Error) {
        console.warn('⚠️  Could not check deployment status:', error.message);
-      await new Promise((resolve) => setTimeout(resolve, 5000));
+        await new Promise(resolve => setTimeout(resolve, 5000));
+      }
+      throw error;
    }
  }

  throw new Error('Deployment timed out after 5 minutes');
 }

-async function deployToVercel(useGitHub = false) {
+async function deployToVercel(useGitHub = false): Promise<void> {
  try {
    console.log('\n🚀 Deploying to Vercel...');

@@ -507,18 +631,18 @@ async function deployToVercel(useGitHub = false) {
            framework: 'nextjs',
          },
          null,
-          2
-        )
+          2,
+        ),
      );
    }

    // Set up Vercel project
    console.log('\n📦 Setting up Vercel project...');
    console.log(
-      'An initial deployment is required to get an assigned domain that can be used in the mini app manifest\n'
+      'An initial deployment is required to get an assigned domain that can be used in the mini app manifest\n',
    );
    console.log(
-      '\n⚠️ Note: choosing a longer, more unique project name will help avoid conflicts with other existing domains\n'
+      '\n⚠️ Note: choosing a longer, more unique project name will help avoid conflicts with other existing domains\n',
    );

    // Use spawn instead of execSync for better error handling
@@ -526,11 +650,11 @@ async function deployToVercel(useGitHub = false) {
    const vercelSetup = spawn('vercel', [], {
      cwd: projectRoot,
      stdio: 'inherit',
-      shell: process.platform === 'win32',
+      shell: process.platform === 'win32' ? true : undefined,
    });

-    await new Promise((resolve, reject) => {
-      vercelSetup.on('close', (code) => {
+    await new Promise<void>((resolve, reject) => {
+      vercelSetup.on('close', code => {
        if (code === 0 || code === null) {
          console.log('✅ Vercel project setup completed');
          resolve();
@@ -540,30 +664,33 @@ async function deployToVercel(useGitHub = false) {
        }
      });

-      vercelSetup.on('error', (error) => {
+      vercelSetup.on('error', error => {
        console.log('⚠️  Vercel setup command completed (this is normal)');
        resolve(); // Don't reject, as this is often expected
      });
    });

    // Wait a moment for project files to be written
-    await new Promise((resolve) => setTimeout(resolve, 2000));
+    await new Promise(resolve => setTimeout(resolve, 2000));

    // Load project info
-    let projectId;
+    let projectId: string;
    try {
      const projectJson = JSON.parse(
-        fs.readFileSync('.vercel/project.json', 'utf8')
+        fs.readFileSync('.vercel/project.json', 'utf8'),
      );
      projectId = projectJson.projectId;
-    } catch (error) {
+    } catch (error: unknown) {
+      if (error instanceof Error) {
        throw new Error(
-        'Failed to load project info. Please ensure the Vercel project was created successfully.'
+          'Failed to load project info. Please ensure the Vercel project was created successfully.',
        );
      }
+      throw error;
+    }

    // Get Vercel token and initialize SDK client
-    let vercelClient = null;
+    let vercelClient: Vercel | null = null;
    try {
      const token = await getVercelToken();
      if (token) {
@@ -572,30 +699,41 @@ async function deployToVercel(useGitHub = false) {
        });
        console.log('✅ Initialized Vercel SDK client');
      }
-    } catch (error) {
+    } catch (error: unknown) {
+      if (error instanceof Error) {
        console.warn(
-        '⚠️  Could not initialize Vercel SDK, falling back to CLI operations'
+          '⚠️  Could not initialize Vercel SDK, falling back to CLI operations',
        );
      }
+      throw error;
+    }

    // Get project details
    console.log('\n🔍 Getting project details...');
-    let domain;
-    let projectName;
+    let domain: string | undefined;
+    let projectName: string | undefined;

    if (vercelClient) {
      try {
-        const project = await vercelClient.projects.get({
-          idOrName: projectId,
-        });
+        const projects = await vercelClient.projects.getProjects({});
+        const project = projects.projects.find(
+          (p: any) => p.id === projectId || p.name === projectId,
+        );
+        if (project) {
          projectName = project.name;
          domain = `${projectName}.vercel.app`;
          console.log('🌐 Using project name for domain:', domain);
-      } catch (error) {
+        } else {
+          throw new Error('Project not found');
+        }
+      } catch (error: unknown) {
+        if (error instanceof Error) {
          console.warn(
-          '⚠️  Could not get project details via SDK, using CLI fallback'
+            '⚠️  Could not get project details via SDK, using CLI fallback',
          );
        }
+        throw error;
+      }
    }

    // Fallback to CLI method if SDK failed
@@ -606,7 +744,7 @@ async function deployToVercel(useGitHub = false) {
          {
            cwd: projectRoot,
            encoding: 'utf8',
-          }
+          },
        );

        const nameMatch = inspectOutput.match(/Name\s+([^\n]+)/);
@@ -622,39 +760,28 @@ async function deployToVercel(useGitHub = false) {
            console.log('🌐 Using project name for domain:', domain);
          } else {
            console.warn(
-              '⚠️  Could not determine project name from inspection, using fallback'
+              '⚠️  Could not determine project name from inspection, using fallback',
            );
            // Use a fallback domain based on project ID
            domain = `project-${projectId.slice(-8)}.vercel.app`;
            console.log('🌐 Using fallback domain:', domain);
          }
        }
-      } catch (error) {
+      } catch (error: unknown) {
+        if (error instanceof Error) {
          console.warn('⚠️  Could not inspect project, using fallback domain');
          // Use a fallback domain based on project ID
          domain = `project-${projectId.slice(-8)}.vercel.app`;
          console.log('🌐 Using fallback domain:', domain);
        }
+        throw error;
+      }
    }
-
-    // Generate mini app metadata
-    console.log('\n🔨 Generating mini app metadata...');
-
-    const webhookUrl =
-      process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID
-        ? `https://api.neynar.com/f/app/${process.env.NEYNAR_CLIENT_ID}/event`
-        : `https://${domain}/api/webhook`;
-
-    const miniAppMetadata = await generateFarcasterMetadata(domain, webhookUrl);
-    console.log('✅ Mini app metadata generated');

    // Prepare environment variables
    const nextAuthSecret =
      process.env.NEXTAUTH_SECRET || crypto.randomBytes(32).toString('hex');
    const vercelEnv = {
-      NEXTAUTH_SECRET: nextAuthSecret,
-      AUTH_SECRET: nextAuthSecret,
-      NEXTAUTH_URL: `https://${domain}`,
      NEXT_PUBLIC_URL: `https://${domain}`,

      ...(process.env.NEYNAR_API_KEY && {
@@ -666,12 +793,19 @@ async function deployToVercel(useGitHub = false) {
      ...(process.env.SPONSOR_SIGNER && {
        SPONSOR_SIGNER: process.env.SPONSOR_SIGNER,
      }),
-      ...(miniAppMetadata && { MINI_APP_METADATA: miniAppMetadata }),
+
+      // Include NextAuth environment variables if SEED_PHRASE is present (SIWN enabled)
+      ...(process.env.SEED_PHRASE && {
+        SEED_PHRASE: process.env.SEED_PHRASE,
+        NEXTAUTH_SECRET: nextAuthSecret,
+        AUTH_SECRET: nextAuthSecret,
+        NEXTAUTH_URL: `https://${domain}`,
+      }),

      ...Object.fromEntries(
        Object.entries(process.env).filter(([key]) =>
-          key.startsWith('NEXT_PUBLIC_')
-        )
+          key.startsWith('NEXT_PUBLIC_'),
+        ),
      ),
    };

@@ -680,7 +814,7 @@ async function deployToVercel(useGitHub = false) {
      vercelClient,
      projectId,
      vercelEnv,
-      projectRoot
+      projectRoot,
    );

    // Deploy the project
@@ -703,8 +837,8 @@ async function deployToVercel(useGitHub = false) {
      env: process.env,
    });

-    await new Promise((resolve, reject) => {
-      vercelDeploy.on('close', (code) => {
+    await new Promise<void>((resolve, reject) => {
+      vercelDeploy.on('close', code => {
        if (code === 0) {
          console.log('✅ Vercel deployment command completed');
          resolve();
@@ -714,24 +848,27 @@ async function deployToVercel(useGitHub = false) {
        }
      });

-      vercelDeploy.on('error', (error) => {
+      vercelDeploy.on('error', error => {
        console.error('❌ Vercel deployment error:', error.message);
        reject(error);
      });
    });

    // Wait for deployment to actually complete
-    let deployment;
+    let deployment: any;
    if (vercelClient) {
      try {
        deployment = await waitForDeployment(vercelClient, projectId);
-      } catch (error) {
+      } catch (error: unknown) {
+        if (error instanceof Error) {
          console.warn(
            '⚠️  Could not verify deployment completion:',
-          error.message
+            error.message,
          );
          console.log('ℹ️  Proceeding with domain verification...');
        }
+        throw error;
+      }
    }

    // Verify actual domain after deployment
@@ -742,43 +879,34 @@ async function deployToVercel(useGitHub = false) {
      try {
        actualDomain = deployment.url || domain;
        console.log('🌐 Verified actual domain:', actualDomain);
-      } catch (error) {
+      } catch (error: unknown) {
+        if (error instanceof Error) {
          console.warn(
-          '⚠️  Could not verify domain via SDK, using assumed domain'
+            '⚠️  Could not verify domain via SDK, using assumed domain',
          );
        }
+        throw error;
+      }
    }

    // Update environment variables if domain changed
    if (actualDomain !== domain) {
      console.log('🔄 Updating environment variables with correct domain...');

-      const webhookUrl =
-        process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID
-          ? `https://api.neynar.com/f/app/${process.env.NEYNAR_CLIENT_ID}/event`
-          : `https://${actualDomain}/api/webhook`;
-
-      const updatedEnv = {
-        NEXTAUTH_URL: `https://${actualDomain}`,
+      const updatedEnv: Record<string, string | object> = {
        NEXT_PUBLIC_URL: `https://${actualDomain}`,
      };

-      if (miniAppMetadata) {
-        const updatedMetadata = await generateFarcasterMetadata(
-          actualDomain,
-          fid,
-          await validateSeedPhrase(process.env.SEED_PHRASE),
-          process.env.SEED_PHRASE,
-          webhookUrl
-        );
-        updatedEnv.MINI_APP_METADATA = updatedMetadata;
+      // Include NextAuth URL if SEED_PHRASE is present (SIWN enabled)
+      if (process.env.SEED_PHRASE) {
+        updatedEnv.NEXTAUTH_URL = `https://${actualDomain}`;
      }

      await setEnvironmentVariables(
        vercelClient,
        projectId,
        updatedEnv,
-        projectRoot
+        projectRoot,
      );

      console.log('\n📦 Redeploying with correct domain...');
@@ -788,8 +916,8 @@ async function deployToVercel(useGitHub = false) {
        env: process.env,
      });

-      await new Promise((resolve, reject) => {
-        vercelRedeploy.on('close', (code) => {
+      await new Promise<void>((resolve, reject) => {
+        vercelRedeploy.on('close', code => {
          if (code === 0) {
            console.log('✅ Redeployment completed');
            resolve();
@@ -799,7 +927,7 @@ async function deployToVercel(useGitHub = false) {
          }
        });

-        vercelRedeploy.on('error', (error) => {
+        vercelRedeploy.on('error', error => {
          console.error('❌ Redeployment error:', error.message);
          reject(error);
        });
@@ -811,19 +939,33 @@ async function deployToVercel(useGitHub = false) {
    console.log('\n✨ Deployment complete! Your mini app is now live at:');
    console.log(`🌐 https://${domain}`);
    console.log(
-      '\n📝 You can manage your project at https://vercel.com/dashboard'
+      '\n📝 You can manage your project at https://vercel.com/dashboard',
    );
-  } catch (error) {
+    
+    // Remind user about account association if not already set
+    console.log(
+      `\n💡 Remember: If you haven't already signed your manifest, go to:`,
+    );
+    console.log(
+      `   https://farcaster.xyz/~/developers/mini-apps/manifest?domain=${domain}`,
+    );
+    console.log(
+      '   to complete the ownership transfer and update APP_ACCOUNT_ASSOCIATION in src/lib/constants.ts',
+    );
+  } catch (error: unknown) {
+    if (error instanceof Error) {
      console.error('\n❌ Deployment failed:', error.message);
      process.exit(1);
    }
+    throw error;
+  }
 }

-async function main() {
+async function main(): Promise<void> {
  try {
    console.log('🚀 Vercel Mini App Deployment (SDK Edition)');
    console.log(
-      'This script will deploy your mini app to Vercel using the Vercel SDK.'
+      'This script will deploy your mini app to Vercel using the Vercel SDK.',
    );
    console.log('\nThe script will:');
    console.log('1. Check for required environment variables');
@@ -834,7 +976,8 @@ async function main() {
    // Check if @vercel/sdk is installed
    try {
      await import('@vercel/sdk');
-    } catch (error) {
+    } catch (error: unknown) {
+      if (error instanceof Error) {
        console.log('📦 Installing @vercel/sdk...');
        execSync('npm install @vercel/sdk', {
          cwd: projectRoot,
@@ -842,6 +985,8 @@ async function main() {
        });
        console.log('✅ @vercel/sdk installed successfully');
      }
+      throw error;
+    }

    await checkRequiredEnvVars();

@@ -896,10 +1041,13 @@ async function main() {
    }

    await deployToVercel(useGitHub);
-  } catch (error) {
+  } catch (error: unknown) {
+    if (error instanceof Error) {
      console.error('\n❌ Error:', error.message);
      process.exit(1);
    }
+    throw error;
+  }
 }

 main();
--- a/scripts/dev.js
+++ b/scripts/dev.js
@@ -1,4 +1,3 @@
-import localtunnel from 'localtunnel';
 import { spawn } from 'child_process';
 import { createServer } from 'net';
 import dotenv from 'dotenv';
@@ -11,7 +10,6 @@ dotenv.config({ path: '.env.local' });
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const projectRoot = path.resolve(path.normalize(path.join(__dirname, '..')));

-let tunnel;
 let nextDev;
 let isCleaningUp = false;

@@ -97,52 +95,20 @@ async function startDev() {
    process.exit(1);
  }

-  const useTunnel = process.env.USE_TUNNEL === 'true';
-  let miniAppUrl;
+  const miniAppUrl = `http://localhost:${port}`;

-  if (useTunnel) {
-    // Start localtunnel and get URL
-    tunnel = await localtunnel({ port: port });
-    let ip;
-    try {
-      ip = await fetch('https://ipv4.icanhazip.com').then(res => res.text()).then(ip => ip.trim());
-    } catch (error) {
-      console.error('Error getting IP address:', error);
-    }
-
-    miniAppUrl = tunnel.url;
  console.log(`
-🌐 Local tunnel URL: ${tunnel.url}
+💻 Your mini app is running at: ${miniAppUrl}

-💻 To test on desktop:
-   1. Open the localtunnel URL in your browser: ${tunnel.url}
-   2. Enter your IP address in the password field${ip ? `: ${ip}` : ''} (note that this IP may be incorrect if you are using a VPN)
-   3. Click "Click to Submit" -- your mini app should now load in the browser
-   4. Navigate to the Warpcast Mini App Developer Tools: https://warpcast.com/~/developers
-   5. Enter your mini app URL: ${tunnel.url}
-   6. Click "Preview" to launch your mini app within Warpcast (note that it may take ~10 seconds to load)
+🌐 To test with the Farcaster preview tool:

-
-❗️ You will not be able to load your mini app in Warpcast until    ❗️
-❗️ you submit your IP address in the localtunnel password field ❗️
-
-
-📱 To test in Warpcast mobile app:
-   1. Open Warpcast on your phone
-   2. Go to Settings > Developer > Mini Apps
-   4. Enter this URL: ${tunnel.url}
-   5. Click "Preview" (note that it may take ~10 seconds to load)
-`);
-  } else {
-    miniAppUrl = `http://localhost:${port}`;
-    console.log(`
-💻 To test your mini app:
-   1. Open the Warpcast Mini App Developer Tools: https://warpcast.com/~/developers
-   2. Scroll down to the "Preview Mini App" tool
-   3. Enter this URL: ${miniAppUrl}
-   4. Click "Preview" to test your mini app (note that it may take ~5 seconds to load the first time)
-`);
-  }
+   1. Create a free ngrok account at https://ngrok.com/download/mac-os
+   2. Download and install ngrok following the instructions
+   3. In a NEW terminal window, run: ngrok http ${port}
+   4. Copy the forwarding URL (e.g., https://xxxx-xx-xx-xx-xx.ngrok-free.app)
+   5. Navigate to: https://farcaster.xyz/~/developers/mini-apps/preview
+   6. Enter your ngrok URL and click "Preview" to test your mini app
+`)
  
  // Start next dev with appropriate configuration
  const nextBin = path.normalize(path.join(projectRoot, 'node_modules', '.bin', 'next'));
@@ -182,15 +148,6 @@ async function startDev() {
        }
      }

-      if (tunnel) {
-        try {
-          await tunnel.close();
-          console.log('🌐 Tunnel closed');
-        } catch (e) {
-          console.log('Note: Tunnel already closed');
-        }
-      }
-
      // Force kill any remaining processes on the specified port
      await killProcessOnPort(port);
    } catch (error) {
@@ -204,9 +161,6 @@ async function startDev() {
  process.on('SIGINT', cleanup);
  process.on('SIGTERM', cleanup);
  process.on('exit', cleanup);
-  if (tunnel) {
-    tunnel.on('close', cleanup);
-  }
 }

 startDev().catch(console.error); 
--- a/src/app/.well-known/farcaster.json/route.ts
+++ b/src/app/.well-known/farcaster.json/route.ts
@@ -1,12 +1,13 @@
 import { NextResponse } from 'next/server';
-import { getFarcasterMetadata } from '../../../lib/utils';
+import { getFarcasterDomainManifest } from '~/lib/utils';

 export async function GET() {
  try {
-    const config = await getFarcasterMetadata();
+    const config = await getFarcasterDomainManifest();
    return NextResponse.json(config);
  } catch (error) {
    console.error('Error generating metadata:', error);
-    return NextResponse.json({ error: error.message }, { status: 500 });
+    const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+    return NextResponse.json({ error: errorMessage }, { status: 500 });
  }
 }
--- a/src/app/api/auth/update-session/route.ts
+++ b/src/app/api/auth/update-session/route.ts
@@ -1,46 +0,0 @@
-import { NextResponse } from 'next/server';
-import { getServerSession } from 'next-auth';
-import { authOptions } from '~/auth';
-
-export async function POST(request: Request) {
-  try {
-    const session = await getServerSession(authOptions);
-
-    if (!session?.user?.fid) {
-      return NextResponse.json(
-        { error: 'No authenticated session found' },
-        { status: 401 }
-      );
-    }
-
-    const body = await request.json();
-    const { signers, user } = body;
-
-    if (!signers || !user) {
-      return NextResponse.json(
-        { error: 'Signers and user are required' },
-        { status: 400 }
-      );
-    }
-
-    // For NextAuth to update the session, we need to trigger the JWT callback
-    // This is typically done by calling the session endpoint with updated data
-    // However, we can't directly modify the session token from here
-
-    // Instead, we'll store the data temporarily and let the client refresh the session
-    // The session will be updated when the JWT callback is triggered
-
-    return NextResponse.json({
-      success: true,
-      message: 'Session update prepared',
-      signers,
-      user,
-    });
-  } catch (error) {
-    console.error('Error preparing session update:', error);
-    return NextResponse.json(
-      { error: 'Failed to prepare session update' },
-      { status: 500 }
-    );
-  }
-}
--- a/src/app/api/auth/validate/route.ts
+++ b/src/app/api/auth/validate/route.ts
@@ -0,0 +1,46 @@
+import { NextResponse } from 'next/server';
+import { createClient, Errors } from '@farcaster/quick-auth';
+
+const client = createClient();
+
+export async function POST(request: Request) {
+  try {
+    const { token } = await request.json();
+
+    if (!token) {
+      return NextResponse.json({ error: 'Token is required' }, { status: 400 });
+    }
+
+    // Get domain from environment or request
+    const domain = process.env.NEXT_PUBLIC_URL
+      ? new URL(process.env.NEXT_PUBLIC_URL).hostname
+      : request.headers.get('host') || 'localhost';
+
+    try {
+      // Use the official QuickAuth library to verify the JWT
+      const payload = await client.verifyJwt({
+        token,
+        domain,
+      });
+
+      return NextResponse.json({
+        success: true,
+        user: {
+          fid: payload.sub,
+        },
+      });
+    } catch (e) {
+      if (e instanceof Errors.InvalidTokenError) {
+        console.info('Invalid token:', e.message);
+        return NextResponse.json({ error: 'Invalid token' }, { status: 401 });
+      }
+      throw e;
+    }
+  } catch (error) {
+    console.error('Token validation error:', error);
+    return NextResponse.json(
+      { error: 'Internal server error' },
+      { status: 500 },
+    );
+  }
+}
--- a/src/app/api/webhook/route.ts
+++ b/src/app/api/webhook/route.ts
@@ -56,7 +56,7 @@ export async function POST(request: NextRequest) {
  // Only handle notifications if Neynar is not enabled
  // When Neynar is enabled, notifications are handled through their webhook
  switch (event.event) {
-    case "frame_added":
+    case "miniapp_added":
      if (event.notificationDetails) {
        await setUserNotificationDetails(fid, event.notificationDetails);
        await sendMiniAppNotification({
@@ -69,7 +69,7 @@ export async function POST(request: NextRequest) {
      }
      break;

-    case "frame_removed":
+    case "miniapp_removed":
      await deleteUserNotificationDetails(fid);
      break;

--- a/src/app/layout.NeynarAuth.tsx
+++ b/src/app/layout.NeynarAuth.tsx
@@ -0,0 +1,29 @@
+import type { Metadata } from 'next';
+
+import { getSession } from '~/auth';
+import '~/app/globals.css';
+import { Providers } from '~/app/providers';
+import { APP_NAME, APP_DESCRIPTION } from '~/lib/constants';
+
+export const metadata: Metadata = {
+  title: APP_NAME,
+  description: APP_DESCRIPTION,
+};
+
+export default async function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  const session = await getSession();
+
+  return (
+    <html lang="en">
+      <body>
+        <Providers session={session}>
+          {children}
+        </Providers>
+      </body>
+    </html>
+  );
+}
--- a/src/app/layout.tsx
+++ b/src/app/layout.tsx
@@ -1,9 +1,8 @@
-import type { Metadata } from "next";
+import type { Metadata } from 'next';

-import { getSession } from "~/auth"
-import "~/app/globals.css";
-import { Providers } from "~/app/providers";
-import { APP_NAME, APP_DESCRIPTION } from "~/lib/constants";
+import '~/app/globals.css';
+import { Providers } from '~/app/providers';
+import { APP_NAME, APP_DESCRIPTION } from '~/lib/constants';

 export const metadata: Metadata = {
  title: APP_NAME,
@@ -15,12 +14,12 @@ export default async function RootLayout({
 }: Readonly<{
  children: React.ReactNode;
 }>) {
-  const session = await getSession()
-
  return (
    <html lang="en">
      <body>
-        <Providers session={session}>{children}</Providers>
+        <Providers>
+          {children}
+        </Providers>
      </body>
    </html>
  );
--- a/src/app/providers.NeynarAuth.tsx
+++ b/src/app/providers.NeynarAuth.tsx
@@ -0,0 +1,44 @@
+'use client';
+
+import dynamic from 'next/dynamic';
+import type { Session } from 'next-auth';
+import { SessionProvider } from 'next-auth/react';
+import { AuthKitProvider } from '@farcaster/auth-kit';
+import { MiniAppProvider } from '@neynar/react';
+import { SafeFarcasterSolanaProvider } from '~/components/providers/SafeFarcasterSolanaProvider';
+import { ANALYTICS_ENABLED, RETURN_URL } from '~/lib/constants';
+
+const WagmiProvider = dynamic(
+  () => import('~/components/providers/WagmiProvider'),
+  {
+    ssr: false,
+  }
+);
+
+export function Providers({
+  session,
+  children,
+}: {
+  session: Session | null;
+  children: React.ReactNode;
+}) {
+  const solanaEndpoint =
+    process.env.SOLANA_RPC_ENDPOINT || 'https://solana-rpc.publicnode.com';
+  return (
+    <SessionProvider session={session}>
+      <WagmiProvider>
+        <MiniAppProvider
+          analyticsEnabled={ANALYTICS_ENABLED}
+          backButtonEnabled={true}
+          returnUrl={RETURN_URL}
+        >
+          <SafeFarcasterSolanaProvider endpoint={solanaEndpoint}>
+            <AuthKitProvider config={{}}>
+              {children}
+            </AuthKitProvider>
+          </SafeFarcasterSolanaProvider>
+        </MiniAppProvider>
+      </WagmiProvider>
+    </SessionProvider>
+  );
+}
--- a/src/app/providers.tsx
+++ b/src/app/providers.tsx
@@ -1,12 +1,9 @@
 'use client';

 import dynamic from 'next/dynamic';
-import type { Session } from 'next-auth';
-import { SessionProvider } from 'next-auth/react';
 import { MiniAppProvider } from '@neynar/react';
 import { SafeFarcasterSolanaProvider } from '~/components/providers/SafeFarcasterSolanaProvider';
-import { ANALYTICS_ENABLED } from '~/lib/constants';
-import { AuthKitProvider } from '@farcaster/auth-kit';
+import { ANALYTICS_ENABLED, RETURN_URL } from '~/lib/constants';

 const WagmiProvider = dynamic(
  () => import('~/components/providers/WagmiProvider'),
@@ -16,26 +13,23 @@ const WagmiProvider = dynamic(
 );

 export function Providers({
-  session,
  children,
 }: {
-  session: Session | null;
  children: React.ReactNode;
 }) {
  const solanaEndpoint =
    process.env.SOLANA_RPC_ENDPOINT || 'https://solana-rpc.publicnode.com';
  return (
-    <SessionProvider session={session}>
    <WagmiProvider>
      <MiniAppProvider
        analyticsEnabled={ANALYTICS_ENABLED}
        backButtonEnabled={true}
+        returnUrl={RETURN_URL}
      >
        <SafeFarcasterSolanaProvider endpoint={solanaEndpoint}>
-            <AuthKitProvider config={{}}>{children}</AuthKitProvider>
+          {children}
        </SafeFarcasterSolanaProvider>
      </MiniAppProvider>
    </WagmiProvider>
-    </SessionProvider>
  );
 }
--- a/src/auth.ts
+++ b/src/auth.ts
@@ -217,74 +217,6 @@ function getDomainFromUrl(urlString: string | undefined): string {
 export const authOptions: AuthOptions = {
  // Configure one or more authentication providers
  providers: [
-    CredentialsProvider({
-      id: 'farcaster',
-      name: 'Sign in with Farcaster',
-      credentials: {
-        message: {
-          label: 'Message',
-          type: 'text',
-          placeholder: '0x0',
-        },
-        signature: {
-          label: 'Signature',
-          type: 'text',
-          placeholder: '0x0',
-        },
-        nonce: {
-          label: 'Nonce',
-          type: 'text',
-          placeholder: 'Custom nonce (optional)',
-        },
-        // In a production app with a server, these should be fetched from
-        // your Farcaster data indexer rather than have them accepted as part
-        // of credentials.
-        // question: should these natively use the Neynar API?
-        name: {
-          label: 'Name',
-          type: 'text',
-          placeholder: '0x0',
-        },
-        pfp: {
-          label: 'Pfp',
-          type: 'text',
-          placeholder: '0x0',
-        },
-      },
-      async authorize(credentials, req) {
-        const nonce = req?.body?.csrfToken;
-
-        if (!nonce) {
-          console.error('No nonce or CSRF token provided');
-          return null;
-        }
-        const appClient = createAppClient({
-          ethereum: viemConnector(),
-        });
-
-        const domain = getDomainFromUrl(process.env.NEXTAUTH_URL);
-
-        const verifyResponse = await appClient.verifySignInMessage({
-          message: credentials?.message as string,
-          signature: credentials?.signature as `0x${string}`,
-          domain,
-          nonce,
-        });
-
-        const { success, fid } = verifyResponse;
-
-        if (!success) {
-          return null;
-        }
-
-        return {
-          id: fid.toString(),
-          name: credentials?.name || `User ${fid}`,
-          image: credentials?.pfp || null,
-          provider: 'farcaster',
-        };
-      },
-    }),
    CredentialsProvider({
      id: 'neynar',
      name: 'Sign in with Neynar',
@@ -333,10 +265,18 @@ export const authOptions: AuthOptions = {
        try {
          // Validate the signature using Farcaster's auth client (same as Farcaster provider)
          const appClient = createAppClient({
+            // USE your own RPC URL or else you might get 401 error
            ethereum: viemConnector(),
          });

-          const domain = getDomainFromUrl(process.env.NEXTAUTH_URL);
+          const baseUrl =
+            process.env.VERCEL_ENV === 'production'
+              ? `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`
+              : process.env.VERCEL_URL
+                ? `https://${process.env.VERCEL_URL}`
+                : process.env.NEXTAUTH_URL || `http://localhost:${process.env.PORT ?? 3000}`;
+
+          const domain = getDomainFromUrl(baseUrl);

          const verifyResponse = await appClient.verifySignInMessage({
            message: credentials?.message as string,
@@ -377,12 +317,7 @@ export const authOptions: AuthOptions = {
      // Set provider at the root level
      session.provider = token.provider as string;

-      if (token.provider === 'farcaster') {
-        // For Farcaster, simple structure
-        session.user = {
-          fid: parseInt(token.sub ?? ''),
-        };
-      } else if (token.provider === 'neynar') {
+      if (token.provider === 'neynar') {
        // For Neynar, use full user data structure from user
        session.user = token.user as typeof session.user;
        session.signers = token.signers as typeof session.signers;
@@ -404,26 +339,26 @@ export const authOptions: AuthOptions = {
      name: `next-auth.session-token`,
      options: {
        httpOnly: true,
-        sameSite: 'none',
+        sameSite: process.env.NODE_ENV === 'production' ? 'none' : 'lax',
        path: '/',
-        secure: true,
+        secure: process.env.NODE_ENV === 'production',
      },
    },
    callbackUrl: {
      name: `next-auth.callback-url`,
      options: {
-        sameSite: 'none',
+        sameSite: process.env.NODE_ENV === 'production' ? 'none' : 'lax',
        path: '/',
-        secure: true,
+        secure: process.env.NODE_ENV === 'production',
      },
    },
    csrfToken: {
      name: `next-auth.csrf-token`,
      options: {
        httpOnly: true,
-        sameSite: 'none',
+        sameSite: process.env.NODE_ENV === 'production' ? 'none' : 'lax',
        path: '/',
-        secure: true,
+        secure: process.env.NODE_ENV === 'production',
      },
    },
  },
--- a/src/components/ui/NeynarAuthButton/AuthDialog.tsx
+++ b/src/components/ui/NeynarAuthButton/AuthDialog.tsx
@@ -118,7 +118,7 @@ export function AuthDialog({
  const content = getStepContent();

  return (
-    <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/50 backdrop-blur-sm p-4">
+    <div className="fixed inset-0 z-[100] flex items-center justify-center bg-black/50 backdrop-blur-sm p-4">
      <div className="bg-white dark:bg-gray-800 rounded-xl w-full max-w-md shadow-2xl border border-gray-200 dark:border-gray-700 max-h-[80vh] sm:max-h-[90vh] flex flex-col">
        <div className="flex justify-between items-center p-4 sm:p-6 pb-3 sm:pb-4 border-b border-gray-200 dark:border-gray-700 flex-shrink-0">
          <h2 className="text-lg font-semibold text-gray-900 dark:text-gray-100">
@@ -191,7 +191,8 @@ export function AuthDialog({

              {content.showOpenButton && content.qrUrl && (
                <button
-                  onClick={() =>
+                  onClick={() => {
+                    if (content.qrUrl) {
                      window.open(
                        content.qrUrl
                          .replace(
@@ -199,12 +200,13 @@ export function AuthDialog({
                            'https://client.farcaster.xyz/deeplinks/'
                          )
                          .replace(
-                          'https://client.farcaster.xyz/deeplinks/',
-                          'farcaster://'
+                            'https://client.farcaster.xyz/deeplinks/signed-key-request',
+                            'https://farcaster.xyz/~/connect'
                          ),
                        '_blank'
-                    )
+                      );
                    }
+                  }}
                  className="btn btn-outline flex items-center justify-center gap-2 w-full"
                >
                  I&apos;m using my phone →
--- a/src/components/ui/NeynarAuthButton/index.tsx
+++ b/src/components/ui/NeynarAuthButton/index.tsx
@@ -1,21 +1,27 @@
 'use client';

+/**
+ * This authentication system is designed to work both in a regular web browser and inside a miniapp.
+ * In other words, it supports authentication when the miniapp context is not present (web browser) as well as when the app is running inside the miniapp.
+ * If you only need authentication for a web application, follow the Webapp flow;
+ * if you only need authentication inside a miniapp, follow the Miniapp flow.
+ */
+
 import '@farcaster/auth-kit/styles.css';
-import { useSignIn } from '@farcaster/auth-kit';
-import { useCallback, useEffect, useState } from 'react';
+import { useSignIn, UseSignInData } from '@farcaster/auth-kit';
+import { useCallback, useEffect, useState, useRef } from 'react';
 import { cn } from '~/lib/utils';
 import { Button } from '~/components/ui/Button';
-import { isMobile } from '~/lib/devices';
 import { ProfileButton } from '~/components/ui/NeynarAuthButton/ProfileButton';
 import { AuthDialog } from '~/components/ui/NeynarAuthButton/AuthDialog';
 import { getItem, removeItem, setItem } from '~/lib/localStorage';
 import { useMiniApp } from '@neynar/react';
 import {
-  signIn as backendSignIn,
-  signOut as backendSignOut,
+  signIn as miniappSignIn,
+  signOut as miniappSignOut,
  useSession,
 } from 'next-auth/react';
-import sdk, { SignIn as SignInCore } from '@farcaster/frame-sdk';
+import sdk, { SignIn as SignInCore } from '@farcaster/miniapp-sdk';

 type User = {
  fid: number;
@@ -113,9 +119,11 @@ export function NeynarAuthButton() {
  );
  const [message, setMessage] = useState<string | null>(null);
  const [signature, setSignature] = useState<string | null>(null);
+  const [isSignerFlowRunning, setIsSignerFlowRunning] = useState(false);
+  const signerFlowStartedRef = useRef(false);

  // Determine which flow to use based on context
-  const useBackendFlow = context !== undefined;
+  const useMiniappFlow = context !== undefined;

  // Helper function to create a signer
  const createSigner = useCallback(async () => {
@@ -136,16 +144,16 @@ export function NeynarAuthButton() {
    }
  }, []);

-  // Helper function to update session with signers (backend flow only)
+  // Helper function to update session with signers (miniapp flow only)
  const updateSessionWithSigners = useCallback(
    async (
      signers: StoredAuthState['signers'],
      user: StoredAuthState['user']
    ) => {
-      if (!useBackendFlow) return;
+      if (!useMiniappFlow) return;

      try {
-        // For backend flow, we need to sign in again with the additional data
+        // For miniapp flow, we need to sign in again with the additional data
        if (message && signature) {
          const signInData = {
            message,
@@ -157,13 +165,13 @@ export function NeynarAuthButton() {
            user: JSON.stringify(user),
          };

-          await backendSignIn('neynar', signInData);
+          await miniappSignIn('neynar', signInData);
        }
      } catch (error) {
        console.error('❌ Error updating session with signers:', error);
      }
    },
-    [useBackendFlow, message, signature, nonce]
+    [useMiniappFlow, message, signature, nonce]
  );

  // Helper function to fetch user data from Neynar API
@@ -230,7 +238,7 @@ export function NeynarAuthButton() {
      try {
        setSignersLoading(true);

-        const endpoint = useBackendFlow
+        const endpoint = useMiniappFlow
          ? `/api/auth/session-signers?message=${encodeURIComponent(
              message
            )}&signature=${signature}`
@@ -242,8 +250,8 @@ export function NeynarAuthButton() {
        const signerData = await response.json();

        if (response.ok) {
-          if (useBackendFlow) {
-            // For backend flow, update session with signers
+          if (useMiniappFlow) {
+            // For miniapp flow, update session with signers
            if (signerData.signers && signerData.signers.length > 0) {
              const user =
                signerData.user ||
@@ -252,7 +260,7 @@ export function NeynarAuthButton() {
            }
            return signerData.signers;
          } else {
-            // For frontend flow, store in localStorage
+            // For webapp flow, store in localStorage
            let user: StoredAuthState['user'] | null = null;

            if (signerData.signers && signerData.signers.length > 0) {
@@ -284,20 +292,52 @@ export function NeynarAuthButton() {
        setSignersLoading(false);
      }
    },
-    [useBackendFlow, fetchUserData, updateSessionWithSigners]
+    [useMiniappFlow, fetchUserData, updateSessionWithSigners]
  );

  // Helper function to poll signer status
  const startPolling = useCallback(
    (signerUuid: string, message: string, signature: string) => {
+      // Clear any existing polling interval before starting a new one
+      if (pollingInterval) {
+        clearInterval(pollingInterval);
+      }
+
+      let retryCount = 0;
+      const maxRetries = 10; // Maximum 10 retries (20 seconds total)
+      const maxPollingTime = 60000; // Maximum 60 seconds of polling
+      const startTime = Date.now();
+
      const interval = setInterval(async () => {
+        // Check if we've been polling too long
+        if (Date.now() - startTime > maxPollingTime) {
+          clearInterval(interval);
+          setPollingInterval(null);
+          return;
+        }
+
        try {
          const response = await fetch(
            `/api/auth/signer?signerUuid=${signerUuid}`
          );

          if (!response.ok) {
-            throw new Error('Failed to poll signer status');
+            // Check if it's a rate limit error
+            if (response.status === 429) {
+              clearInterval(interval);
+              setPollingInterval(null);
+              return;
+            }
+
+            // Increment retry count for other errors
+            retryCount++;
+            if (retryCount >= maxRetries) {
+              clearInterval(interval);
+              setPollingInterval(null);
+              return;
+            }
+
+            throw new Error(`Failed to poll signer status: ${response.status}`);
          }

          const signerData = await response.json();
@@ -319,7 +359,7 @@ export function NeynarAuthButton() {

      setPollingInterval(interval);
    },
-    [fetchAllSigners]
+    [fetchAllSigners, pollingInterval]
  );

  // Cleanup polling on unmount
@@ -328,6 +368,7 @@ export function NeynarAuthButton() {
      if (pollingInterval) {
        clearInterval(pollingInterval);
      }
+      signerFlowStartedRef.current = false;
    };
  }, [pollingInterval]);

@@ -350,23 +391,23 @@ export function NeynarAuthButton() {
    generateNonce();
  }, []);

-  // Load stored auth state on mount (only for frontend flow)
+  // Load stored auth state on mount (only for webapp flow)
  useEffect(() => {
-    if (!useBackendFlow) {
+    if (!useMiniappFlow) {
      const stored = getItem<StoredAuthState>(STORAGE_KEY);
      if (stored && stored.isAuthenticated) {
        setStoredAuth(stored);
      }
    }
-  }, [useBackendFlow]);
+  }, [useMiniappFlow]);

  // Success callback - this is critical!
  const onSuccessCallback = useCallback(
-    async (res: unknown) => {
-      if (!useBackendFlow) {
-        // Only handle localStorage for frontend flow
+    async (res: UseSignInData) => {
+      if (!useMiniappFlow) {
+        // Only handle localStorage for webapp flow
        const existingAuth = getItem<StoredAuthState>(STORAGE_KEY);
-        const user = await fetchUserData(res.fid);
+        const user = res.fid ? await fetchUserData(res.fid) : null;
        const authState: StoredAuthState = {
          ...existingAuth,
          isAuthenticated: true,
@@ -376,9 +417,9 @@ export function NeynarAuthButton() {
        setItem<StoredAuthState>(STORAGE_KEY, authState);
        setStoredAuth(authState);
      }
-      // For backend flow, the session will be handled by NextAuth
+      // For miniapp flow, the session will be handled by NextAuth
    },
-    [useBackendFlow, fetchUserData]
+    [useMiniappFlow, fetchUserData]
  );

  // Error callback
@@ -393,8 +434,8 @@ export function NeynarAuthButton() {
  });

  const {
-    signIn: frontendSignIn,
-    signOut: frontendSignOut,
+    signIn: webappSignIn,
+    signOut: webappSignOut,
    connect,
    reconnect,
    isSuccess,
@@ -409,19 +450,32 @@ export function NeynarAuthButton() {
  useEffect(() => {
    setMessage(data?.message || null);
    setSignature(data?.signature || null);
+
+    // Reset the signer flow flag when message/signature change
+    if (data?.message && data?.signature) {
+      signerFlowStartedRef.current = false;
+    }
  }, [data?.message, data?.signature]);

-  // Connect for frontend flow when nonce is available
+  // Connect for webapp flow when nonce is available
  useEffect(() => {
-    if (!useBackendFlow && nonce && !channelToken) {
+    if (!useMiniappFlow && nonce && !channelToken) {
      connect();
    }
-  }, [useBackendFlow, nonce, channelToken, connect]);
+  }, [useMiniappFlow, nonce, channelToken, connect]);

  // Handle fetching signers after successful authentication
  useEffect(() => {
-    if (message && signature) {
+    if (
+      message &&
+      signature &&
+      !isSignerFlowRunning &&
+      !signerFlowStartedRef.current
+    ) {
+      signerFlowStartedRef.current = true;
+
      const handleSignerFlow = async () => {
+        setIsSignerFlowRunning(true);
        try {
          const clientContext = context?.client as Record<string, unknown>;
          const isMobileContext =
@@ -431,13 +485,14 @@ export function NeynarAuthButton() {
          // Step 1: Change to loading state
          setDialogStep('loading');

-          // Show dialog if not using backend flow or in browser farcaster
-          if ((useBackendFlow && !isMobileContext) || !useBackendFlow)
+          // Show dialog if not using miniapp flow or in browser farcaster
+          if ((useMiniappFlow && !isMobileContext) || !useMiniappFlow)
            setShowDialog(true);

          // First, fetch existing signers
          const signers = await fetchAllSigners(message, signature);
-          if (useBackendFlow && isMobileContext) setSignersLoading(true);
+
+          if (useMiniappFlow && isMobileContext) setSignersLoading(true);

          // Check if no signers exist or if we have empty signers
          if (!signers || signers.length === 0) {
@@ -457,8 +512,8 @@ export function NeynarAuthButton() {
              setShowDialog(false);
              await sdk.actions.openUrl(
                signedKeyData.signer_approval_url.replace(
-                  'https://client.farcaster.xyz/deeplinks/',
-                  'farcaster://'
+                  'https://client.farcaster.xyz/deeplinks/signed-key-request',
+                  'https://farcaster.xyz/~/connect'
                )
              );
            } else {
@@ -481,26 +536,19 @@ export function NeynarAuthButton() {
          setSignersLoading(false);
          setShowDialog(false);
          setSignerApprovalUrl(null);
+        } finally {
+          setIsSignerFlowRunning(false);
        }
      };

      handleSignerFlow();
    }
-  }, [
-    message,
-    signature,
-    fetchAllSigners,
-    createSigner,
-    generateSignedKeyRequest,
-    startPolling,
-    context,
-    useBackendFlow,
-  ]);
+  }, [message, signature]); // Simplified dependencies

-  // Backend flow using NextAuth
-  const handleBackendSignIn = useCallback(async () => {
+  // Miniapp flow using NextAuth
+  const handleMiniappSignIn = useCallback(async () => {
    if (!nonce) {
-      console.error('❌ No nonce available for backend sign-in');
+      console.error('❌ No nonce available for miniapp sign-in');
      return;
    }

@@ -515,7 +563,7 @@ export function NeynarAuthButton() {
        nonce: nonce,
      };

-      const nextAuthResult = await backendSignIn('neynar', signInData);
+      const nextAuthResult = await miniappSignIn('neynar', signInData);
      if (nextAuthResult?.ok) {
        setMessage(result.message);
        setSignature(result.signature);
@@ -526,32 +574,34 @@ export function NeynarAuthButton() {
      if (e instanceof SignInCore.RejectedByUser) {
        console.log('ℹ️ Sign-in rejected by user');
      } else {
-        console.error('❌ Backend sign-in error:', e);
+        console.error('❌ Miniapp sign-in error:', e);
      }
+    } finally {
+      setSignersLoading(false);
    }
  }, [nonce]);

-  const handleFrontEndSignIn = useCallback(() => {
+  const handleWebappSignIn = useCallback(() => {
    if (isError) {
      reconnect();
    }
    setDialogStep('signin');
    setShowDialog(true);
-    frontendSignIn();
-  }, [isError, reconnect, frontendSignIn]);
+    webappSignIn();
+  }, [isError, reconnect, webappSignIn]);

  const handleSignOut = useCallback(async () => {
    try {
      setSignersLoading(true);

-      if (useBackendFlow) {
+      if (useMiniappFlow) {
        // Only sign out from NextAuth if the current session is from Neynar provider
        if (session?.provider === 'neynar') {
-          await backendSignOut({ redirect: false });
+          await miniappSignOut({ redirect: false });
        }
      } else {
-        // Frontend flow sign out
-        frontendSignOut();
+        // Webapp flow sign out
+        webappSignOut();
        removeItem(STORAGE_KEY);
        setStoredAuth(null);
      }
@@ -568,15 +618,18 @@ export function NeynarAuthButton() {
        clearInterval(pollingInterval);
        setPollingInterval(null);
      }
+
+      // Reset signer flow flag
+      signerFlowStartedRef.current = false;
    } catch (error) {
      console.error('❌ Error during sign out:', error);
      // Optionally handle error state
    } finally {
      setSignersLoading(false);
    }
-  }, [useBackendFlow, frontendSignOut, pollingInterval, session]);
+  }, [useMiniappFlow, webappSignOut, pollingInterval, session]);

-  const authenticated = useBackendFlow
+  const authenticated = useMiniappFlow
    ? !!(
        session?.provider === 'neynar' &&
        session?.user?.fid &&
@@ -586,7 +639,7 @@ export function NeynarAuthButton() {
    : ((isSuccess && validSignature) || storedAuth?.isAuthenticated) &&
      !!(storedAuth?.signers && storedAuth.signers.length > 0);

-  const userData = useBackendFlow
+  const userData = useMiniappFlow
    ? {
        fid: session?.user?.fid,
        username: session?.user?.username || '',
@@ -618,16 +671,16 @@ export function NeynarAuthButton() {
        <ProfileButton userData={userData} onSignOut={handleSignOut} />
      ) : (
        <Button
-          onClick={useBackendFlow ? handleBackendSignIn : handleFrontEndSignIn}
-          disabled={!useBackendFlow && !url}
+          onClick={useMiniappFlow ? handleMiniappSignIn : handleWebappSignIn}
+          disabled={!useMiniappFlow && !url}
          className={cn(
            'btn btn-primary flex items-center gap-3',
            'disabled:opacity-50 disabled:cursor-not-allowed',
            'transform transition-all duration-200 active:scale-[0.98]',
-            !url && !useBackendFlow && 'cursor-not-allowed'
+            !url && !useMiniappFlow && 'cursor-not-allowed'
          )}
        >
-          {!useBackendFlow && !url ? (
+          {!useMiniappFlow && !url ? (
            <>
              <div className="spinner-primary w-5 h-5" />
              <span>Initializing...</span>
--- a/src/components/ui/Share.tsx
+++ b/src/components/ui/Share.tsx
@@ -4,6 +4,7 @@ import { useCallback, useState, useEffect } from 'react';
 import { Button } from './Button';
 import { useMiniApp } from '@neynar/react';
 import { type ComposeCast } from "@farcaster/miniapp-sdk";
+import { APP_URL } from '~/lib/constants';

 interface EmbedConfig {
  path?: string;
@@ -72,7 +73,7 @@ export function ShareButton({ buttonText, cast, className = '', isLoading = fals
            return embed;
          }
          if (embed.path) {
-            const baseUrl = process.env.NEXT_PUBLIC_URL || window.location.origin;
+            const baseUrl = APP_URL || window.location.origin;
            const url = new URL(`${baseUrl}${embed.path}`);

            // Add UTM parameters
--- a/src/components/ui/tabs/ActionsTab.NeynarAuth.tsx
+++ b/src/components/ui/tabs/ActionsTab.NeynarAuth.tsx
@@ -0,0 +1,208 @@
+'use client';
+
+import { useCallback, useState } from 'react';
+import { useMiniApp } from '@neynar/react';
+import { ShareButton } from '../Share';
+import { Button } from '../Button';
+import { SignIn } from '../wallet/SignIn';
+import { type Haptics } from '@farcaster/miniapp-sdk';
+import { APP_URL } from '~/lib/constants';
+import { NeynarAuthButton } from '../NeynarAuthButton';
+
+/**
+ * ActionsTab component handles mini app actions like sharing, notifications, and haptic feedback.
+ *
+ * This component provides the main interaction interface for users to:
+ * - Share the mini app with others
+ * - Sign in with Farcaster
+ * - Send notifications to their account
+ * - Trigger haptic feedback
+ * - Add the mini app to their client
+ * - Copy share URLs
+ *
+ * The component uses the useMiniApp hook to access Farcaster context and actions.
+ * All state is managed locally within this component.
+ *
+ * @example
+ * ```tsx
+ * <ActionsTab />
+ * ```
+ */
+export function ActionsTab() {
+  // --- Hooks ---
+  const { actions, added, notificationDetails, haptics, context } =
+    useMiniApp();
+
+  // --- State ---
+  const [notificationState, setNotificationState] = useState({
+    sendStatus: '',
+    shareUrlCopied: false,
+  });
+  const [selectedHapticIntensity, setSelectedHapticIntensity] =
+    useState<Haptics.ImpactOccurredType>('medium');
+
+  // --- Handlers ---
+  /**
+   * Sends a notification to the current user's Farcaster account.
+   *
+   * This function makes a POST request to the /api/send-notification endpoint
+   * with the user's FID and notification details. It handles different response
+   * statuses including success (200), rate limiting (429), and errors.
+   *
+   * @returns Promise that resolves when the notification is sent or fails
+   */
+  const sendFarcasterNotification = useCallback(async () => {
+    setNotificationState((prev) => ({ ...prev, sendStatus: '' }));
+    if (!notificationDetails || !context) {
+      return;
+    }
+    try {
+      const response = await fetch('/api/send-notification', {
+        method: 'POST',
+        mode: 'same-origin',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          fid: context.user.fid,
+          notificationDetails,
+        }),
+      });
+      if (response.status === 200) {
+        setNotificationState((prev) => ({ ...prev, sendStatus: 'Success' }));
+        return;
+      } else if (response.status === 429) {
+        setNotificationState((prev) => ({
+          ...prev,
+          sendStatus: 'Rate limited',
+        }));
+        return;
+      }
+      const responseText = await response.text();
+      setNotificationState((prev) => ({
+        ...prev,
+        sendStatus: `Error: ${responseText}`,
+      }));
+    } catch (error) {
+      setNotificationState((prev) => ({
+        ...prev,
+        sendStatus: `Error: ${error}`,
+      }));
+    }
+  }, [context, notificationDetails]);
+
+  /**
+   * Copies the share URL for the current user to the clipboard.
+   *
+   * This function generates a share URL using the user's FID and copies it
+   * to the clipboard. It shows a temporary "Copied!" message for 2 seconds.
+   */
+  const copyUserShareUrl = useCallback(async () => {
+    if (context?.user?.fid) {
+      const userShareUrl = `${APP_URL}/share/${context.user.fid}`;
+      await navigator.clipboard.writeText(userShareUrl);
+      setNotificationState((prev) => ({ ...prev, shareUrlCopied: true }));
+      setTimeout(
+        () =>
+          setNotificationState((prev) => ({ ...prev, shareUrlCopied: false })),
+        2000
+      );
+    }
+  }, [context?.user?.fid]);
+
+  /**
+   * Triggers haptic feedback with the selected intensity.
+   *
+   * This function calls the haptics.impactOccurred method with the current
+   * selectedHapticIntensity setting. It handles errors gracefully by logging them.
+   */
+  const triggerHapticFeedback = useCallback(async () => {
+    try {
+      await haptics.impactOccurred(selectedHapticIntensity);
+    } catch (error) {
+      console.error('Haptic feedback failed:', error);
+    }
+  }, [haptics, selectedHapticIntensity]);
+
+  // --- Render ---
+  return (
+    <div className="space-y-3 px-6 w-full max-w-md mx-auto">
+      {/* Share functionality */}
+      <ShareButton
+        buttonText="Share Mini App"
+        cast={{
+          text: 'Check out this awesome frame @1 @2 @3! 🚀🪐',
+          bestFriends: true,
+          embeds: [`${APP_URL}/share/${context?.user?.fid || ''}`],
+        }}
+        className="w-full"
+      />
+
+      {/* Authentication */}
+      <SignIn />
+
+      {/* Neynar Authentication */}
+      <NeynarAuthButton />
+
+      {/* Mini app actions */}
+      <Button
+        onClick={() =>
+          actions.openUrl('https://www.youtube.com/watch?v=dQw4w9WgXcQ')
+        }
+        className="w-full"
+      >
+        Open Link
+      </Button>
+
+      <Button onClick={actions.addMiniApp} disabled={added} className="w-full">
+        Add Mini App to Client
+      </Button>
+
+      {/* Notification functionality */}
+      {notificationState.sendStatus && (
+        <div className="text-sm w-full">
+          Send notification result: {notificationState.sendStatus}
+        </div>
+      )}
+      <Button
+        onClick={sendFarcasterNotification}
+        disabled={!notificationDetails}
+        className="w-full"
+      >
+        Send notification
+      </Button>
+
+      {/* Share URL copying */}
+      <Button
+        onClick={copyUserShareUrl}
+        disabled={!context?.user?.fid}
+        className="w-full"
+      >
+        {notificationState.shareUrlCopied ? 'Copied!' : 'Copy share URL'}
+      </Button>
+
+      {/* Haptic feedback controls */}
+      <div className="space-y-2">
+        <label className="block text-sm font-medium text-gray-700 dark:text-gray-300">
+          Haptic Intensity
+        </label>
+        <select
+          value={selectedHapticIntensity}
+          onChange={(e) =>
+            setSelectedHapticIntensity(
+              e.target.value as Haptics.ImpactOccurredType
+            )
+          }
+          className="w-full px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-md bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-primary"
+        >
+          <option value={'light'}>Light</option>
+          <option value={'medium'}>Medium</option>
+          <option value={'heavy'}>Heavy</option>
+          <option value={'soft'}>Soft</option>
+          <option value={'rigid'}>Rigid</option>
+        </select>
+        <Button onClick={triggerHapticFeedback} className="w-full">
+          Trigger Haptic Feedback
+        </Button>
+      </div>
+    </div>
+  );
+}
--- a/src/components/ui/tabs/ActionsTab.tsx
+++ b/src/components/ui/tabs/ActionsTab.tsx
@@ -1,12 +1,12 @@
 'use client';

-import { useCallback, useState } from "react";
-import { useMiniApp } from "@neynar/react";
-import { ShareButton } from "../Share";
-import { Button } from "../Button";
-import { SignIn } from "../wallet/SignIn";
-import { type Haptics } from "@farcaster/miniapp-sdk";
-import { NeynarAuthButton } from '../NeynarAuthButton/index';
+import { useCallback, useState } from 'react';
+import { useMiniApp } from '@neynar/react';
+import { ShareButton } from '../Share';
+import { Button } from '../Button';
+import { SignIn } from '../wallet/SignIn';
+import { type Haptics } from '@farcaster/miniapp-sdk';
+import { APP_URL } from '~/lib/constants';

 /**
 * ActionsTab component handles mini app actions like sharing, notifications, and haptic feedback.
@@ -96,7 +96,7 @@ export function ActionsTab() {
   */
  const copyUserShareUrl = useCallback(async () => {
    if (context?.user?.fid) {
-      const userShareUrl = `${process.env.NEXT_PUBLIC_URL}/share/${context.user.fid}`;
+      const userShareUrl = `${APP_URL}/share/${context.user.fid}`;
      await navigator.clipboard.writeText(userShareUrl);
      setNotificationState((prev) => ({ ...prev, shareUrlCopied: true }));
      setTimeout(
@@ -123,50 +123,45 @@ export function ActionsTab() {

  // --- Render ---
  return (
-    <div className='space-y-3 px-6 w-full max-w-md mx-auto'>
+    <div className="space-y-3 px-6 w-full max-w-md mx-auto">
      {/* Share functionality */}
      <ShareButton
-        buttonText='Share Mini App'
+        buttonText="Share Mini App"
        cast={{
          text: 'Check out this awesome frame @1 @2 @3! 🚀🪐',
          bestFriends: true,
-          embeds: [
-            `${process.env.NEXT_PUBLIC_URL}/share/${context?.user?.fid || ''}`,
-          ],
+          embeds: [`${APP_URL}/share/${context?.user?.fid || ''}`],
        }}
-        className='w-full'
+        className="w-full"
      />

      {/* Authentication */}
      <SignIn />

-      {/* Neynar Authentication */}
-      <NeynarAuthButton />
-
      {/* Mini app actions */}
      <Button
        onClick={() =>
          actions.openUrl('https://www.youtube.com/watch?v=dQw4w9WgXcQ')
        }
-        className='w-full'
+        className="w-full"
      >
        Open Link
      </Button>

-      <Button onClick={actions.addMiniApp} disabled={added} className='w-full'>
+      <Button onClick={actions.addMiniApp} disabled={added} className="w-full">
        Add Mini App to Client
      </Button>

      {/* Notification functionality */}
      {notificationState.sendStatus && (
-        <div className='text-sm w-full'>
+        <div className="text-sm w-full">
          Send notification result: {notificationState.sendStatus}
        </div>
      )}
      <Button
        onClick={sendFarcasterNotification}
        disabled={!notificationDetails}
-        className='w-full'
+        className="w-full"
      >
        Send notification
      </Button>
@@ -175,14 +170,14 @@ export function ActionsTab() {
      <Button
        onClick={copyUserShareUrl}
        disabled={!context?.user?.fid}
-        className='w-full'
+        className="w-full"
      >
        {notificationState.shareUrlCopied ? 'Copied!' : 'Copy share URL'}
      </Button>

      {/* Haptic feedback controls */}
-      <div className='space-y-2'>
-        <label className='block text-sm font-medium text-gray-700 dark:text-gray-300'>
+      <div className="space-y-2">
+        <label className="block text-sm font-medium text-gray-700 dark:text-gray-300">
          Haptic Intensity
        </label>
        <select
@@ -192,7 +187,7 @@ export function ActionsTab() {
              e.target.value as Haptics.ImpactOccurredType
            )
          }
-          className='w-full px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-md bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-primary'
+          className="w-full px-3 py-2 border border-gray-300 dark:border-gray-600 rounded-md bg-white dark:bg-gray-800 text-gray-900 dark:text-gray-100 focus:outline-none focus:ring-2 focus:ring-primary"
        >
          <option value={'light'}>Light</option>
          <option value={'medium'}>Medium</option>
@@ -200,7 +195,7 @@ export function ActionsTab() {
          <option value={'soft'}>Soft</option>
          <option value={'rigid'}>Rigid</option>
        </select>
-        <Button onClick={triggerHapticFeedback} className='w-full'>
+        <Button onClick={triggerHapticFeedback} className="w-full">
          Trigger Haptic Feedback
        </Button>
      </div>
--- a/src/components/ui/wallet/SendEth.tsx
+++ b/src/components/ui/wallet/SendEth.tsx
@@ -2,7 +2,7 @@

 import { useCallback, useMemo } from "react";
 import { useAccount, useSendTransaction, useWaitForTransactionReceipt } from "wagmi";
-import { base } from "wagmi/chains";
+import { arbitrum, base, mainnet, optimism, polygon, scroll, shape, zkSync, zora } from "wagmi/chains";
 import { Button } from "../Button";
 import { truncateAddress } from "../../../lib/truncateAddress";
 import { renderError } from "../../../lib/errorUtils";
@@ -45,17 +45,36 @@ export function SendEth() {
  /**
   * Determines the recipient address based on the current chain.
   *
-   * Uses different protocol guild addresses for different chains:
-   * - Base: 0x32e3C7fD24e175701A35c224f2238d18439C7dBC
-   * - Other chains: 0xB3d8d7887693a9852734b4D25e9C0Bb35Ba8a830
+   * Uses different protocol guild addresses for different chains.
+   * Defaults to Ethereum mainnet address if chain is not recognized.
+   * Addresses are taken from the protocol guilds documentation: https://protocol-guild.readthedocs.io/en/latest/
   *
   * @returns string - The recipient address for the current chain
   */
  const protocolGuildRecipientAddress = useMemo(() => {
-    // Protocol guild address
-    return chainId === base.id
-      ? "0x32e3C7fD24e175701A35c224f2238d18439C7dBC"
-      : "0xB3d8d7887693a9852734b4D25e9C0Bb35Ba8a830";
+    switch (chainId) {
+      case mainnet.id:
+        return "0x25941dC771bB64514Fc8abBce970307Fb9d477e9";
+      case arbitrum.id:
+        return "0x7F8DCFd764bA8e9B3BA577dC641D5c664B74c47b";
+      case base.id:
+        return "0xd16713A5D4Eb7E3aAc9D2228eB72f6f7328FADBD";
+      case optimism.id:
+        return "0x58ae0925077527a87D3B785aDecA018F9977Ec34";
+      case polygon.id:
+        return "0xccccEbdBdA2D68bABA6da99449b9CA41Dba9d4FF";
+      case scroll.id:
+        return "0xccccEbdBdA2D68bABA6da99449b9CA41Dba9d4FF";
+      case shape.id:
+        return "0x700fccD433E878F1AF9B64A433Cb2E09f5226CE8";
+      case zkSync.id:
+        return "0x9fb5F754f5222449F98b904a34494cB21AADFdf8";
+      case zora.id:
+        return "0x32e3C7fD24e175701A35c224f2238d18439C7dBC";
+      default:
+        // Default to Ethereum mainnet address
+        return "0x25941dC771bB64514Fc8abBce970307Fb9d477e9";
+    }
  }, [chainId]);

  // --- Handlers ---
--- a/src/components/ui/wallet/SignIn.tsx
+++ b/src/components/ui/wallet/SignIn.tsx
@@ -1,22 +1,20 @@
 'use client';

-import { useCallback, useState } from "react";
-import { signIn, signOut, getCsrfToken } from "next-auth/react";
-import sdk, { SignIn as SignInCore } from "@farcaster/miniapp-sdk";
-import { useSession } from "next-auth/react";
-import { Button } from "../Button";
+import { useCallback, useState } from 'react';
+import { SignIn as SignInCore } from '@farcaster/miniapp-sdk';
+import { useQuickAuth } from '~/hooks/useQuickAuth';
+import { Button } from '../Button';

 /**
- * SignIn component handles Farcaster authentication using Sign-In with Farcaster (SIWF).
+ * SignIn component handles Farcaster authentication using QuickAuth.
 *
 * This component provides a complete authentication flow for Farcaster users:
- * - Generates nonces for secure authentication
- * - Handles the SIWF flow using the Farcaster SDK
- * - Manages NextAuth session state
+ * - Uses the built-in QuickAuth functionality from the Farcaster SDK
+ * - Manages authentication state in memory (no persistence)
 * - Provides sign-out functionality
 * - Displays authentication status and results
 *
- * The component integrates with both the Farcaster Frame SDK and NextAuth
+ * The component integrates with the Farcaster Frame SDK and QuickAuth
 * to provide seamless authentication within mini apps.
 *
 * @example
@@ -36,52 +34,32 @@ export function SignIn() {
    signingIn: false,
    signingOut: false,
  });
-  const [signInResult, setSignInResult] = useState<SignInCore.SignInResult>();
  const [signInFailure, setSignInFailure] = useState<string>();

  // --- Hooks ---
-  const { data: session, status } = useSession();
+  const { authenticatedUser, status, signIn, signOut } = useQuickAuth();

  // --- Handlers ---
  /**
-   * Generates a nonce for the sign-in process.
+   * Handles the sign-in process using QuickAuth.
   *
-   * This function retrieves a CSRF token from NextAuth to use as a nonce
-   * for the SIWF authentication flow. The nonce ensures the authentication
-   * request is fresh and prevents replay attacks.
-   *
-   * @returns Promise<string> - The generated nonce token
-   * @throws Error if unable to generate nonce
-   */
-  const getNonce = useCallback(async () => {
-    const nonce = await getCsrfToken();
-    if (!nonce) throw new Error('Unable to generate nonce');
-    return nonce;
-  }, []);
-
-  /**
-   * Handles the sign-in process using Farcaster SDK.
-   *
-   * This function orchestrates the complete SIWF flow:
-   * 1. Generates a nonce for security
-   * 2. Calls the Farcaster SDK to initiate sign-in
-   * 3. Submits the result to NextAuth for session management
-   * 4. Handles various error conditions including user rejection
+   * This function uses the built-in QuickAuth functionality:
+   * 1. Gets a token from QuickAuth (handles SIWF flow automatically)
+   * 2. Validates the token with our server
+   * 3. Updates the session state
   *
   * @returns Promise<void>
   */
  const handleSignIn = useCallback(async () => {
    try {
-      setAuthState((prev) => ({ ...prev, signingIn: true }));
+      setAuthState(prev => ({ ...prev, signingIn: true }));
      setSignInFailure(undefined);
-      const nonce = await getNonce();
-      const result = await sdk.actions.signIn({ nonce });
-      setSignInResult(result);
-      await signIn('farcaster', {
-        message: result.message,
-        signature: result.signature,
-        redirect: false,
-      });
+
+      const success = await signIn();
+
+      if (!success) {
+        setSignInFailure('Authentication failed');
+      }
    } catch (e) {
      if (e instanceof SignInCore.RejectedByUser) {
        setSignInFailure('Rejected by user');
@@ -89,52 +67,49 @@ export function SignIn() {
      }
      setSignInFailure('Unknown error');
    } finally {
-      setAuthState((prev) => ({ ...prev, signingIn: false }));
+      setAuthState(prev => ({ ...prev, signingIn: false }));
    }
-  }, [getNonce]);
+  }, [signIn]);

  /**
   * Handles the sign-out process.
   *
-   * This function clears the NextAuth session only if the current session
-   * is using the Farcaster provider, and resets the local sign-in result state.
+   * This function clears the QuickAuth session and resets the local state.
   *
   * @returns Promise<void>
   */
  const handleSignOut = useCallback(async () => {
    try {
-      setAuthState((prev) => ({ ...prev, signingOut: true }));
-      // Only sign out if the current session is from Farcaster provider
-      if (session?.provider === 'farcaster') {
-        await signOut({ redirect: false });
-      }
-      setSignInResult(undefined);
+      setAuthState(prev => ({ ...prev, signingOut: true }));
+      await signOut();
    } finally {
-      setAuthState((prev) => ({ ...prev, signingOut: false }));
+      setAuthState(prev => ({ ...prev, signingOut: false }));
    }
-  }, [session]);
+  }, [signOut]);

  // --- Render ---
  return (
    <>
      {/* Authentication Buttons */}
-      {(status !== 'authenticated' || session?.provider !== 'farcaster') && (
+      {status !== 'authenticated' && (
        <Button onClick={handleSignIn} disabled={authState.signingIn}>
          Sign In with Farcaster
        </Button>
      )}
-      {status === 'authenticated' && session?.provider === 'farcaster' && (
+      {status === 'authenticated' && (
        <Button onClick={handleSignOut} disabled={authState.signingOut}>
          Sign out
        </Button>
      )}

      {/* Session Information */}
-      {session && (
+      {authenticatedUser && (
        <div className="my-2 p-2 text-xs overflow-x-scroll bg-gray-100 dark:bg-gray-900 rounded-lg font-mono">
-          <div className="font-semibold text-gray-500 dark:text-gray-300 mb-1">Session</div>
+          <div className="font-semibold text-gray-500 dark:text-gray-300 mb-1">
+            Authenticated User
+          </div>
          <div className="whitespace-pre text-gray-700 dark:text-gray-200">
-            {JSON.stringify(session, null, 2)}
+            {JSON.stringify(authenticatedUser, null, 2)}
          </div>
        </div>
      )}
@@ -142,17 +117,11 @@ export function SignIn() {
      {/* Error Display */}
      {signInFailure && !authState.signingIn && (
        <div className="my-2 p-2 text-xs overflow-x-scroll bg-gray-100 dark:bg-gray-900 rounded-lg font-mono">
-          <div className="font-semibold text-gray-500 dark:text-gray-300 mb-1">SIWF Result</div>
-          <div className="whitespace-pre text-gray-700 dark:text-gray-200">{signInFailure}</div>
+          <div className="font-semibold text-gray-500 dark:text-gray-300 mb-1">
+            Authentication Error
          </div>
-      )}
-
-      {/* Success Result Display */}
-      {signInResult && !authState.signingIn && (
-        <div className="my-2 p-2 text-xs overflow-x-scroll bg-gray-100 dark:bg-gray-900 rounded-lg font-mono">
-          <div className="font-semibold text-gray-500 dark:text-gray-300 mb-1">SIWF Result</div>
          <div className="whitespace-pre text-gray-700 dark:text-gray-200">
-            {JSON.stringify(signInResult, null, 2)}
+            {signInFailure}
          </div>
        </div>
      )}
--- a/src/hooks/useQuickAuth.ts
+++ b/src/hooks/useQuickAuth.ts
@@ -0,0 +1,207 @@
+'use client';
+
+import { useState, useEffect, useCallback } from 'react';
+import { sdk } from '@farcaster/miniapp-sdk';
+
+/**
+ * Represents the current authenticated user state
+ */
+interface AuthenticatedUser {
+  /** The user's Farcaster ID (FID) */
+  fid: number;
+}
+
+/**
+ * Possible authentication states for QuickAuth
+ */
+type QuickAuthStatus = 'loading' | 'authenticated' | 'unauthenticated';
+
+/**
+ * Return type for the useQuickAuth hook
+ */
+interface UseQuickAuthReturn {
+  /** Current authenticated user data, or null if not authenticated */
+  authenticatedUser: AuthenticatedUser | null;
+  /** Current authentication status */
+  status: QuickAuthStatus;
+  /** Function to initiate the sign-in process using QuickAuth */
+  signIn: () => Promise<boolean>;
+  /** Function to sign out and clear the current authentication state */
+  signOut: () => Promise<void>;
+  /** Function to retrieve the current authentication token */
+  getToken: () => Promise<string | null>;
+}
+
+/**
+ * Custom hook for managing QuickAuth authentication state
+ *
+ * This hook provides a complete authentication flow using Farcaster's QuickAuth:
+ * - Automatically checks for existing authentication on mount
+ * - Validates tokens with the server-side API
+ * - Manages authentication state in memory (no persistence)
+ * - Provides sign-in/sign-out functionality
+ *
+ * QuickAuth tokens are managed in memory only, so signing out of the Farcaster
+ * client will automatically sign the user out of this mini app as well.
+ *
+ * @returns {UseQuickAuthReturn} Object containing user state and authentication methods
+ *
+ * @example
+ * ```tsx
+ * const { authenticatedUser, status, signIn, signOut } = useQuickAuth();
+ *
+ * if (status === 'loading') return <div>Loading...</div>;
+ * if (status === 'unauthenticated') return <button onClick={signIn}>Sign In</button>;
+ *
+ * return (
+ *   <div>
+ *     <p>Welcome, FID: {authenticatedUser?.fid}</p>
+ *     <button onClick={signOut}>Sign Out</button>
+ *   </div>
+ * );
+ * ```
+ */
+export function useQuickAuth(): UseQuickAuthReturn {
+  // Current authenticated user data
+  const [authenticatedUser, setAuthenticatedUser] =
+    useState<AuthenticatedUser | null>(null);
+  // Current authentication status
+  const [status, setStatus] = useState<QuickAuthStatus>('loading');
+
+  /**
+   * Validates a QuickAuth token with the server-side API
+   *
+   * @param {string} authToken - The JWT token to validate
+   * @returns {Promise<AuthenticatedUser | null>} User data if valid, null otherwise
+   */
+  const validateTokenWithServer = async (
+    authToken: string,
+  ): Promise<AuthenticatedUser | null> => {
+    try {
+      const validationResponse = await fetch('/api/auth/validate', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ token: authToken }),
+      });
+
+      if (validationResponse.ok) {
+        const responseData = await validationResponse.json();
+        return responseData.user;
+      }
+
+      return null;
+    } catch (error) {
+      console.error('Token validation failed:', error);
+      return null;
+    }
+  };
+
+  /**
+   * Checks for existing authentication token and validates it on component mount
+   * This runs automatically when the hook is first used
+   */
+  useEffect(() => {
+    const checkExistingAuthentication = async () => {
+      try {
+        // Attempt to retrieve existing token from QuickAuth SDK
+        const { token } = await sdk.quickAuth.getToken();
+
+        if (token) {
+          // Validate the token with our server-side API
+          const validatedUserSession = await validateTokenWithServer(token);
+
+          if (validatedUserSession) {
+            // Token is valid, set authenticated state
+            setAuthenticatedUser(validatedUserSession);
+            setStatus('authenticated');
+          } else {
+            // Token is invalid or expired, clear authentication state
+            setStatus('unauthenticated');
+          }
+        } else {
+          // No existing token found, user is not authenticated
+          setStatus('unauthenticated');
+        }
+      } catch (error) {
+        console.error('Error checking existing authentication:', error);
+        setStatus('unauthenticated');
+      }
+    };
+
+    checkExistingAuthentication();
+  }, []);
+
+  /**
+   * Initiates the QuickAuth sign-in process
+   *
+   * Uses sdk.quickAuth.getToken() to get a QuickAuth session token.
+   * If there is already a session token in memory that hasn't expired,
+   * it will be immediately returned, otherwise a fresh one will be acquired.
+   *
+   * @returns {Promise<boolean>} True if sign-in was successful, false otherwise
+   */
+  const signIn = useCallback(async (): Promise<boolean> => {
+    try {
+      setStatus('loading');
+
+      // Get QuickAuth session token
+      const { token } = await sdk.quickAuth.getToken();
+
+      if (token) {
+        // Validate the token with our server-side API
+        const validatedUserSession = await validateTokenWithServer(token);
+
+        if (validatedUserSession) {
+          // Authentication successful, update user state
+          setAuthenticatedUser(validatedUserSession);
+          setStatus('authenticated');
+          return true;
+        }
+      }
+
+      // Authentication failed, clear user state
+      setStatus('unauthenticated');
+      return false;
+    } catch (error) {
+      console.error('Sign-in process failed:', error);
+      setStatus('unauthenticated');
+      return false;
+    }
+  }, []);
+
+  /**
+   * Signs out the current user and clears the authentication state
+   *
+   * Since QuickAuth tokens are managed in memory only, this simply clears
+   * the local user state. The actual token will be cleared when the
+   * user signs out of their Farcaster client.
+   */
+  const signOut = useCallback(async (): Promise<void> => {
+    // Clear local user state
+    setAuthenticatedUser(null);
+    setStatus('unauthenticated');
+  }, []);
+
+  /**
+   * Retrieves the current authentication token from QuickAuth
+   *
+   * @returns {Promise<string | null>} The current auth token, or null if not authenticated
+   */
+  const getToken = useCallback(async (): Promise<string | null> => {
+    try {
+      const { token } = await sdk.quickAuth.getToken();
+      return token;
+    } catch (error) {
+      console.error('Failed to retrieve authentication token:', error);
+      return null;
+    }
+  }, []);
+
+  return {
+    authenticatedUser,
+    status,
+    signIn,
+    signOut,
+    getToken,
+  };
+}
--- a/src/lib/constants.ts
+++ b/src/lib/constants.ts
@@ -1,3 +1,5 @@
+import { type AccountAssociation } from '@farcaster/miniapp-core/src/manifest';
+
 /**
 * Application constants and configuration values.
 *
@@ -14,63 +16,71 @@
 * The base URL of the application.
 * Used for generating absolute URLs for assets and API endpoints.
 */
-export const APP_URL = process.env.NEXT_PUBLIC_URL!;
+export const APP_URL: string = process.env.NEXT_PUBLIC_URL!;

 /**
 * The name of the mini app as displayed to users.
 * Used in titles, headers, and app store listings.
 */
-export const APP_NAME = 'shreyas-testing-mini-app';
+export const APP_NAME: string = 'Starter Kit';

 /**
 * A brief description of the mini app's functionality.
 * Used in app store listings and metadata.
 */
-export const APP_DESCRIPTION = 'A Farcaster mini app created with Neynar';
+export const APP_DESCRIPTION: string = 'A demo of the Neynar Starter Kit';

 /**
 * The primary category for the mini app.
 * Used for app store categorization and discovery.
 */
-export const APP_PRIMARY_CATEGORY = '';
+export const APP_PRIMARY_CATEGORY: string = 'developer-tools';

 /**
 * Tags associated with the mini app.
 * Used for search and discovery in app stores.
 */
-export const APP_TAGS = ['neynar', 'starter-kit', 'demo'];
+export const APP_TAGS: string[] = ['neynar', 'starter-kit', 'demo'];

 // --- Asset URLs ---
 /**
 * URL for the app's icon image.
 * Used in app store listings and UI elements.
 */
-export const APP_ICON_URL = `${APP_URL}/icon.png`;
+export const APP_ICON_URL: string = `${APP_URL}/icon.png`;

 /**
 * URL for the app's Open Graph image.
 * Used for social media sharing and previews.
 */
-export const APP_OG_IMAGE_URL = `${APP_URL}/api/opengraph-image`;
+export const APP_OG_IMAGE_URL: string = `${APP_URL}/api/opengraph-image`;

 /**
 * URL for the app's splash screen image.
 * Displayed during app loading.
 */
-export const APP_SPLASH_URL = `${APP_URL}/splash.png`;
+export const APP_SPLASH_URL: string = `${APP_URL}/splash.png`;

 /**
 * Background color for the splash screen.
 * Used as fallback when splash image is loading.
 */
-export const APP_SPLASH_BACKGROUND_COLOR = '#f7f7f7';
+export const APP_SPLASH_BACKGROUND_COLOR: string = '#f7f7f7';
+
+/**
+ * Account association for the mini app.
+ * Used to associate the mini app with a Farcaster account.
+ * If not provided, the mini app will be unsigned and have limited capabilities.
+ */
+export const APP_ACCOUNT_ASSOCIATION: AccountAssociation | undefined =
+  undefined;

 // --- UI Configuration ---
 /**
 * Text displayed on the main action button.
 * Used for the primary call-to-action in the mini app.
 */
-export const APP_BUTTON_TEXT = 'Launch Mini App';
+export const APP_BUTTON_TEXT: string = 'Launch Mini App';

 // --- Integration Configuration ---
 /**
@@ -80,7 +90,7 @@ export const APP_BUTTON_TEXT = 'Launch Mini App';
 * Neynar webhook endpoint. Otherwise, falls back to a local webhook
 * endpoint for development and testing.
 */
-export const APP_WEBHOOK_URL =
+export const APP_WEBHOOK_URL: string =
  process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID
    ? `https://api.neynar.com/f/app/${process.env.NEYNAR_CLIENT_ID}/event`
    : `${APP_URL}/api/webhook`;
@@ -92,7 +102,7 @@ export const APP_WEBHOOK_URL =
 * When false, wallet functionality is completely hidden from the UI.
 * Useful for mini apps that don't require wallet integration.
 */
-export const USE_WALLET = true;
+export const USE_WALLET: boolean = false;

 /**
 * Flag to enable/disable analytics tracking.
@@ -101,7 +111,27 @@ export const USE_WALLET = true;
 * When false, analytics collection is disabled.
 * Useful for privacy-conscious users or development environments.
 */
-export const ANALYTICS_ENABLED = true;
+export const ANALYTICS_ENABLED: boolean = true;
+
+/**
+ * Required chains for the mini app.
+ *
+ * Contains an array of CAIP-2 identifiers for blockchains that the mini app requires.
+ * If the host does not support all chains listed here, it will not render the mini app.
+ * If empty or undefined, the mini app will be rendered regardless of chain support.
+ *
+ * Supported chains: eip155:1, eip155:137, eip155:42161, eip155:10, eip155:8453,
+ * solana:mainnet, solana:devnet
+ */
+export const APP_REQUIRED_CHAINS: string[] = [];
+
+/**
+ * Return URL for the mini app.
+ *
+ * If provided, the mini app will be rendered with a return URL to be rendered if the
+ * back button is pressed from the home page.
+ */
+export const RETURN_URL: string | undefined = undefined;

 // PLEASE DO NOT UPDATE THIS
 export const SIGNED_KEY_REQUEST_VALIDATOR_EIP_712_DOMAIN = {
--- a/src/lib/kv.ts
+++ b/src/lib/kv.ts
@@ -1,16 +1,18 @@
-import { FrameNotificationDetails } from "@farcaster/miniapp-sdk";
-import { Redis } from "@upstash/redis";
-import { APP_NAME } from "./constants";
+import { MiniAppNotificationDetails } from '@farcaster/miniapp-sdk';
+import { Redis } from '@upstash/redis';
+import { APP_NAME } from './constants';

 // In-memory fallback storage
-const localStore = new Map<string, FrameNotificationDetails>();
+const localStore = new Map<string, MiniAppNotificationDetails>();

 // Use Redis if KV env vars are present, otherwise use in-memory
 const useRedis = process.env.KV_REST_API_URL && process.env.KV_REST_API_TOKEN;
-const redis = useRedis ? new Redis({
+const redis = useRedis
+  ? new Redis({
      url: process.env.KV_REST_API_URL!,
      token: process.env.KV_REST_API_TOKEN!,
-}) : null;
+    })
+  : null;

 function getUserNotificationDetailsKey(fid: number): string {
  return `${APP_NAME}:user:${fid}`;
@@ -18,17 +20,17 @@ function getUserNotificationDetailsKey(fid: number): string {

 export async function getUserNotificationDetails(
  fid: number
-): Promise<FrameNotificationDetails | null> {
+): Promise<MiniAppNotificationDetails | null> {
  const key = getUserNotificationDetailsKey(fid);
  if (redis) {
-    return await redis.get<FrameNotificationDetails>(key);
+    return await redis.get<MiniAppNotificationDetails>(key);
  }
  return localStore.get(key) || null;
 }

 export async function setUserNotificationDetails(
  fid: number,
-  notificationDetails: FrameNotificationDetails
+  notificationDetails: MiniAppNotificationDetails
 ): Promise<void> {
  const key = getUserNotificationDetailsKey(fid);
  if (redis) {
--- a/src/lib/utils.ts
+++ b/src/lib/utils.ts
@@ -1,6 +1,6 @@
-import { type ClassValue, clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
-import { mnemonicToAccount } from "viem/accounts";
+import { type ClassValue, clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+import { Manifest } from '@farcaster/miniapp-core/src/manifest';
 import {
  APP_BUTTON_TEXT,
  APP_DESCRIPTION,
@@ -9,35 +9,12 @@ import {
  APP_OG_IMAGE_URL,
  APP_PRIMARY_CATEGORY,
  APP_SPLASH_BACKGROUND_COLOR,
+  APP_SPLASH_URL,
  APP_TAGS,
  APP_URL,
  APP_WEBHOOK_URL,
-} from "./constants";
-import { APP_SPLASH_URL } from "./constants";
-
-interface MiniAppMetadata {
-  version: string;
-  name: string;
-  iconUrl: string;
-  homeUrl: string;
-  imageUrl?: string;
-  buttonTitle?: string;
-  splashImageUrl?: string;
-  splashBackgroundColor?: string;
-  webhookUrl?: string;
-  description?: string;
-  primaryCategory?: string;
-  tags?: string[];
-}
-
-interface MiniAppManifest {
-  accountAssociation?: {
-    header: string;
-    payload: string;
-    signature: string;
-  };
-  frame: MiniAppMetadata;
-}
+  APP_ACCOUNT_ASSOCIATION,
+} from './constants';

 export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
@@ -45,12 +22,15 @@ export function cn(...inputs: ClassValue[]) {

 export function getMiniAppEmbedMetadata(ogImageUrl?: string) {
  return {
-    version: "next",
+    version: 'next',
    imageUrl: ogImageUrl ?? APP_OG_IMAGE_URL,
+    ogTitle: APP_NAME,
+    ogDescription: APP_DESCRIPTION,
+    ogImageUrl: ogImageUrl ?? APP_OG_IMAGE_URL,
    button: {
      title: APP_BUTTON_TEXT,
      action: {
-        type: "launch_frame",
+        type: 'launch_frame',
        name: APP_NAME,
        url: APP_URL,
        splashImageUrl: APP_SPLASH_URL,
@@ -64,48 +44,19 @@ export function getMiniAppEmbedMetadata(ogImageUrl?: string) {
  };
 }

-export async function getFarcasterMetadata(): Promise<MiniAppManifest> {
-  // First check for MINI_APP_METADATA in .env and use that if it exists
-  if (process.env.MINI_APP_METADATA) {
-    try {
-      const metadata = JSON.parse(process.env.MINI_APP_METADATA);
-      console.log("Using pre-signed mini app metadata from environment");
-      return metadata;
-    } catch (error) {
-      console.warn(
-        "Failed to parse MINI_APP_METADATA from environment:",
-        error
-      );
-    }
-  }
-
-  if (!APP_URL) {
-    throw new Error("NEXT_PUBLIC_URL not configured");
-  }
-
-  // Get the domain from the URL (without https:// prefix)
-  const domain = new URL(APP_URL).hostname;
-  console.log("Using domain for manifest:", domain);
-
+export async function getFarcasterDomainManifest(): Promise<Manifest> {
  return {
-    accountAssociation: {
-      header: "",
-      payload: "",
-      signature: "",
-    },
-    frame: {
-      version: "1",
-      name: APP_NAME ?? "Neynar Starter Kit",
-      iconUrl: APP_ICON_URL,
+    accountAssociation: APP_ACCOUNT_ASSOCIATION!,
+    miniapp: {
+      version: '1',
+      name: APP_NAME ?? 'Neynar Starter Kit',
      homeUrl: APP_URL,
+      iconUrl: APP_ICON_URL,
      imageUrl: APP_OG_IMAGE_URL,
-      buttonTitle: APP_BUTTON_TEXT ?? "Launch Mini App",
+      buttonTitle: APP_BUTTON_TEXT ?? 'Launch Mini App',
      splashImageUrl: APP_SPLASH_URL,
      splashBackgroundColor: APP_SPLASH_BACKGROUND_COLOR,
      webhookUrl: APP_WEBHOOK_URL,
-      description: APP_DESCRIPTION,
-      primaryCategory: APP_PRIMARY_CATEGORY,
-      tags: APP_TAGS,
    },
  };
 }
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -22,6 +22,13 @@
      "~/*": ["./src/*"]
    }
  },
+  "ts-node": {
+    "esm": true,
+    "compilerOptions": {
+      "module": "ES2020",
+      "moduleResolution": "node"
+    }
+  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
  "exclude": ["node_modules"]
 }
Author	SHA1	Message	Date
veganbeef	36b4540e47	fix: update protocol guild donation addresses to latest	2025-12-01 09:01:00 -08:00
Lucas Myers	c5fef388b2	Merge pull request #30 from vaibhavmule/fix/add-pigment-css-react-dependency fix: add @pigment-css/react as dependency	2025-12-01 10:49:46 -06:00
Vaibhav Mule	91658503ff	fix: add @pigment-css/react as dependency @neynar/react requires @pigment-css/react at runtime but it wasn't included in the generated package.json, causing module resolution errors. This fixes the issue where newly created mini apps fail with: 'Module not found: Can't resolve @pigment-css/react'	2025-11-30 13:01:09 +05:30
veganbeef	760d2f28ec	feat: remove localtunnel and recommend ngrok	2025-10-29 17:16:48 -07:00
veganbeef	8d37c83ee8	bump @neynar/react version	2025-10-13 14:50:57 -07:00
Bob Obringer	2254f0d9a7	Merge pull request #28 from neynarxyz/enforce-neynar-react-1.2.14 Enforce @neynar/react version 1.2.14	2025-10-12 12:45:23 -04:00
Bob Obringer	29fe3d82ca	fixed lockfiled	2025-10-12 12:43:35 -04:00
Bob Obringer	258eba7bfc	fixed lockfile	2025-10-12 12:42:30 -04:00
Bob Obringer	3921ab4258	Enforce @neynar/react version 1.2.14 This update enforces @neynar/react version 1.2.14 to include the fix for the miniapp data context issue resolved in https://github.com/neynarxyz/frontend-monorepo/pull/512 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-10-12 12:38:17 -04:00
Shreyaschorge	6a8fa017e5	Merge pull request #27 from neynarxyz/shreyas/neyn-7098-move-siwn-to-be-fully-embeddable-within-the-host-app Fix terminology for siwn	2025-09-30 18:59:47 +05:30
Shreyaschorge	c872bdd4ee	Fix terminology	2025-09-30 18:51:49 +05:30
veganbeef	c5ca1618ed	bump @neynar/react version	2025-09-09 23:36:13 -07:00
veganbeef	db735d7568	fix: frame_* to miniapp_*	2025-09-09 23:20:35 -07:00
veganbeef	ccd27f53b3	fix: build failure	2025-09-09 23:07:53 -07:00
veganbeef	f14493e35b	fix: deploy script dependency issue	2025-09-09 22:53:03 -07:00
veganbeef	3af6ee0e71	upgrade to @neynar/react v1.2.12	2025-09-09 22:25:23 -07:00
veganbeef	54646a5035	fix: support yarn and pnpm	2025-09-08 16:23:24 -07:00
veganbeef	be7d6b76ae	fix: update @neynar/react version and add overrides for qix vulnerable packages	2025-09-08 16:00:14 -07:00
veganbeef	09ef2e374e	feat: bump @neynar/react version	2025-08-21 11:31:40 -07:00
veganbeef	1cce5835d4	feat: bump neynar/react version	2025-08-11 17:21:09 -07:00
veganbeef	55c7c4b129	feat: udpate script to support --return-url flag [NEYN-6533]	2025-08-07 16:11:45 -07:00
veganbeef	055dc4adbd	feat: integrate returnUrl to config [NEYN-6533]	2025-08-07 16:02:46 -07:00
veganbeef	98579bcea9	fix: constants format	2025-07-23 19:29:00 -07:00
veganbeef	ea7ee37e71	fix: siwn csrf config	2025-07-23 19:23:03 -07:00
veganbeef	feb9f3e161	fix: authkit provider	2025-07-23 18:57:24 -07:00
veganbeef	8c5b8d8329	move conditional next-auth code to alternate files	2025-07-23 18:54:08 -07:00
Shreyaschorge	d0f8c75a2e	Merge pull request #24 from neynarxyz/sc/fix-401-for-siwn-auth fix:401 for SIWN and remove farcaster login mechanism	2025-07-21 16:24:59 +05:30
Shreyaschorge	e115520aa7	fix 401	2025-07-21 16:23:09 +05:30
veganbeef	7dff4cd81a	fix: remove NeynarAuthButton import conditionally	2025-07-18 18:57:31 -07:00
veganbeef	d1ec161f47	fix: sponsor signer depends on seed phrase	2025-07-18 17:29:51 -07:00
Shreyaschorge	572ab9aa44	Merge pull request #23 from neynarxyz/fix-deploy-and-manifest-issue fix-deploy-and-dynamic-import-issue	2025-07-19 04:20:59 +05:30
Shreyaschorge	501bc84512	Merge branch 'main' into fix-deploy-and-manifest-issue	2025-07-19 03:52:05 +05:30
Shreyaschorge	85b39a6397	return fragment	2025-07-19 03:48:49 +05:30
Shreyaschorge	61df6d6a64	fix: Unknown file extension '.ts' issue	2025-07-19 03:12:54 +05:30
Shreyaschorge	9ee370628d	if button exists then render it	2025-07-19 02:53:18 +05:30
Shreyaschorge	882e4f166f	fix imports	2025-07-19 02:43:31 +05:30
veganbeef	e8fa822638	feat: add more flags to script	2025-07-18 10:56:16 -07:00
Shreyaschorge	bade04b785	fix-deploy-and-manifest-issue	2025-07-18 22:55:10 +05:30
veganbeef	d9c74f163b	fix: conditional imports	2025-07-17 14:29:24 -07:00
Shreyaschorge	2edd1bd2ae	Merge pull request #22 from neynarxyz/shreyas/neyn-5928-resolve-customer-issue-with-broken-nsk-script Handle session provider rendering	2025-07-17 03:04:45 +05:30
Shreyaschorge	76ad200a22	Handle session provider rendering	2025-07-17 03:02:54 +05:30
veganbeef	86b79e7f3f	fix: use session provider whenever next auth is included	2025-07-16 13:12:48 -07:00
Shreyaschorge	aac3a739cd	Merge pull request #21 from neynarxyz/veganbeef/reapply-quick-auth feat: reapply quickauth changes conditionally	2025-07-17 00:08:18 +05:30
Shreyaschorge	f20f65f966	Bump up patch version	2025-07-17 00:07:47 +05:30
Shreyaschorge	a287d55641	set SPONSOR_SIGNER=true	2025-07-16 23:54:44 +05:30
Shreyaschorge	53d6ce6a94	sponsoredSigner -> useSponsoredSigner	2025-07-16 23:27:05 +05:30
Shreyaschorge	ebb8068ade	remove update-session route	2025-07-16 23:03:01 +05:30
veganbeef	8124fe5f6c	feat: add back og properties	2025-07-16 09:49:19 -07:00
veganbeef	9ea40a5f92	feat: add requiredChains support	2025-07-16 09:46:35 -07:00
veganbeef	e61bc88aaa	feat: reapply quickauth changes conditionally	2025-07-16 09:16:58 -07:00
veganbeef	8eabbd3ba1	bump version number for revert	2025-07-16 08:44:39 -07:00
Lucas Myers	f7392dc3cb	Merge pull request #20 from neynarxyz/sc/revert-to-5fbd9 revert to 5fbd9	2025-07-16 08:43:43 -07:00
Shreyaschorge	bf563154ca	Fix merge conflict issues	2025-07-16 17:50:03 +05:30
Shreyaschorge	196378daeb	Revert "format" This reverts commit `5fbd9c5c09`.	2025-07-16 17:33:02 +05:30
Shreyaschorge	89f82253ca	Revert "feat: replace next-auth with quick auth" This reverts commit `86029b2bd9`.	2025-07-16 17:32:21 +05:30
Shreyaschorge	c786cabe84	Revert "fix: add back auth-kit" This reverts commit `16c433a13c`.	2025-07-16 17:31:34 +05:30
Shreyaschorge	760efdb96b	Revert "format" This reverts commit `378ea65154`.	2025-07-16 17:30:47 +05:30
Shreyaschorge	5fd0e21532	Revert "fix: SIWN dependencies" This reverts commit `4ba9480832`.	2025-07-16 17:28:36 +05:30
Shreyaschorge	0d43b35c28	Revert "Merge pull request #15 from neynarxyz/shreyas-formatting" This reverts commit `b1fdfc19a9`, reversing changes made to `b9e2087bd8`.	2025-07-16 17:21:12 +05:30
Shreyaschorge	349cdea489	Revert "Merge pull request #18 from neynarxyz/veganbeef/fix-siwn" This reverts commit `78626c2dc7`, reversing changes made to `b1fdfc19a9`.	2025-07-16 17:20:36 +05:30
veganbeef	181c364de4	fix: sponsor signer env var	2025-07-15 13:08:55 -07:00
Lucas Myers	78626c2dc7	Merge pull request #18 from neynarxyz/veganbeef/fix-siwn fix: add back auth-kit	2025-07-15 09:34:40 -07:00
veganbeef	b72198575a	Merge branch 'main' into veganbeef/fix-siwn	2025-07-15 09:29:35 -07:00
Lucas Myers	b1fdfc19a9	Merge pull request #15 from neynarxyz/shreyas-formatting Formatting	2025-07-15 09:25:35 -07:00
veganbeef	4ba9480832	fix: SIWN dependencies	2025-07-15 09:25:08 -07:00
Shreyaschorge	378ea65154	format	2025-07-15 21:38:47 +05:30
Shreyaschorge	b366d97b53	Merge branch 'main' into shreyas-formatting	2025-07-15 21:35:11 +05:30
veganbeef	16c433a13c	fix: add back auth-kit	2025-07-14 13:24:55 -07:00
veganbeef	b9e2087bd8	fix: remove duplicate app directory	2025-07-14 13:12:47 -07:00
veganbeef	86029b2bd9	feat: replace next-auth with quick auth	2025-07-14 13:01:46 -07:00
Shreyaschorge	5fbd9c5c09	format	2025-07-15 01:00:59 +05:30
Shreyaschorge	3815f45b44	Merge branch 'main' into shreyas-formatting	2025-07-15 00:00:11 +05:30
Shreyaschorge	c713d53054	Merge pull request #17 from neynarxyz/shreyas/show-modal-on-top Show Dialog on top to show I am using my phone button	2025-07-14 23:51:52 +05:30
Shreyaschorge	d10bee4d4c	Merge branch 'main' into shreyas/show-modal-on-top	2025-07-14 23:51:24 +05:30
veganbeef	44d0c6f905	fix: regex error	2025-07-14 10:03:01 -07:00
Lucas Myers	4f308d3f07	Merge pull request #16 from neynarxyz/veganbeef/deploy-script-update feat: update deploy script to and manifest generation for simplicity [NEYN-5843]	2025-07-14 09:45:27 -07:00
veganbeef	4b370746cb	Merge branch 'main' into veganbeef/deploy-script-update	2025-07-14 09:44:58 -07:00
Shreyaschorge	00fdd21044	remove unnecessary rules	2025-07-14 21:52:14 +05:30
Shreyaschorge	8475b28107	remove console logs	2025-07-14 20:51:03 +05:30
Shreyaschorge	e74b2581df	Format after fixing conflicts	2025-07-14 20:04:44 +05:30
Shreyaschorge	505aa54b16	Merge branch 'main' into shreyas-formatting	2025-07-14 18:55:06 +05:30
Shreyaschorge	8de3f598b7	Show modal on top	2025-07-14 16:35:22 +05:30
veganbeef	fb4f8b8b53	feat: set up CI auto publish	2025-07-12 15:21:50 -07:00
veganbeef	5fa624a063	fix: auth kit url update and seed phrase input	2025-07-11 22:28:05 -07:00
Manan	36d2b5d0f7	Merge pull request #13 from neynarxyz/shreyas/neyn-5735-sign-in-connect-farcaster-using-developer-branded-signer Shreyas/neyn 5735 sign in connect farcaster using developer branded signer	2025-07-11 16:26:45 -07:00
veganbeef	d487a3e8e5	feat: update deploy script to and manifest generation for simplicity	2025-07-11 09:51:42 -07:00
Shreyaschorge	65419a76ee	Remove unnecessary file	2025-07-08 00:48:13 +05:30
Shreyaschorge	6b0350d477	Remove AI generated docs	2025-07-07 16:12:17 +05:30
Shreyaschorge	2a1a3d7c40	Correct formating imports	2025-07-07 16:07:33 +05:30
Shreyaschorge	193dffe03a	formatting	2025-07-07 14:10:47 +05:30