Fix terminology

bump @neynar/react version
fix: frame_* to miniapp_*
2025-12-11 03:42:32 -05:00 · 2025-09-30 18:51:49 +05:30 · 2025-09-09 23:36:13 -07:00 · 2025-09-09 23:20:35 -07:00 · 2025-09-09 23:07:53 -07:00 · 2025-09-09 22:53:03 -07:00
80 changed files with 2363 additions and 6314 deletions
--- a/.editorconfig
+++ b/.editorconfig
@@ -1,29 +0,0 @@
-# EditorConfig is awesome: https://EditorConfig.org
-
-# top-most EditorConfig file
-root = true
-
-# Unix-style newlines with a newline ending every file
-[*]
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-charset = utf-8
-
-# Matches multiple files with brace expansion notation
-[*.{js,jsx,ts,tsx,json,css,scss,md,mdx,yml,yaml}]
-indent_style = space
-indent_size = 2
-
-# Tab indentation (no size specified)
-[Makefile]
-indent_style = tab
-
-# Matches the exact files
-[{package.json,.travis.yml}]
-indent_style = space
-indent_size = 2
-
-# Markdown files
-[*.md]
-trim_trailing_whitespace = false
--- 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/.eslintignore
+++ b/.eslintignore
@@ -1,95 +0,0 @@
-# Dependencies
-node_modules/
-.pnp/
-.pnp.*
-
-# Build outputs
-.next/
-out/
-build/
-dist/
-
-# Environment files
-.env*
-!.env.example
-
-# Generated files
-next-env.d.ts
-*.tsbuildinfo
-
-# Package manager lock files
-package-lock.json
-yarn.lock
-pnpm-lock.yaml
-
-# Vercel
-.vercel/
-
-# Logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
-# OS generated files
-.DS_Store
-.DS_Store?
-._*
-.Spotlight-V100
-.Trashes
-ehthumbs.db
-Thumbs.db
-
-# Editor files
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# Git
-.git/
-
-# Temporary files
-tmp/
-temp/
-
-# Coverage
-coverage/
-.nyc_output
-
-# Cache directories
-.cache/
-.parcel-cache/
-.eslintcache
-
-# Storybook build outputs
-storybook-static
-
-# Database
-*.db
-*.sqlite
-
-# Documentation
-docs/
-
-# Auto-generated files
-*.d.ts
-!src/**/*.d.ts
-!types/**/*.d.ts
-
-# Test coverage
-*.lcov
-
-# Compiled binary addons
-build/Release
-
-# Yarn
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-
-# Scripts that should be ignored by eslint
-scripts/deploy.ts
--- a/.eslintrc.json
+++ b/.eslintrc.json
@@ -1,113 +1,32 @@
 {
-  "root": true,
-  "env": {
-    "browser": true,
-    "es2022": true,
-    "node": true
-  },
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "next/core-web-vitals",
-    "next/typescript"
-  ],
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": "latest",
-    "sourceType": "module",
-    "ecmaFeatures": {
-      "jsx": true
-    },
-    "project": "./tsconfig.json"
-  },
-  "plugins": ["@typescript-eslint"],
+  "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": [
-      "error",
+      "warn",
      {
        "argsIgnorePattern": "^_",
        "varsIgnorePattern": "^_",
        "caughtErrorsIgnorePattern": "^_"
      }
    ],
-    "@typescript-eslint/explicit-function-return-type": "off",
-    "@typescript-eslint/explicit-module-boundary-types": "off",
-    "@typescript-eslint/no-explicit-any": "warn",
-    "prefer-const": "error",
-    "@typescript-eslint/no-floating-promises": "warn",
-    "@typescript-eslint/await-thenable": "error",
-    "@typescript-eslint/no-misused-promises": "warn",
-    "@typescript-eslint/require-await": "warn",
-    "react/display-name": "off",
-    "react/prop-types": "off",
-    "react/jsx-uses-react": "off",
-    "react/react-in-jsx-scope": "off",
-    "no-console": ["warn", { "allow": ["warn", "error"] }],
-    "no-var": "error",
-    "no-multiple-empty-lines": ["error", { "max": 1, "maxEOF": 0 }],
-    "no-trailing-spaces": "error",
-    "eol-last": "error",
-    "semi": ["error", "always"],
-    "quotes": ["error", "single", { "avoidEscape": true }],
-    "import/order": [
-      "error",
-      {
-        "groups": [
-          "builtin",
-          "external",
-          "internal",
-          "parent",
-          "sibling",
-          "index"
-        ],
-        "pathGroups": [
-          {
-            "pattern": "react",
-            "group": "external",
-            "position": "before"
-          },
-          {
-            "pattern": "next/**",
-            "group": "external",
-            "position": "before"
-          },
-          {
-            "pattern": "~/**",
-            "group": "internal"
-          }
-        ],
-        "pathGroupsExcludedImportTypes": ["react"],
-        "newlines-between": "never",
-        "alphabetize": {
-          "order": "asc",
-          "caseInsensitive": true
-        }
-      }
-    ]
-  },
-  "overrides": [
-    {
-      "files": ["*.js", "*.jsx"],
-      "parserOptions": {
-        "project": null
-      },
-      "rules": {
-        "@typescript-eslint/no-var-requires": "off",
-        "@typescript-eslint/no-require-imports": "off",
-        "@typescript-eslint/no-floating-promises": "off",
-        "@typescript-eslint/await-thenable": "off",
-        "@typescript-eslint/no-misused-promises": "off",
-        "@typescript-eslint/require-await": "off",
-        "@typescript-eslint/no-unused-vars": "off",
-        "no-console": "off"
-      }
-    },
-    {
-      "files": ["*.config.js", "*.config.ts", "next.config.*"],
-      "rules": {
-        "@typescript-eslint/no-var-requires": "off",
-        "@typescript-eslint/no-require-imports": "off"
-      }
-    }
-  ]
+
+    // 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
@@ -27,4 +27,4 @@ jobs:
        run: npm ci

      - name: Publish to npm
-        run: npm publish --access public
+        run: npm publish --access public 
--- a/.gitignore
+++ b/.gitignore
@@ -39,25 +39,3 @@ yarn-error.log*
 # typescript
 *.tsbuildinfo
 next-env.d.ts
-
-# IDE and editor files
-.vscode/settings.json
-.idea/
-*.swp
-*.swo
-*~
-
-# Linting and formatting cache
-.eslintcache
-.prettierignore.bak
-
-# OS generated files
-Thumbs.db
-
-# Package manager files
-.pnpm-debug.log*
-.yarn-integrity
-
-# Temporary files
-tmp/
-temp/
--- a/.lintstagedrc
+++ b/.lintstagedrc
@@ -1,4 +0,0 @@
-{
-  "*.{js,jsx,ts,tsx}": ["eslint --fix", "prettier --write"],
-  "*.{json,css,scss,md,mdx,yml,yaml}": ["prettier --write"]
-}
--- a/.prettierignore
+++ b/.prettierignore
@@ -1,204 +0,0 @@
-# Dependencies
-node_modules/
-.pnp/
-.pnp.*
-
-# Build outputs
-.next/
-out/
-build/
-dist/
-
-# Environment files
-.env*
-!.env.example
-
-# Logs
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-lerna-debug.log*
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Coverage directory used by tools like istanbul
-coverage/
-*.lcov
-
-# nyc test coverage
-.nyc_output
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory
-web_modules/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# parcel-bundler cache
-.cache
-.parcel-cache
-
-# Stores VSCode versions used for testing VSCode extensions
-.vscode-test
-
-# yarn v2
-.yarn/cache
-.yarn/unplugged
-.yarn/build-state.yml
-.yarn/install-state.gz
-.pnp.*
-
-# Generated files
-next-env.d.ts
-
-# Package manager lock files
-package-lock.json
-yarn.lock
-pnpm-lock.yaml
-
-# Vercel
-.vercel/
-
-# OS generated files
-.DS_Store
-.DS_Store?
-._*
-.Spotlight-V100
-.Trashes
-ehthumbs.db
-Thumbs.db
-
-# Temporary files
-tmp/
-temp/
-
-# Database
-*.db
-*.sqlite
-
-# Compiled binary addons
-build/Release
-
-# Documentation
-docs/
-
-# Git
-.git/
-.gitignore
-
-# Editor files
-*.swp
-*.swo
-*~
-
-# Changelog
-CHANGELOG.md
-
-# Auto-generated documentation
-api-docs/
-
-# Dependency directories
-node_modules/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
-
-# Next.js build output
-.next
-
-# Nuxt.js build / generate output
-.nuxt
-dist
-
-# Storybook build outputs
-.out
-.storybook-out
-
-# Temporary folders
-tmp/
-temp/
-
-# Editor directories and files
-.vscode/*
-!.vscode/extensions.json
-.idea
-*.suo
-*.ntvs*
-*.njsproj
-*.sln
-*.sw?
-
-# OS generated files
-.DS_Store
-.DS_Store?
-._*
-.Spotlight-V100
-.Trashes
-ehthumbs.db
-Thumbs.db
-
-# Vercel
-.vercel
-
-# Package manager lock files
-package-lock.json
-yarn.lock
-pnpm-lock.yaml
-
-# Git
-.git/
--- a/.prettierrc
+++ b/.prettierrc
@@ -1,17 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "all",
-  "singleQuote": true,
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false,
-  "bracketSpacing": true,
-  "bracketSameLine": false,
-  "arrowParens": "avoid",
-  "endOfLine": "lf",
-  "quoteProps": "as-needed",
-  "proseWrap": "preserve",
-  "htmlWhitespaceSensitivity": "css",
-  "embeddedLanguageFormatting": "auto",
-  "singleAttributePerLine": false
-}
--- a/.vscode/extensions.json
+++ b/.vscode/extensions.json
@@ -1,13 +0,0 @@
-{
-  "recommendations": [
-    "esbenp.prettier-vscode",
-    "dbaeumer.vscode-eslint",
-    "bradlc.vscode-tailwindcss",
-    "ms-vscode.vscode-typescript-next",
-    "editorconfig.editorconfig",
-    "christian-kohler.path-intellisense",
-    "ms-vscode.vscode-json",
-    "formulahendry.auto-rename-tag",
-    "christian-kohler.npm-intellisense"
-  ]
-}
--- a/README.md
+++ b/README.md
@@ -11,51 +11,24 @@ Check out [this Neynar docs page](https://docs.neynar.com/docs/create-farcaster-
 ## Getting Started

 To create a new mini app project, run:
-
 ```{bash}
 npx @neynar/create-farcaster-mini-app@latest
 ```

 To run the project:
-
 ```{bash}
 cd <PROJECT_NAME>
 npm run dev
 ```

-## Code Formatting & Linting
-
-This template includes comprehensive formatting and linting tools to ensure consistent code quality:
-
- **Prettier**: Automatic code formatting
- **ESLint**: Code linting with Next.js and TypeScript support
- **EditorConfig**: Cross-editor consistency
-
-### Available Scripts
-
-```bash
-npm run format        # Format all files with Prettier
-npm run format:check  # Check if files are properly formatted
-npm run lint          # Run ESLint
-npm run lint:fix      # Fix ESLint issues automatically
-npm run type-check    # Run TypeScript type checking
-npm run check         # Run all checks (types, lint, format)
-```
-
-See [FORMATTING.md](./FORMATTING.md) for detailed configuration and setup information.
-
 ### Importing the CLI
-
 To invoke the CLI directly in JavaScript, add the npm package to your project and use the following import statement:
-
 ```{javascript}
 import { init } from '@neynar/create-farcaster-mini-app';
 ```

 ## Deploying to Vercel
-
 For projects that have made minimal changes to the quickstart template, deploy to vercel by running:
-
 ```{bash}
 npm run deploy:vercel
 ```
@@ -63,7 +36,6 @@ npm run deploy:vercel
 ## Building for Production

 To create a production build, run:
-
 ```{bash}
 npm run build
 ```
@@ -79,13 +51,12 @@ This section is only for working on the script and template. If you simply want
 To iterate on the CLI and test changes in a generated app without publishing to npm:

 1. In your installer/template repo (this repo), run:
-
   ```bash
   npm link
   ```
-
   This makes your local version globally available as a symlinked package.

+
 1. Now, when you run:
   ```bash
   npx @neynar/create-farcaster-mini-app
@@ -105,3 +76,4 @@ However, this does not fully replicate the npx install flow and may not catch al
 ### Environment Variables and Scripts

 If you update environment variable handling, remember to replicate any changes in the `dev`, `build`, and `deploy` scripts as needed. The `build` and `deploy` scripts may need further updates and are less critical for most development workflows.
+
--- a/bin/index.js
+++ b/bin/index.js
@@ -7,6 +7,11 @@ const args = process.argv.slice(2);
 let projectName = null;
 let autoAcceptDefaults = false;
 let apiKey = null;
+let noWallet = false;
+let noTunnel = false;
+let sponsoredSigner = false;
+let seedPhrase = null;
+let returnUrl = null;

 // Check for -y flag
 const yIndex = args.indexOf('-y');
@@ -15,48 +20,86 @@ if (yIndex !== -1) {
  args.splice(yIndex, 1); // Remove -y from args
 }

-// Parse other arguments
-for (let i = 0; i < args.length; i++) {
-  const arg = args[i];
-
-  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 (-)');
+  // Parse other arguments
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    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);
      }
-      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 (-)');
+    } 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 === '--no-tunnel') {
+      noTunnel = 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);
      }
-      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);
    }
  }
-}
+
+

 // Validate that if -y is used, a project name must be provided
 if (autoAcceptDefaults && !projectName) {
-  console.error(
-    'Error: -y flag requires a project name. Use -p/--project to specify the project name.',
-  );
+  console.error('Error: -y flag requires a project name. Use -p/--project to specify the project name.');
  process.exit(1);
 }

-init(projectName, autoAcceptDefaults, apiKey).catch(err => {
+init(projectName, autoAcceptDefaults, apiKey, noWallet, noTunnel, sponsoredSigner, seedPhrase, returnUrl).catch((err) => {
  console.error('Error:', err);
  process.exit(1);
 });
--- a/bin/init.js
+++ b/bin/init.js
@@ -1,19 +1,19 @@
 #!/usr/bin/env node

-import { execSync } from 'child_process';
-import crypto from 'crypto';
-import fs from 'fs';
-import { dirname } from 'path';
-import path from 'path';
-import { fileURLToPath } from 'url';
 import inquirer from 'inquirer';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';

 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);

 const REPO_URL = 'https://github.com/neynarxyz/create-farcaster-mini-app.git';
 const SCRIPT_VERSION = JSON.parse(
-  fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'),
+  fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8')
 ).version;

 // ANSI color codes
@@ -47,12 +47,12 @@ async function queryNeynarApp(apiKey) {
  }
  try {
    const response = await fetch(
-      'https://api.neynar.com/portal/app_by_api_key?starter_kit=true',
+      `https://api.neynar.com/portal/app_by_api_key?starter_kit=true`,
      {
        headers: {
          'x-api-key': apiKey,
        },
-      },
+      }
    );
    const data = await response.json();
    return data;
@@ -67,6 +67,11 @@ export async function init(
  projectName = null,
  autoAcceptDefaults = false,
  apiKey = null,
+  noWallet = false,
+  noTunnel = false,
+  sponsoredSigner = false,
+  seedPhrase = null,
+  returnUrl = null
 ) {
  printWelcomeMessage();

@@ -111,7 +116,7 @@ export async function init(
    } else {
      if (!autoAcceptDefaults) {
        console.log(
-          '\n🪐 Find your Neynar API key at: https://dev.neynar.com/app\n',
+          '\n🪐 Find your Neynar API key at: https://dev.neynar.com/app\n'
        );
      }

@@ -148,13 +153,13 @@ export async function init(

        if (useDemoKey.useDemo) {
          console.warn(
-            '\n⚠️ Note: the demo key is for development purposes only and is aggressively rate limited.',
+            '\n⚠️ Note: the demo key is for development purposes only and is aggressively rate limited.'
          );
          console.log(
-            'For production, please sign up for a Neynar account at https://neynar.com/ and configure the API key in your .env or .env.local file with NEYNAR_API_KEY.',
+            'For production, please sign up for a Neynar account at https://neynar.com/ and configure the API key in your .env or .env.local file with NEYNAR_API_KEY.'
          );
          console.log(
-            `\n${purple}${bright}${italic}Neynar now has a free tier! See https://neynar.com/#pricing for details.\n${reset}`,
+            `\n${purple}${bright}${italic}Neynar now has a free tier! See https://neynar.com/#pricing for details.\n${reset}`
          );
          neynarApiKey = 'FARCASTER_V2_FRAMES_DEMO';
        }
@@ -167,7 +172,7 @@ export async function init(
        break;
      }
      console.log(
-        '\n⚠️  No valid API key provided. Would you like to try again?',
+        '\n⚠️  No valid API key provided. Would you like to try again?'
      );
      const { retry } = await inquirer.prompt([
        {
@@ -223,17 +228,34 @@ export async function init(

  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,
+      useWallet: !noWallet,
      useTunnel: true,
      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
@@ -243,7 +265,7 @@ export async function init(
        name: 'projectName',
        message: 'What is the name of your mini app?',
        default: projectName || defaultMiniAppName,
-        validate: input => {
+        validate: (input) => {
          if (input.trim() === '') {
            return 'Project name cannot be empty';
          }
@@ -290,13 +312,13 @@ export async function init(
        message:
          'Enter tags for your mini app (separate with spaces or commas, optional):',
        default: '',
-        filter: input => {
+        filter: (input) => {
          if (!input.trim()) return [];
          // Split by both spaces and commas, trim whitespace, and filter out empty strings
          return input
            .split(/[,\s]+/)
-            .map(tag => tag.trim())
-            .filter(tag => tag.length > 0);
+            .map((tag) => tag.trim())
+            .filter((tag) => tag.length > 0);
        },
      },
      {
@@ -304,7 +326,7 @@ export async function init(
        name: 'buttonText',
        message: 'Enter the button text for your mini app:',
        default: 'Launch Mini App',
-        validate: input => {
+        validate: (input) => {
          if (input.trim() === '') {
            return 'Button text cannot be empty';
          }
@@ -316,75 +338,102 @@ export async function init(
    // Merge project name from the first prompt
    answers.projectName = projectNamePrompt.projectName;

-    // Ask about wallet and transaction tooling
-    const walletAnswer = await inquirer.prompt([
-      {
-        type: 'confirm',
-        name: 'useWallet',
-        message:
-          'Would you like to include wallet and transaction tooling in your mini app?\n' +
-          'This includes:\n' +
-          '- EVM wallet connection\n' +
-          '- Transaction signing\n' +
-          '- Message signing\n' +
-          '- Chain switching\n' +
-          '- Solana support\n\n' +
-          'Include wallet and transaction features?',
-        default: true,
-      },
-    ]);
-    answers.useWallet = walletAnswer.useWallet;
-
-    // Ask about localhost vs tunnel
-    const hostingAnswer = await inquirer.prompt([
-      {
-        type: 'confirm',
-        name: 'useTunnel',
-        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,
-      },
-    ]);
-    answers.useTunnel = hostingAnswer.useTunnel;
-
-    // Ask about Neynar Sponsored Signers / SIWN
-    const sponsoredSignerAnswer = await inquirer.prompt([
-      {
-        type: 'confirm',
-        name: 'useSponsoredSigner',
-        message:
-          'Would you like to use Neynar Sponsored Signers and/or Sign In With Neynar (SIWN)?\n' +
-          'This enables the simplest, most secure, and most user-friendly Farcaster authentication for your app.\n\n' +
-          'Benefits of using Neynar Sponsored Signers/SIWN:\n' +
-          '- No auth buildout or signer management required for developers\n' +
-          '- Cost-effective for users (no gas for signers)\n' +
-          '- Users can revoke signers at any time\n' +
-          '- Plug-and-play for web and React Native\n' +
-          '- Recommended for most developers\n' +
-          '\n⚠️ A seed phrase is required for this option.\n',
-        default: false,
-      },
-    ]);
-    answers.useSponsoredSigner = sponsoredSignerAnswer.useSponsoredSigner;
-
-    if (answers.useSponsoredSigner) {
-      const { seedPhrase } = await inquirer.prompt([
+    // 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: 'password',
-          name: 'seedPhrase',
+          type: 'confirm',
+          name: 'useWallet',
          message:
-            'Enter your Farcaster custody account seed phrase (required for Neynar Sponsored Signers/SIWN):',
-          validate: input => {
-            if (!input || input.trim().split(' ').length < 12) {
-              return 'Seed phrase must be at least 12 words';
-            }
-            return true;
-          },
+            'Would you like to include wallet and transaction tooling in your mini app?\n' +
+            'This includes:\n' +
+            '- EVM wallet connection\n' +
+            '- Transaction signing\n' +
+            '- Message signing\n' +
+            '- Chain switching\n' +
+            '- Solana support\n\n' +
+            'Include wallet and transaction features?',
+          default: true,
        },
      ]);
+      answers.useWallet = walletAnswer.useWallet;
+    }
+
+    // Ask about localhost vs tunnel
+    if (noTunnel) {
+      answers.useTunnel = false;
+    } else {
+      const hostingAnswer = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'useTunnel',
+          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,
+        },
+      ]);
+      answers.useTunnel = hostingAnswer.useTunnel;
+    }
+
+    // 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: 'useSIWN',
+          message:
+            '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,
+        },
+      ]);
+      
+      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
@@ -444,7 +493,7 @@ export async function init(
  // Update package.json
  console.log('\nUpdating package.json...');
  const packageJsonPath = path.join(projectPath, 'package.json');
-  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+  let packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));

  packageJson.name = finalProjectName;
  packageJson.version = '0.1.0';
@@ -458,6 +507,7 @@ export async function init(
  delete packageJson.devDependencies;

  // Add dependencies
+  // question: remove auth-client?
  packageJson.dependencies = {
    '@farcaster/auth-client': '>=0.3.0 <1.0.0',
    '@farcaster/miniapp-node': '>=0.1.5 <1.0.0',
@@ -465,7 +515,7 @@ export async function init(
    '@farcaster/miniapp-wagmi-connector': '^1.0.0',
    '@farcaster/mini-app-solana': '>=0.0.17 <1.0.0',
    '@farcaster/quick-auth': '>=0.0.7 <1.0.0',
-    '@neynar/react': '^1.2.5',
+    '@neynar/react': '^1.2.13',
    '@radix-ui/react-label': '^2.1.1',
    '@solana/wallet-adapter-react': '^0.15.38',
    '@tanstack/react-query': '^5.61.0',
@@ -486,27 +536,23 @@ export async function init(
    siwe: '^3.0.0',
  };

-  // Add auth-kit and next-auth dependencies if useSponsoredSigner is true
-  if (answers.useSponsoredSigner) {
-    packageJson.dependencies['@farcaster/auth-kit'] = '>=0.6.0 <1.0.0';
-    packageJson.dependencies['next-auth'] = '^4.24.11';
-  }
-
  packageJson.devDependencies = {
-    '@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',
-    localtunnel: '^2.0.2',
-    'pino-pretty': '^13.0.0',
-    postcss: '^8',
-    tailwindcss: '^3.4.1',
-    'ts-node': '^10.9.2',
-    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",
+    "localtunnel": "^2.0.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
@@ -514,6 +560,44 @@ export async function init(
    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
@@ -534,21 +618,21 @@ export async function init(
      let constantsContent = fs.readFileSync(constantsPath, 'utf8');

      // Helper function to escape single quotes in strings
-      const escapeString = str => str.replace(/'/g, "\\'");
+      const escapeString = (str) => str.replace(/'/g, "\\'");

      // Helper function to safely replace constants with validation
      const safeReplace = (content, pattern, replacement, constantName) => {
        const match = content.match(pattern);
        if (!match) {
          console.log(
-            `⚠️  Warning: Could not update ${constantName} in constants.ts. Pattern not found.`,
+            `⚠️  Warning: Could not update ${constantName} in constants.ts. Pattern not found.`
          );
          console.log(`Pattern: ${pattern}`);
          console.log(
            `Expected to match in: ${
-              content.split('\n').find(line => line.includes(constantName)) ||
+              content.split('\n').find((line) => line.includes(constantName)) ||
              'Not found'
-            }`,
+            }`
          );
        } else {
          const newContent = content.replace(pattern, replacement);
@@ -559,8 +643,7 @@ export async function init(

      // Regex patterns that match whole lines with export const (with TypeScript types)
      const patterns = {
-        APP_NAME:
-          /^export const APP_NAME\s*:\s*string\s*=\s*['"`][^'"`]*['"`];$/m,
+        APP_NAME: /^export const APP_NAME\s*:\s*string\s*=\s*['"`][^'"`]*['"`];$/m,
        APP_DESCRIPTION:
          /^export const APP_DESCRIPTION\s*:\s*string\s*=\s*['"`][^'"`]*['"`];$/m,
        APP_PRIMARY_CATEGORY:
@@ -568,76 +651,85 @@ export async function init(
        APP_TAGS: /^export const APP_TAGS\s*:\s*string\[\]\s*=\s*\[[^\]]*\];$/m,
        APP_BUTTON_TEXT:
          /^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,
+        USE_WALLET: /^export const USE_WALLET\s*:\s*boolean\s*=\s*(true|false);$/m,
        ANALYTICS_ENABLED:
          /^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)}';`,
-        'APP_NAME',
+        `export const APP_NAME: string = '${escapeString(answers.projectName)}';`,
+        'APP_NAME'
      );

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

      // Update APP_PRIMARY_CATEGORY (always update, null becomes empty string)
      constantsContent = safeReplace(
        constantsContent,
        patterns.APP_PRIMARY_CATEGORY,
-        `export const APP_PRIMARY_CATEGORY = '${escapeString(
-          answers.primaryCategory || '',
+        `export const APP_PRIMARY_CATEGORY: string = '${escapeString(
+          answers.primaryCategory || ''
        )}';`,
-        'APP_PRIMARY_CATEGORY',
+        'APP_PRIMARY_CATEGORY'
      );

      // Update APP_TAGS
      const tagsString =
        answers.tags.length > 0
-          ? `['${answers.tags.map(tag => escapeString(tag)).join("', '")}']`
+          ? `['${answers.tags.map((tag) => escapeString(tag)).join("', '")}']`
          : "['neynar', 'starter-kit', 'demo']";
      constantsContent = safeReplace(
        constantsContent,
        patterns.APP_TAGS,
-        `export const APP_TAGS = ${tagsString};`,
-        'APP_TAGS',
+        `export const APP_TAGS: string[] = ${tagsString};`,
+        'APP_TAGS'
      );

      // Update APP_BUTTON_TEXT (always update, use answers value)
      constantsContent = safeReplace(
        constantsContent,
        patterns.APP_BUTTON_TEXT,
-        `export const APP_BUTTON_TEXT = '${escapeString(
-          answers.buttonText || '',
+        `export const APP_BUTTON_TEXT: string = '${escapeString(
+          answers.buttonText || ''
        )}';`,
-        'APP_BUTTON_TEXT',
+        'APP_BUTTON_TEXT'
      );

      // Update USE_WALLET
      constantsContent = safeReplace(
        constantsContent,
        patterns.USE_WALLET,
-        `export const USE_WALLET = ${answers.useWallet};`,
-        'USE_WALLET',
+        `export const USE_WALLET: boolean = ${answers.useWallet};`,
+        'USE_WALLET'
      );

      // Update ANALYTICS_ENABLED
      constantsContent = safeReplace(
        constantsContent,
        patterns.ANALYTICS_ENABLED,
-        `export const ANALYTICS_ENABLED = ${answers.enableAnalytics};`,
-        'ANALYTICS_ENABLED',
+        `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);
@@ -645,30 +737,33 @@ export async function init(
      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}"`);
    } else if (useNeynar) {
      console.log(
-        '\n⚠️  Could not find a Neynar client ID and/or API key. Please configure Neynar manually in .env.local with NEYNAR_API_KEY and NEYNAR_CLIENT_ID',
+        '\n⚠️  Could not find a Neynar client ID and/or API key. Please configure Neynar manually in .env.local with NEYNAR_API_KEY and NEYNAR_CLIENT_ID'
      );
    }
    if (answers.seedPhrase) {
+      console.log('✅ Writing SEED_PHRASE and NEXTAUTH_SECRET to .env.local');
      fs.appendFileSync(envPath, `\nSEED_PHRASE="${answers.seedPhrase}"`);
+      // Add NextAuth secret for SIWN
+      fs.appendFileSync(
+        envPath,
+        `\nNEXTAUTH_SECRET="${crypto.randomBytes(32).toString('hex')}"`
+      );
    }
    fs.appendFileSync(envPath, `\nUSE_TUNNEL="${answers.useTunnel}"`);
    if (answers.useSponsoredSigner) {
-      fs.appendFileSync(envPath, `\nSPONSOR_SIGNER="${answers.useSponsoredSigner}"`);
+      fs.appendFileSync(envPath, `\nSPONSOR_SIGNER="true"`);
    }

    fs.unlinkSync(envExamplePath);
  } else {
    console.log(
-      '\n.env.example does not exist, skipping copy and remove operations',
+      '\n.env.example does not exist, skipping copy and remove operations'
    );
  }

@@ -707,13 +802,85 @@ export async function init(
    fs.rmSync(binPath, { recursive: true, force: true });
  }

-  // Remove NeynarAuthButton directory if useSponsoredSigner is false
-  if (!answers.useSponsoredSigner) {
-    console.log('\nRemoving NeynarAuthButton directory (useSponsoredSigner is false)...');
+  // 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
@@ -722,7 +889,7 @@ export async function init(
  execSync('git add .', { cwd: projectPath });
  execSync(
    'git commit -m "initial commit from @neynar/create-farcaster-mini-app"',
-    { cwd: projectPath },
+    { cwd: projectPath }
  );

  // Calculate border length based on message length
--- a/components.json
+++ b/components.json
@@ -18,4 +18,4 @@
    "hooks": "~/hooks"
  },
  "iconLibrary": "lucide"
-}
+}
--- a/index.d.ts
+++ b/index.d.ts
@@ -2,4 +2,4 @@
 * Initialize a new Farcaster mini app project
 * @returns Promise<void>
 */
-export function init(): Promise<void>;
+export function init(): Promise<void>; 
--- a/next.config.ts
+++ b/next.config.ts
@@ -1,4 +1,4 @@
-import type { NextConfig } from 'next';
+import type { NextConfig } from "next";

 const nextConfig: NextConfig = {
  /* config options here */
--- 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.7.4",
+  "version": "1.8.13",
  "type": "module",
  "private": false,
  "access": "public",
@@ -35,10 +35,7 @@
    "build:raw": "next build",
    "start": "next start",
    "lint": "next lint",
-    "lint:fix": "next lint --fix",
-    "format:check": "prettier --check .",
-    "format": "prettier --write . && eslint --fix . --max-warnings 50",
-    "deploy:vercel": "ts-node scripts/deploy.ts",
+    "deploy:vercel": "tsx scripts/deploy.ts",
    "deploy:raw": "vercel --prod",
    "cleanup": "node scripts/cleanup.js"
  },
@@ -53,11 +50,18 @@
  "devDependencies": {
    "@neynar/nodejs-sdk": "^2.19.0",
    "@types/node": "^22.13.10",
-    "@typescript-eslint/eslint-plugin": "^8.35.1",
-    "@typescript-eslint/parser": "^8.35.1",
-    "eslint": "^8.57.0",
-    "eslint-config-next": "^15.0.0",
-    "prettier": "^3.3.3",
    "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/cleanup.js
+++ b/scripts/cleanup.js
@@ -21,13 +21,13 @@ args.forEach((arg, index) => {

 try {
  console.log(`Checking for processes on port ${port}...`);
-
+  
  // Find processes using the port
  const pids = execSync(`lsof -ti :${port}`, { encoding: 'utf8' }).trim();
-
+  
  if (pids) {
    console.log(`Found processes: ${pids.replace(/\n/g, ', ')}`);
-
+    
    // Kill the processes
    execSync(`kill -9 ${pids.replace(/\n/g, ' ')}`);
    console.log(`✓ Processes on port ${port} have been terminated`);
@@ -42,4 +42,4 @@ try {
    console.error(`Error: ${error.message}`);
    process.exit(1);
  }
-}
+}
--- a/scripts/deploy.ts
+++ b/scripts/deploy.ts
@@ -5,8 +5,9 @@ import os from 'os';
 import { fileURLToPath } from 'url';
 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';
+import { APP_NAME, APP_BUTTON_TEXT } from '../src/lib/constants.js';

 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const projectRoot = path.join(__dirname, '..');
@@ -114,35 +115,147 @@ async function checkRequiredEnvVars(): Promise<void> {
          `${newLine}${varConfig.name}="${value.trim()}"`,
        );
      }
+    }

-      // Ask about sponsor signer if SEED_PHRASE is provided
-      if (!process.env.SPONSOR_SIGNER) {
-        const { sponsorSigner } = await inquirer.prompt([
-          {
-            type: 'confirm',
-            name: 'sponsorSigner',
-            message:
-              '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,
+    // 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',
+          default: false,
+        },
+      ]);
+
+      process.env.SPONSOR_SIGNER = sponsorSigner.toString();
+
+      fs.appendFileSync(
+        '.env.local',
+        `\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);

-        process.env.SPONSOR_SIGNER = sponsorSigner.toString();
-
-        if (process.env.SEED_PHRASE) {
-          fs.appendFileSync(
-            '.env.local',
-            `\nSPONSOR_SIGNER="${sponsorSigner}"`,
-          );
-          console.log('✅ Sponsor signer preference stored in .env.local');
-        }
+      // 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 &&
@@ -604,7 +717,7 @@ async function deployToVercel(useGitHub = false): Promise<void> {
      try {
        const projects = await vercelClient.projects.getProjects({});
        const project = projects.projects.find(
-          p => p.id === projectId || p.name === projectId,
+          (p: any) => p.id === projectId || p.name === projectId,
        );
        if (project) {
          projectName = project.name;
@@ -666,6 +779,8 @@ async function deployToVercel(useGitHub = false): Promise<void> {
    }

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

@@ -679,6 +794,14 @@ async function deployToVercel(useGitHub = false): Promise<void> {
        SPONSOR_SIGNER: process.env.SPONSOR_SIGNER,
      }),

+      // 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_'),
@@ -774,6 +897,11 @@ async function deployToVercel(useGitHub = false): Promise<void> {
        NEXT_PUBLIC_URL: `https://${actualDomain}`,
      };

+      // Include NextAuth URL if SEED_PHRASE is present (SIWN enabled)
+      if (process.env.SEED_PHRASE) {
+        updatedEnv.NEXTAUTH_URL = `https://${actualDomain}`;
+      }
+
      await setEnvironmentVariables(
        vercelClient,
        projectId,
@@ -813,55 +941,17 @@ async function deployToVercel(useGitHub = false): Promise<void> {
    console.log(
      '\n📝 You can manage your project at https://vercel.com/dashboard',
    );
-
-    // Prompt user to sign manifest in browser and paste accountAssociation
+    
+    // Remind user about account association if not already set
    console.log(
-      `\n⚠️  To complete your mini app manifest, you must sign it using the Farcaster developer portal.`,
+      `\n💡 Remember: If you haven't already signed your manifest, go to:`,
    );
    console.log(
-      '1. Go to: https://farcaster.xyz/~/developers/mini-apps/manifest?domain=' +
-        domain,
+      `   https://farcaster.xyz/~/developers/mini-apps/manifest?domain=${domain}`,
    );
    console.log(
-      '2. Click "Transfer Ownership" and follow the instructions to sign the manifest.',
+      '   to complete the ownership transfer and update APP_ACCOUNT_ASSOCIATION in src/lib/constants.ts',
    );
-    console.log(
-      '3. Copy the resulting accountAssociation JSON from the browser.',
-    );
-    console.log('4. Paste it below when prompted.');
-
-    const { userAccountAssociation } = await inquirer.prompt([
-      {
-        type: 'editor',
-        name: 'userAccountAssociation',
-        message: 'Paste the accountAssociation JSON here:',
-        validate: (input: string) => {
-          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 src/lib/constants.ts
-    const constantsPath = path.join(projectRoot, 'src', 'lib', 'constants.ts');
-    let constantsContent = fs.readFileSync(constantsPath, 'utf8');
-
-    // Replace the APP_ACCOUNT_ASSOCIATION line using a robust, anchored, multiline regex
-    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('\n✅ APP_ACCOUNT_ASSOCIATION updated in src/lib/constants.ts');
  } catch (error: unknown) {
    if (error instanceof Error) {
      console.error('\n❌ Deployment failed:', error.message);
@@ -960,4 +1050,4 @@ async function main(): Promise<void> {
  }
 }

-main();
+main();
--- a/scripts/dev.js
+++ b/scripts/dev.js
@@ -1,9 +1,9 @@
+import localtunnel from 'localtunnel';
 import { spawn } from 'child_process';
 import { createServer } from 'net';
+import dotenv from 'dotenv';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import dotenv from 'dotenv';
-import localtunnel from 'localtunnel';

 // Load environment variables
 dotenv.config({ path: '.env.local' });
@@ -33,18 +33,18 @@ args.forEach((arg, index) => {
 });

 async function checkPort(port) {
-  return new Promise(resolve => {
+  return new Promise((resolve) => {
    const server = createServer();
-
+    
    server.once('error', () => {
      resolve(true); // Port is in use
    });
-
+    
    server.once('listening', () => {
      server.close();
      resolve(false); // Port is free
    });
-
+    
    server.listen(port);
  });
 }
@@ -54,32 +54,29 @@ async function killProcessOnPort(port) {
    if (process.platform === 'win32') {
      // Windows: Use netstat to find the process
      const netstat = spawn('netstat', ['-ano', '|', 'findstr', `:${port}`]);
-      netstat.stdout.on('data', data => {
+      netstat.stdout.on('data', (data) => {
        const match = data.toString().match(/\s+(\d+)$/);
        if (match) {
          const pid = match[1];
          spawn('taskkill', ['/F', '/PID', pid]);
        }
      });
-      await new Promise(resolve => netstat.on('close', resolve));
+      await new Promise((resolve) => netstat.on('close', resolve));
    } else {
      // Unix-like systems: Use lsof
      const lsof = spawn('lsof', ['-ti', `:${port}`]);
-      lsof.stdout.on('data', data => {
-        data
-          .toString()
-          .split('\n')
-          .forEach(pid => {
-            if (pid) {
-              try {
-                process.kill(parseInt(pid), 'SIGKILL');
-              } catch (e) {
-                if (e.code !== 'ESRCH') throw e;
-              }
+      lsof.stdout.on('data', (data) => {
+        data.toString().split('\n').forEach(pid => {
+          if (pid) {
+            try {
+              process.kill(parseInt(pid), 'SIGKILL');
+            } catch (e) {
+              if (e.code !== 'ESRCH') throw e;
            }
-          });
+          }
+        });
      });
-      await new Promise(resolve => lsof.on('close', resolve));
+      await new Promise((resolve) => lsof.on('close', resolve));
    }
  } catch (e) {
    // Ignore errors if no process found
@@ -90,15 +87,13 @@ async function startDev() {
  // Check if the specified port is already in use
  const isPortInUse = await checkPort(port);
  if (isPortInUse) {
-    console.error(
-      `Port ${port} is already in use. To find and kill the process using this port:\n\n` +
-        (process.platform === 'win32'
-          ? `1. Run: netstat -ano | findstr :${port}\n` +
-            '2. Note the PID (Process ID) from the output\n' +
-            '3. Run: taskkill /PID <PID> /F\n'
-          : 'On macOS/Linux, run:\nnpm run cleanup\n') +
-        '\nThen try running this command again.',
-    );
+    console.error(`Port ${port} is already in use. To find and kill the process using this port:\n\n` +
+      (process.platform === 'win32' 
+        ? `1. Run: netstat -ano | findstr :${port}\n` +
+          '2. Note the PID (Process ID) from the output\n' +
+          '3. Run: taskkill /PID <PID> /F\n'
+        : `On macOS/Linux, run:\nnpm run cleanup\n`) +
+      '\nThen try running this command again.');
    process.exit(1);
  }

@@ -110,9 +105,7 @@ async function startDev() {
    tunnel = await localtunnel({ port: port });
    let ip;
    try {
-      ip = await fetch('https://ipv4.icanhazip.com')
-        .then(res => res.text())
-        .then(ip => ip.trim());
+      ip = await fetch('https://ipv4.icanhazip.com').then(res => res.text()).then(ip => ip.trim());
    } catch (error) {
      console.error('Error getting IP address:', error);
    }
@@ -150,17 +143,15 @@ async function startDev() {
   4. Click "Preview" to test your mini app (note that it may take ~5 seconds to load the first time)
 `);
  }
-
+  
  // Start next dev with appropriate configuration
-  const nextBin = path.normalize(
-    path.join(projectRoot, 'node_modules', '.bin', 'next'),
-  );
+  const nextBin = path.normalize(path.join(projectRoot, 'node_modules', '.bin', 'next'));

  nextDev = spawn(nextBin, ['dev', '-p', port.toString()], {
    stdio: 'inherit',
-    env: { ...process.env, NEXT_PUBLIC_URL: miniAppUrl },
+    env: { ...process.env, NEXT_PUBLIC_URL: miniAppUrl, NEXTAUTH_URL: miniAppUrl },
    cwd: projectRoot,
-    shell: process.platform === 'win32', // Add shell option for Windows
+    shell: process.platform === 'win32' // Add shell option for Windows
  });

  // Handle cleanup
@@ -190,7 +181,7 @@ async function startDev() {
          console.log('Note: Next.js process already terminated');
        }
      }
-
+      
      if (tunnel) {
        try {
          await tunnel.close();
@@ -218,4 +209,4 @@ async function startDev() {
  }
 }

-startDev().catch(console.error);
+startDev().catch(console.error); 
--- a/src/app/.well-known/farcaster.json/route.ts
+++ b/src/app/.well-known/farcaster.json/route.ts
@@ -7,6 +7,7 @@ export async function GET() {
    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/[...nextauth]/route.ts
+++ b/src/app/api/auth/[...nextauth]/route.ts
@@ -0,0 +1,6 @@
+import NextAuth from "next-auth"
+import { authOptions } from "~/auth"
+
+const handler = NextAuth(authOptions)
+
+export { handler as GET, handler as POST }
--- a/src/app/api/auth/nonce/route.ts
+++ b/src/app/api/auth/nonce/route.ts
@@ -10,7 +10,7 @@ export async function GET() {
    console.error('Error fetching nonce:', error);
    return NextResponse.json(
      { error: 'Failed to fetch nonce' },
-      { status: 500 },
+      { status: 500 }
    );
  }
 }
--- a/src/app/api/auth/session-signers/route.ts
+++ b/src/app/api/auth/session-signers/route.ts
@@ -10,7 +10,7 @@ export async function GET(request: Request) {
    if (!message || !signature) {
      return NextResponse.json(
        { error: 'Message and signature are required' },
-        { status: 400 },
+        { status: 400 }
      );
    }

@@ -37,7 +37,7 @@ export async function GET(request: Request) {
    console.error('Error in session-signers API:', error);
    return NextResponse.json(
      { error: 'Failed to fetch signers' },
-      { status: 500 },
+      { status: 500 }
    );
  }
 }
--- a/src/app/api/auth/signer/route.ts
+++ b/src/app/api/auth/signer/route.ts
@@ -10,7 +10,7 @@ export async function POST() {
    console.error('Error fetching signer:', error);
    return NextResponse.json(
      { error: 'Failed to fetch signer' },
-      { status: 500 },
+      { status: 500 }
    );
  }
 }
@@ -22,7 +22,7 @@ export async function GET(request: Request) {
  if (!signerUuid) {
    return NextResponse.json(
      { error: 'signerUuid is required' },
-      { status: 400 },
+      { status: 400 }
    );
  }

@@ -36,7 +36,7 @@ export async function GET(request: Request) {
    console.error('Error fetching signed key:', error);
    return NextResponse.json(
      { error: 'Failed to fetch signed key' },
-      { status: 500 },
+      { status: 500 }
    );
  }
 }
--- a/src/app/api/auth/signer/signed_key/route.ts
+++ b/src/app/api/auth/signer/signed_key/route.ts
@@ -1,10 +1,10 @@
 import { NextResponse } from 'next/server';
+import { getNeynarClient } from '~/lib/neynar';
 import { mnemonicToAccount } from 'viem/accounts';
 import {
  SIGNED_KEY_REQUEST_TYPE,
  SIGNED_KEY_REQUEST_VALIDATOR_EIP_712_DOMAIN,
 } from '~/lib/constants';
-import { getNeynarClient } from '~/lib/neynar';

 const postRequiredFields = ['signerUuid', 'publicKey'];

@@ -16,7 +16,7 @@ export async function POST(request: Request) {
    if (!body[field]) {
      return NextResponse.json(
        { error: `${field} is required` },
-        { status: 400 },
+        { status: 400 }
      );
    }
  }
@@ -26,7 +26,7 @@ export async function POST(request: Request) {
  if (redirectUrl && typeof redirectUrl !== 'string') {
    return NextResponse.json(
      { error: 'redirectUrl must be a string' },
-      { status: 400 },
+      { status: 400 }
    );
  }

@@ -38,7 +38,7 @@ export async function POST(request: Request) {
    if (!seedPhrase) {
      return NextResponse.json(
        { error: 'App configuration missing (SEED_PHRASE or FID)' },
-        { status: 500 },
+        { status: 500 }
      );
    }

@@ -85,7 +85,7 @@ export async function POST(request: Request) {
    console.error('Error registering signed key:', error);
    return NextResponse.json(
      { error: 'Failed to register signed key' },
-      { status: 500 },
+      { status: 500 }
    );
  }
 }
--- a/src/app/api/auth/signers/route.ts
+++ b/src/app/api/auth/signers/route.ts
@@ -13,7 +13,7 @@ export async function GET(request: Request) {
        {
          error: `${param} parameter is required`,
        },
-        { status: 400 },
+        { status: 400 }
      );
    }
  }
@@ -32,7 +32,7 @@ export async function GET(request: Request) {
    console.error('Error fetching signers:', error);
    return NextResponse.json(
      { error: 'Failed to fetch signers' },
-      { status: 500 },
+      { status: 500 }
    );
  }
 }
--- a/src/app/api/auth/validate/route.ts
+++ b/src/app/api/auth/validate/route.ts
@@ -43,4 +43,4 @@ export async function POST(request: Request) {
      { status: 500 },
    );
  }
-}
+}
--- a/src/app/api/best-friends/route.ts
+++ b/src/app/api/best-friends/route.ts
@@ -4,21 +4,18 @@ export async function GET(request: Request) {
  const apiKey = process.env.NEYNAR_API_KEY;
  const { searchParams } = new URL(request.url);
  const fid = searchParams.get('fid');
-
+  
  if (!apiKey) {
    return NextResponse.json(
-      {
-        error:
-          'Neynar API key is not configured. Please add NEYNAR_API_KEY to your environment variables.',
-      },
-      { status: 500 },
+      { error: 'Neynar API key is not configured. Please add NEYNAR_API_KEY to your environment variables.' },
+      { status: 500 }
    );
  }

  if (!fid) {
    return NextResponse.json(
      { error: 'FID parameter is required' },
-      { status: 400 },
+      { status: 400 }
    );
  }

@@ -27,28 +24,23 @@ export async function GET(request: Request) {
      `https://api.neynar.com/v2/farcaster/user/best_friends?fid=${fid}&limit=3`,
      {
        headers: {
-          'x-api-key': apiKey,
+          "x-api-key": apiKey,
        },
-      },
+      }
    );

    if (!response.ok) {
      throw new Error(`Neynar API error: ${response.statusText}`);
    }

-    const { users } = (await response.json()) as {
-      users: { user: { fid: number; username: string } }[];
-    };
+    const { users } = await response.json() as { users: { user: { fid: number; username: string } }[] };

    return NextResponse.json({ bestFriends: users });
  } catch (error) {
    console.error('Failed to fetch best friends:', error);
    return NextResponse.json(
-      {
-        error:
-          'Failed to fetch best friends. Please check your Neynar API key and try again.',
-      },
-      { status: 500 },
+      { error: 'Failed to fetch best friends. Please check your Neynar API key and try again.' },
+      { status: 500 }
    );
  }
-}
+} 
--- a/src/app/api/opengraph-image/route.tsx
+++ b/src/app/api/opengraph-image/route.tsx
@@ -1,6 +1,6 @@
-import { ImageResponse } from 'next/og';
-import { NextRequest } from 'next/server';
-import { getNeynarUser } from '~/lib/neynar';
+import { ImageResponse } from "next/og";
+import { NextRequest } from "next/server";
+import { getNeynarUser } from "~/lib/neynar";

 export const dynamic = 'force-dynamic';

@@ -15,24 +15,16 @@ export async function GET(request: NextRequest) {
      <div tw="flex h-full w-full flex-col justify-center items-center relative bg-primary">
        {user?.pfp_url && (
          <div tw="flex w-96 h-96 rounded-full overflow-hidden mb-8 border-8 border-white">
-            <img
-              src={user.pfp_url}
-              alt="Profile"
-              tw="w-full h-full object-cover"
-            />
+            <img src={user.pfp_url} alt="Profile" tw="w-full h-full object-cover" />
          </div>
        )}
-        <h1 tw="text-8xl text-white">
-          {user?.display_name
-            ? `Hello from ${user.display_name ?? user.username}!`
-            : 'Hello!'}
-        </h1>
+        <h1 tw="text-8xl text-white">{user?.display_name ? `Hello from ${user.display_name ?? user.username}!` : 'Hello!'}</h1>
        <p tw="text-5xl mt-4 text-white opacity-80">Powered by Neynar 🪐</p>
      </div>
    ),
    {
      width: 1200,
      height: 800,
-    },
+    }
  );
-}
+}
--- a/src/app/api/send-notification/route.ts
+++ b/src/app/api/send-notification/route.ts
@@ -1,9 +1,9 @@
-import { NextRequest } from 'next/server';
-import { notificationDetailsSchema } from '@farcaster/miniapp-sdk';
-import { z } from 'zod';
-import { setUserNotificationDetails } from '~/lib/kv';
-import { sendNeynarMiniAppNotification } from '~/lib/neynar';
-import { sendMiniAppNotification } from '~/lib/notifs';
+import { notificationDetailsSchema } from "@farcaster/miniapp-sdk";
+import { NextRequest } from "next/server";
+import { z } from "zod";
+import { setUserNotificationDetails } from "~/lib/kv";
+import { sendMiniAppNotification } from "~/lib/notifs";
+import { sendNeynarMiniAppNotification } from "~/lib/neynar";

 const requestSchema = z.object({
  fid: z.number(),
@@ -13,8 +13,7 @@ const requestSchema = z.object({
 export async function POST(request: NextRequest) {
  // If Neynar is enabled, we don't need to store notification details
  // as they will be managed by Neynar's system
-  const neynarEnabled =
-    process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID;
+  const neynarEnabled = process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID;

  const requestJson = await request.json();
  const requestBody = requestSchema.safeParse(requestJson);
@@ -22,7 +21,7 @@ export async function POST(request: NextRequest) {
  if (requestBody.success === false) {
    return Response.json(
      { success: false, errors: requestBody.error.errors },
-      { status: 400 },
+      { status: 400 }
    );
  }

@@ -30,29 +29,27 @@ export async function POST(request: NextRequest) {
  if (!neynarEnabled) {
    await setUserNotificationDetails(
      Number(requestBody.data.fid),
-      requestBody.data.notificationDetails,
+      requestBody.data.notificationDetails
    );
  }

  // Use appropriate notification function based on Neynar status
-  const sendNotification = neynarEnabled
-    ? sendNeynarMiniAppNotification
-    : sendMiniAppNotification;
+  const sendNotification = neynarEnabled ? sendNeynarMiniAppNotification : sendMiniAppNotification;
  const sendResult = await sendNotification({
    fid: Number(requestBody.data.fid),
-    title: 'Test notification',
-    body: 'Sent at ' + new Date().toISOString(),
+    title: "Test notification",
+    body: "Sent at " + new Date().toISOString(),
  });

-  if (sendResult.state === 'error') {
+  if (sendResult.state === "error") {
    return Response.json(
      { success: false, error: sendResult.error },
-      { status: 500 },
+      { status: 500 }
    );
-  } else if (sendResult.state === 'rate_limit') {
+  } else if (sendResult.state === "rate_limit") {
    return Response.json(
-      { success: false, error: 'Rate limited' },
-      { status: 429 },
+      { success: false, error: "Rate limited" },
+      { status: 429 }
    );
  }

--- a/src/app/api/users/route.ts
+++ b/src/app/api/users/route.ts
@@ -1,32 +1,29 @@
-import { NextResponse } from 'next/server';
 import { NeynarAPIClient } from '@neynar/nodejs-sdk';
+import { NextResponse } from 'next/server';

 export async function GET(request: Request) {
  const apiKey = process.env.NEYNAR_API_KEY;
  const { searchParams } = new URL(request.url);
  const fids = searchParams.get('fids');
-
+  
  if (!apiKey) {
    return NextResponse.json(
-      {
-        error:
-          'Neynar API key is not configured. Please add NEYNAR_API_KEY to your environment variables.',
-      },
-      { status: 500 },
+      { error: 'Neynar API key is not configured. Please add NEYNAR_API_KEY to your environment variables.' },
+      { status: 500 }
    );
  }

  if (!fids) {
    return NextResponse.json(
      { error: 'FIDs parameter is required' },
-      { status: 400 },
+      { status: 400 }
    );
  }

  try {
    const neynar = new NeynarAPIClient({ apiKey });
    const fidsArray = fids.split(',').map(fid => parseInt(fid.trim()));
-
+    
    const { users } = await neynar.fetchBulkUsers({
      fids: fidsArray,
    });
@@ -35,11 +32,8 @@ export async function GET(request: Request) {
  } catch (error) {
    console.error('Failed to fetch users:', error);
    return NextResponse.json(
-      {
-        error:
-          'Failed to fetch users. Please check your Neynar API key and try again.',
-      },
-      { status: 500 },
+      { error: 'Failed to fetch users. Please check your Neynar API key and try again.' },
+      { status: 500 }
    );
  }
 }
--- a/src/app/api/webhook/route.ts
+++ b/src/app/api/webhook/route.ts
@@ -1,21 +1,20 @@
-import { NextRequest } from 'next/server';
 import {
  ParseWebhookEvent,
  parseWebhookEvent,
  verifyAppKeyWithNeynar,
-} from '@farcaster/miniapp-node';
-import { APP_NAME } from '~/lib/constants';
+} from "@farcaster/miniapp-node";
+import { NextRequest } from "next/server";
+import { APP_NAME } from "~/lib/constants";
 import {
  deleteUserNotificationDetails,
  setUserNotificationDetails,
-} from '~/lib/kv';
-import { sendMiniAppNotification } from '~/lib/notifs';
+} from "~/lib/kv";
+import { sendMiniAppNotification } from "~/lib/notifs";

 export async function POST(request: NextRequest) {
  // If Neynar is enabled, we don't need to handle webhooks here
  // as they will be handled by Neynar's webhook endpoint
-  const neynarEnabled =
-    process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID;
+  const neynarEnabled = process.env.NEYNAR_API_KEY && process.env.NEYNAR_CLIENT_ID;
  if (neynarEnabled) {
    return Response.json({ success: true });
  }
@@ -29,24 +28,24 @@ export async function POST(request: NextRequest) {
    const error = e as ParseWebhookEvent.ErrorType;

    switch (error.name) {
-      case 'VerifyJsonFarcasterSignature.InvalidDataError':
-      case 'VerifyJsonFarcasterSignature.InvalidEventDataError':
+      case "VerifyJsonFarcasterSignature.InvalidDataError":
+      case "VerifyJsonFarcasterSignature.InvalidEventDataError":
        // The request data is invalid
        return Response.json(
          { success: false, error: error.message },
-          { status: 400 },
+          { status: 400 }
        );
-      case 'VerifyJsonFarcasterSignature.InvalidAppKeyError':
+      case "VerifyJsonFarcasterSignature.InvalidAppKeyError":
        // The app key is invalid
        return Response.json(
          { success: false, error: error.message },
-          { status: 401 },
+          { status: 401 }
        );
-      case 'VerifyJsonFarcasterSignature.VerifyAppKeyError':
+      case "VerifyJsonFarcasterSignature.VerifyAppKeyError":
        // Internal error verifying the app key (caller may want to try again)
        return Response.json(
          { success: false, error: error.message },
-          { status: 500 },
+          { status: 500 }
        );
    }
  }
@@ -57,33 +56,33 @@ 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({
          fid,
          title: `Welcome to ${APP_NAME}`,
-          body: 'Mini app is now added to your client',
+          body: "Mini app is now added to your client",
        });
      } else {
        await deleteUserNotificationDetails(fid);
      }
      break;

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

-    case 'notifications_enabled':
+    case "notifications_enabled":
      await setUserNotificationDetails(fid, event.notificationDetails);
      await sendMiniAppNotification({
        fid,
        title: `Welcome to ${APP_NAME}`,
-        body: 'Notifications are now enabled',
+        body: "Notifications are now enabled",
      });
      break;

-    case 'notifications_disabled':
+    case "notifications_disabled":
      await deleteUserNotificationDetails(fid);
      break;
  }
--- a/src/app/app.tsx
+++ b/src/app/app.tsx
@@ -1,15 +1,15 @@
-'use client';
+"use client";

-import dynamic from 'next/dynamic';
-import { APP_NAME } from '~/lib/constants';
+import dynamic from "next/dynamic";
+import { APP_NAME } from "~/lib/constants";

 // note: dynamic import is required for components that use the Frame SDK
-const AppComponent = dynamic(() => import('~/components/App'), {
+const AppComponent = dynamic(() => import("~/components/App"), {
  ssr: false,
 });

 export default function App(
-  { title }: { title?: string } = { title: APP_NAME },
+  { title }: { title?: string } = { title: APP_NAME }
 ) {
  return <AppComponent title={title} />;
 }
--- a/src/app/globals.css
+++ b/src/app/globals.css
@@ -62,11 +62,11 @@ body {
  .container {
    @apply mx-auto max-w-md px-4;
  }
-
+  
  .container-wide {
    @apply mx-auto max-w-lg px-4;
  }
-
+  
  .container-narrow {
    @apply mx-auto max-w-sm px-4;
  }
@@ -75,7 +75,7 @@ body {
  .card {
    @apply bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700 shadow-sm;
  }
-
+  
  .card-primary {
    @apply bg-primary/10 border-primary/20;
  }
@@ -84,15 +84,15 @@ body {
  .btn {
    @apply inline-flex items-center justify-center rounded-lg px-4 py-2 text-sm font-medium transition-colors focus:outline-none focus:ring-2 focus:ring-offset-2 disabled:opacity-50 disabled:pointer-events-none;
  }
-
+  
  .btn-primary {
    @apply bg-primary text-white hover:bg-primary-dark focus:ring-primary;
  }
-
+  
  .btn-secondary {
    @apply bg-secondary text-gray-900 hover:bg-gray-200 focus:ring-gray-500 dark:bg-secondary-dark dark:text-gray-100 dark:hover:bg-gray-600;
  }
-
+  
  .btn-outline {
    @apply border border-gray-300 bg-transparent hover:bg-gray-50 focus:ring-gray-500 dark:border-gray-600 dark:hover:bg-gray-800;
  }
@@ -106,7 +106,7 @@ body {
  .spinner {
    @apply animate-spin rounded-full border-2 border-gray-300 border-t-primary;
  }
-
+  
  .spinner-primary {
    @apply animate-spin rounded-full border-2 border-white border-t-transparent;
  }
--- 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,4 +1,5 @@
 import type { Metadata } from 'next';
+
 import '~/app/globals.css';
 import { Providers } from '~/app/providers';
 import { APP_NAME, APP_DESCRIPTION } from '~/lib/constants';
@@ -16,7 +17,9 @@ export default async function RootLayout({
  return (
    <html lang="en">
      <body>
-        <Providers>{children}</Providers>
+        <Providers>
+          {children}
+        </Providers>
      </body>
    </html>
  );
--- a/src/app/page.tsx
+++ b/src/app/page.tsx
@@ -1,7 +1,7 @@
-import { Metadata } from 'next';
-import { APP_NAME, APP_DESCRIPTION, APP_OG_IMAGE_URL } from '~/lib/constants';
-import { getMiniAppEmbedMetadata } from '~/lib/utils';
-import App from './app';
+import { Metadata } from "next";
+import App from "./app";
+import { APP_NAME, APP_DESCRIPTION, APP_OG_IMAGE_URL } from "~/lib/constants";
+import { getMiniAppEmbedMetadata } from "~/lib/utils";

 export const revalidate = 300;

@@ -14,11 +14,11 @@ export async function generateMetadata(): Promise<Metadata> {
      images: [APP_OG_IMAGE_URL],
    },
    other: {
-      'fc:frame': JSON.stringify(getMiniAppEmbedMetadata()),
+      "fc:frame": JSON.stringify(getMiniAppEmbedMetadata()),
    },
  };
 }

 export default function Home() {
-  return <App />;
+  return (<App />);
 }
--- 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
@@ -3,16 +3,20 @@
 import dynamic from 'next/dynamic';
 import { MiniAppProvider } from '@neynar/react';
 import { SafeFarcasterSolanaProvider } from '~/components/providers/SafeFarcasterSolanaProvider';
-import { ANALYTICS_ENABLED } from '~/lib/constants';
+import { ANALYTICS_ENABLED, RETURN_URL } from '~/lib/constants';

 const WagmiProvider = dynamic(
  () => import('~/components/providers/WagmiProvider'),
  {
    ssr: false,
-  },
+  }
 );

-export function Providers({ children }: { children: React.ReactNode }) {
+export function Providers({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
  const solanaEndpoint =
    process.env.SOLANA_RPC_ENDPOINT || 'https://solana-rpc.publicnode.com';
  return (
@@ -20,6 +24,7 @@ export function Providers({ children }: { children: React.ReactNode }) {
      <MiniAppProvider
        analyticsEnabled={ANALYTICS_ENABLED}
        backButtonEnabled={true}
+        returnUrl={RETURN_URL}
      >
        <SafeFarcasterSolanaProvider endpoint={solanaEndpoint}>
          {children}
--- a/src/app/share/[fid]/page.tsx
+++ b/src/app/share/[fid]/page.tsx
@@ -1,7 +1,7 @@
-import { redirect } from 'next/navigation';
-import type { Metadata } from 'next';
-import { APP_URL, APP_NAME, APP_DESCRIPTION } from '~/lib/constants';
-import { getMiniAppEmbedMetadata } from '~/lib/utils';
+import type { Metadata } from "next";
+import { redirect } from "next/navigation";
+import { APP_URL, APP_NAME, APP_DESCRIPTION } from "~/lib/constants";
+import { getMiniAppEmbedMetadata } from "~/lib/utils";
 export const revalidate = 300;

 // This is an example of how to generate a dynamically generated share page based on fid:
@@ -23,12 +23,12 @@ export async function generateMetadata({
      images: [imageUrl],
    },
    other: {
-      'fc:frame': JSON.stringify(getMiniAppEmbedMetadata(imageUrl)),
+      "fc:frame": JSON.stringify(getMiniAppEmbedMetadata(imageUrl)),
    },
  };
 }

 export default function SharePage() {
  // redirect to home page
-  redirect('/');
+  redirect("/");
 }
--- a/src/auth.ts
+++ b/src/auth.ts
@@ -1,10 +1,374 @@
-import { sdk } from '@farcaster/miniapp-sdk';
+import { AuthOptions, getServerSession } from 'next-auth';
+import CredentialsProvider from 'next-auth/providers/credentials';
+import { createAppClient, viemConnector } from '@farcaster/auth-client';

-// Export QuickAuth from the SDK
-export const quickAuth = sdk.quickAuth;
+declare module 'next-auth' {
+  interface Session {
+    provider?: string;
+    user?: {
+      fid: number;
+      object?: 'user';
+      username?: string;
+      display_name?: string;
+      pfp_url?: string;
+      custody_address?: string;
+      profile?: {
+        bio: {
+          text: string;
+          mentioned_profiles?: Array<{
+            object: 'user_dehydrated';
+            fid: number;
+            username: string;
+            display_name: string;
+            pfp_url: string;
+            custody_address: string;
+          }>;
+          mentioned_profiles_ranges?: Array<{
+            start: number;
+            end: number;
+          }>;
+        };
+        location?: {
+          latitude: number;
+          longitude: number;
+          address: {
+            city: string;
+            state: string;
+            country: string;
+            country_code: string;
+          };
+        };
+      };
+      follower_count?: number;
+      following_count?: number;
+      verifications?: string[];
+      verified_addresses?: {
+        eth_addresses: string[];
+        sol_addresses: string[];
+        primary: {
+          eth_address: string;
+          sol_address: string;
+        };
+      };
+      verified_accounts?: Array<Record<string, unknown>>;
+      power_badge?: boolean;
+      url?: string;
+      experimental?: {
+        neynar_user_score: number;
+        deprecation_notice: string;
+      };
+      score?: number;
+    };
+    signers?: {
+      object: 'signer';
+      signer_uuid: string;
+      public_key: string;
+      status: 'approved';
+      fid: number;
+    }[];
+  }

-// Helper function to get session (for server-side compatibility)
-export const getSession = async () => {
-  // For QuickAuth, sessions are managed by the SDK
-  return null;
+  interface User {
+    provider?: string;
+    signers?: Array<{
+      object: 'signer';
+      signer_uuid: string;
+      public_key: string;
+      status: 'approved';
+      fid: number;
+    }>;
+    user?: {
+      object: 'user';
+      fid: number;
+      username: string;
+      display_name: string;
+      pfp_url: string;
+      custody_address: string;
+      profile: {
+        bio: {
+          text: string;
+          mentioned_profiles?: Array<{
+            object: 'user_dehydrated';
+            fid: number;
+            username: string;
+            display_name: string;
+            pfp_url: string;
+            custody_address: string;
+          }>;
+          mentioned_profiles_ranges?: Array<{
+            start: number;
+            end: number;
+          }>;
+        };
+        location?: {
+          latitude: number;
+          longitude: number;
+          address: {
+            city: string;
+            state: string;
+            country: string;
+            country_code: string;
+          };
+        };
+      };
+      follower_count: number;
+      following_count: number;
+      verifications: string[];
+      verified_addresses: {
+        eth_addresses: string[];
+        sol_addresses: string[];
+        primary: {
+          eth_address: string;
+          sol_address: string;
+        };
+      };
+      verified_accounts: Array<Record<string, unknown>>;
+      power_badge: boolean;
+      url?: string;
+      experimental?: {
+        neynar_user_score: number;
+        deprecation_notice: string;
+      };
+      score: number;
+    };
+  }
+
+  interface JWT {
+    provider?: string;
+    signers?: Array<{
+      object: 'signer';
+      signer_uuid: string;
+      public_key: string;
+      status: 'approved';
+      fid: number;
+    }>;
+    user?: {
+      object: 'user';
+      fid: number;
+      username: string;
+      display_name: string;
+      pfp_url: string;
+      custody_address: string;
+      profile: {
+        bio: {
+          text: string;
+          mentioned_profiles?: Array<{
+            object: 'user_dehydrated';
+            fid: number;
+            username: string;
+            display_name: string;
+            pfp_url: string;
+            custody_address: string;
+          }>;
+          mentioned_profiles_ranges?: Array<{
+            start: number;
+            end: number;
+          }>;
+        };
+        location?: {
+          latitude: number;
+          longitude: number;
+          address: {
+            city: string;
+            state: string;
+            country: string;
+            country_code: string;
+          };
+        };
+      };
+      follower_count: number;
+      following_count: number;
+      verifications: string[];
+      verified_addresses: {
+        eth_addresses: string[];
+        sol_addresses: string[];
+        primary: {
+          eth_address: string;
+          sol_address: string;
+        };
+      };
+      verified_accounts?: Array<Record<string, unknown>>;
+      power_badge?: boolean;
+      url?: string;
+      experimental?: {
+        neynar_user_score: number;
+        deprecation_notice: string;
+      };
+      score?: number;
+    };
+  }
+}
+
+function getDomainFromUrl(urlString: string | undefined): string {
+  if (!urlString) {
+    console.warn('NEXTAUTH_URL is not set, using localhost:3000 as fallback');
+    return 'localhost:3000';
+  }
+  try {
+    const url = new URL(urlString);
+    return url.hostname;
+  } catch (error) {
+    console.error('Invalid NEXTAUTH_URL:', urlString, error);
+    console.warn('Using localhost:3000 as fallback');
+    return 'localhost:3000';
+  }
+}
+
+export const authOptions: AuthOptions = {
+  // Configure one or more authentication providers
+  providers: [
+    CredentialsProvider({
+      id: 'neynar',
+      name: 'Sign in with Neynar',
+      credentials: {
+        message: {
+          label: 'Message',
+          type: 'text',
+          placeholder: '0x0',
+        },
+        signature: {
+          label: 'Signature',
+          type: 'text',
+          placeholder: '0x0',
+        },
+        nonce: {
+          label: 'Nonce',
+          type: 'text',
+          placeholder: 'Custom nonce (optional)',
+        },
+        fid: {
+          label: 'FID',
+          type: 'text',
+          placeholder: '0',
+        },
+        signers: {
+          label: 'Signers',
+          type: 'text',
+          placeholder: 'JSON string of signers',
+        },
+        user: {
+          label: 'User Data',
+          type: 'text',
+          placeholder: 'JSON string of user data',
+        },
+      },
+      async authorize(credentials) {
+        const nonce = credentials?.nonce;
+
+        if (!nonce) {
+          console.error('No nonce or CSRF token provided for Neynar auth');
+          return null;
+        }
+
+        // For Neynar, we can use a different validation approach
+        // This could involve validating against Neynar's API or using their SDK
+        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 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,
+            signature: credentials?.signature as `0x${string}`,
+            domain,
+            nonce,
+          });
+
+          const { success, fid } = verifyResponse;
+
+          if (!success) {
+            return null;
+          }
+
+          // Validate that the provided FID matches the verified FID
+          if (credentials?.fid && parseInt(credentials.fid) !== fid) {
+            console.error('FID mismatch in Neynar auth');
+            return null;
+          }
+
+          return {
+            id: fid.toString(),
+            provider: 'neynar',
+            signers: credentials?.signers
+              ? JSON.parse(credentials.signers)
+              : undefined,
+            user: credentials?.user ? JSON.parse(credentials.user) : undefined,
+          };
+        } catch (error) {
+          console.error('Error in Neynar auth:', error);
+          return null;
+        }
+      },
+    }),
+  ],
+  callbacks: {
+    session: async ({ session, token }) => {
+      // Set provider at the root level
+      session.provider = token.provider as string;
+
+      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;
+      }
+
+      return session;
+    },
+    jwt: async ({ token, user }) => {
+      if (user) {
+        token.provider = user.provider;
+        token.signers = user.signers;
+        token.user = user.user;
+      }
+      return token;
+    },
+  },
+  cookies: {
+    sessionToken: {
+      name: `next-auth.session-token`,
+      options: {
+        httpOnly: true,
+        sameSite: process.env.NODE_ENV === 'production' ? 'none' : 'lax',
+        path: '/',
+        secure: process.env.NODE_ENV === 'production',
+      },
+    },
+    callbackUrl: {
+      name: `next-auth.callback-url`,
+      options: {
+        sameSite: process.env.NODE_ENV === 'production' ? 'none' : 'lax',
+        path: '/',
+        secure: process.env.NODE_ENV === 'production',
+      },
+    },
+    csrfToken: {
+      name: `next-auth.csrf-token`,
+      options: {
+        httpOnly: true,
+        sameSite: process.env.NODE_ENV === 'production' ? 'none' : 'lax',
+        path: '/',
+        secure: process.env.NODE_ENV === 'production',
+      },
+    },
+  },
+};
+
+export const getSession = async () => {
+  try {
+    return await getServerSession(authOptions);
+  } catch (error) {
+    console.error('Error getting server session:', error);
+    return null;
+  }
 };
--- a/src/components/App.tsx
+++ b/src/components/App.tsx
@@ -1,24 +1,19 @@
-'use client';
+"use client";

-import { useEffect } from 'react';
-import { useMiniApp } from '@neynar/react';
-import { Footer } from '~/components/ui/Footer';
-import { Header } from '~/components/ui/Header';
-import {
-  HomeTab,
-  ActionsTab,
-  ContextTab,
-  WalletTab,
-} from '~/components/ui/tabs';
-import { USE_WALLET } from '~/lib/constants';
-import { useNeynarUser } from '../hooks/useNeynarUser';
+import { useEffect } from "react";
+import { useMiniApp } from "@neynar/react";
+import { Header } from "~/components/ui/Header";
+import { Footer } from "~/components/ui/Footer";
+import { HomeTab, ActionsTab, ContextTab, WalletTab } from "~/components/ui/tabs";
+import { USE_WALLET } from "~/lib/constants";
+import { useNeynarUser } from "../hooks/useNeynarUser";

 // --- Types ---
 export enum Tab {
-  Home = 'home',
-  Actions = 'actions',
-  Context = 'context',
-  Wallet = 'wallet',
+  Home = "home",
+  Actions = "actions",
+  Context = "context",
+  Wallet = "wallet",
 }

 export interface AppProps {
@@ -27,39 +22,44 @@ export interface AppProps {

 /**
 * App component serves as the main container for the mini app interface.
- *
+ * 
 * This component orchestrates the overall mini app experience by:
 * - Managing tab navigation and state
 * - Handling Farcaster mini app initialization
 * - Coordinating wallet and context state
 * - Providing error handling and loading states
 * - Rendering the appropriate tab content based on user selection
- *
+ * 
 * The component integrates with the Neynar SDK for Farcaster functionality
 * and Wagmi for wallet management. It provides a complete mini app
 * experience with multiple tabs for different functionality areas.
- *
+ * 
 * Features:
 * - Tab-based navigation (Home, Actions, Context, Wallet)
 * - Farcaster mini app integration
 * - Wallet connection management
 * - Error handling and display
 * - Loading states for async operations
- *
+ * 
 * @param props - Component props
 * @param props.title - Optional title for the mini app (defaults to "Neynar Starter Kit")
- *
+ * 
 * @example
 * ```tsx
 * <App title="My Mini App" />
 * ```
 */
 export default function App(
-  { title }: AppProps = { title: 'Neynar Starter Kit' },
+  { title }: AppProps = { title: "Neynar Starter Kit" }
 ) {
  // --- Hooks ---
-  const { isSDKLoaded, context, setInitialTab, setActiveTab, currentTab } =
-    useMiniApp();
+  const {
+    isSDKLoaded,
+    context,
+    setInitialTab,
+    setActiveTab,
+    currentTab,
+  } = useMiniApp();

  // --- Neynar user hook ---
  const { user: neynarUser } = useNeynarUser(context || undefined);
@@ -67,7 +67,7 @@ export default function App(
  // --- Effects ---
  /**
   * Sets the initial tab to "home" when the SDK is loaded.
-   *
+   * 
   * This effect ensures that users start on the home tab when they first
   * load the mini app. It only runs when the SDK is fully loaded to
   * prevent errors during initialization.
@@ -115,12 +115,9 @@ export default function App(
        {currentTab === Tab.Wallet && <WalletTab />}

        {/* Footer with navigation */}
-        <Footer
-          activeTab={currentTab as Tab}
-          setActiveTab={setActiveTab}
-          showWallet={USE_WALLET}
-        />
+        <Footer activeTab={currentTab as Tab} setActiveTab={setActiveTab} showWallet={USE_WALLET} />
      </div>
    </div>
  );
 }
+
--- a/src/components/providers/SafeFarcasterSolanaProvider.tsx
+++ b/src/components/providers/SafeFarcasterSolanaProvider.tsx
@@ -1,13 +1,10 @@
-import React, { createContext, useEffect, useState } from 'react';
-import dynamic from 'next/dynamic';
+import React, { createContext, useEffect, useState } from "react";
+import dynamic from "next/dynamic";
 import { sdk } from '@farcaster/miniapp-sdk';

 const FarcasterSolanaProvider = dynamic(
-  () =>
-    import('@farcaster/mini-app-solana').then(
-      mod => mod.FarcasterSolanaProvider,
-    ),
-  { ssr: false },
+  () => import('@farcaster/mini-app-solana').then(mod => mod.FarcasterSolanaProvider),
+  { ssr: false }
 );

 type SafeFarcasterSolanaProviderProps = {
@@ -15,15 +12,10 @@ type SafeFarcasterSolanaProviderProps = {
  children: React.ReactNode;
 };

-const SolanaProviderContext = createContext<{ hasSolanaProvider: boolean }>({
-  hasSolanaProvider: false,
-});
+const SolanaProviderContext = createContext<{ hasSolanaProvider: boolean }>({ hasSolanaProvider: false });

-export function SafeFarcasterSolanaProvider({
-  endpoint,
-  children,
-}: SafeFarcasterSolanaProviderProps) {
-  const isClient = typeof window !== 'undefined';
+export function SafeFarcasterSolanaProvider({ endpoint, children }: SafeFarcasterSolanaProviderProps) {
+  const isClient = typeof window !== "undefined";
  const [hasSolanaProvider, setHasSolanaProvider] = useState<boolean>(false);
  const [checked, setChecked] = useState<boolean>(false);

@@ -56,8 +48,8 @@ export function SafeFarcasterSolanaProvider({
    const origError = console.error;
    console.error = (...args) => {
      if (
-        typeof args[0] === 'string' &&
-        args[0].includes('WalletConnectionError: could not get Solana provider')
+        typeof args[0] === "string" &&
+        args[0].includes("WalletConnectionError: could not get Solana provider")
      ) {
        if (!errorShown) {
          origError(...args);
--- a/src/components/providers/WagmiProvider.tsx
+++ b/src/components/providers/WagmiProvider.tsx
@@ -1,12 +1,12 @@
-import React from 'react';
-import { useEffect, useState } from 'react';
-import { farcasterFrame } from '@farcaster/miniapp-wagmi-connector';
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { createConfig, http, WagmiProvider } from 'wagmi';
-import { useConnect, useAccount } from 'wagmi';
-import { base, degen, mainnet, optimism, unichain, celo } from 'wagmi/chains';
+import { createConfig, http, WagmiProvider } from "wagmi";
+import { base, degen, mainnet, optimism, unichain, celo } from "wagmi/chains";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { farcasterFrame } from "@farcaster/miniapp-wagmi-connector";
 import { coinbaseWallet, metaMask } from 'wagmi/connectors';
-import { APP_NAME, APP_ICON_URL, APP_URL } from '~/lib/constants';
+import { APP_NAME, APP_ICON_URL, APP_URL } from "~/lib/constants";
+import { useEffect, useState } from "react";
+import { useConnect, useAccount } from "wagmi";
+import React from "react";

 // Custom hook for Coinbase Wallet detection and auto-connection
 function useCoinbaseWalletAutoConnect() {
@@ -17,16 +17,15 @@ function useCoinbaseWalletAutoConnect() {
  useEffect(() => {
    // Check if we're running in Coinbase Wallet
    const checkCoinbaseWallet = () => {
-      const isInCoinbaseWallet =
-        window.ethereum?.isCoinbaseWallet ||
+      const isInCoinbaseWallet = window.ethereum?.isCoinbaseWallet || 
        window.ethereum?.isCoinbaseWalletExtension ||
        window.ethereum?.isCoinbaseWalletBrowser;
      setIsCoinbaseWallet(!!isInCoinbaseWallet);
    };
-
+    
    checkCoinbaseWallet();
    window.addEventListener('ethereum#initialized', checkCoinbaseWallet);
-
+    
    return () => {
      window.removeEventListener('ethereum#initialized', checkCoinbaseWallet);
    };
@@ -71,11 +70,7 @@ export const config = createConfig({
 const queryClient = new QueryClient();

 // Wrapper component that provides Coinbase Wallet auto-connection
-function CoinbaseWalletAutoConnect({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
+function CoinbaseWalletAutoConnect({ children }: { children: React.ReactNode }) {
  useCoinbaseWalletAutoConnect();
  return <>{children}</>;
 }
@@ -84,7 +79,9 @@ export default function Provider({ children }: { children: React.ReactNode }) {
  return (
    <WagmiProvider config={config}>
      <QueryClientProvider client={queryClient}>
-        <CoinbaseWalletAutoConnect>{children}</CoinbaseWalletAutoConnect>
+        <CoinbaseWalletAutoConnect>
+          {children}
+        </CoinbaseWalletAutoConnect>
      </QueryClientProvider>
    </WagmiProvider>
  );
--- a/src/components/ui/Button.tsx
+++ b/src/components/ui/Button.tsx
@@ -5,40 +5,43 @@ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
  size?: 'sm' | 'md' | 'lg';
 }

-export function Button({
-  children,
-  className = '',
-  isLoading = false,
+export function Button({ 
+  children, 
+  className = "", 
+  isLoading = false, 
  variant = 'primary',
  size = 'md',
-  ...props
+  ...props 
 }: ButtonProps) {
-  const baseClasses = 'btn';
-
+  const baseClasses = "btn";
+  
  const variantClasses = {
-    primary: 'btn-primary',
-    secondary: 'btn-secondary',
-    outline: 'btn-outline',
+    primary: "btn-primary",
+    secondary: "btn-secondary", 
+    outline: "btn-outline"
  };
-
+  
  const sizeClasses = {
-    sm: 'px-3 py-1.5 text-xs',
-    md: 'px-4 py-2 text-sm',
-    lg: 'px-6 py-3 text-base',
+    sm: "px-3 py-1.5 text-xs",
+    md: "px-4 py-2 text-sm",
+    lg: "px-6 py-3 text-base"
  };

-  const fullWidthClasses = 'w-full max-w-xs mx-auto block';
-
+  const fullWidthClasses = "w-full max-w-xs mx-auto block";
+  
  const combinedClasses = [
    baseClasses,
    variantClasses[variant],
    sizeClasses[size],
    fullWidthClasses,
-    className,
+    className
  ].join(' ');

  return (
-    <button className={combinedClasses} {...props}>
+    <button
+      className={combinedClasses}
+      {...props}
+    >
      {isLoading ? (
        <div className="flex items-center justify-center">
          <div className="spinner-primary h-5 w-5" />
--- a/src/components/ui/Footer.tsx
+++ b/src/components/ui/Footer.tsx
@@ -1,5 +1,5 @@
-import React from 'react';
-import { Tab } from '~/components/App';
+import React from "react";
+import { Tab } from "~/components/App";

 interface FooterProps {
  activeTab: Tab;
@@ -7,19 +7,13 @@ interface FooterProps {
  showWallet?: boolean;
 }

-export const Footer: React.FC<FooterProps> = ({
-  activeTab,
-  setActiveTab,
-  showWallet = false,
-}) => (
+export const Footer: React.FC<FooterProps> = ({ activeTab, setActiveTab, showWallet = false }) => (
  <div className="fixed bottom-0 left-0 right-0 mx-4 mb-4 bg-gray-100 dark:bg-gray-800 border-[3px] border-double border-primary px-2 py-2 rounded-lg z-50">
    <div className="flex justify-around items-center h-14">
      <button
        onClick={() => setActiveTab(Tab.Home)}
        className={`flex flex-col items-center justify-center w-full h-full ${
-          activeTab === Tab.Home
-            ? 'text-primary dark:text-primary-light'
-            : 'text-gray-500 dark:text-gray-400'
+          activeTab === Tab.Home ? 'text-primary dark:text-primary-light' : 'text-gray-500 dark:text-gray-400'
        }`}
      >
        <span className="text-xl">🏠</span>
@@ -28,9 +22,7 @@ export const Footer: React.FC<FooterProps> = ({
      <button
        onClick={() => setActiveTab(Tab.Actions)}
        className={`flex flex-col items-center justify-center w-full h-full ${
-          activeTab === Tab.Actions
-            ? 'text-primary dark:text-primary-light'
-            : 'text-gray-500 dark:text-gray-400'
+          activeTab === Tab.Actions ? 'text-primary dark:text-primary-light' : 'text-gray-500 dark:text-gray-400'
        }`}
      >
        <span className="text-xl">⚡</span>
@@ -39,9 +31,7 @@ export const Footer: React.FC<FooterProps> = ({
      <button
        onClick={() => setActiveTab(Tab.Context)}
        className={`flex flex-col items-center justify-center w-full h-full ${
-          activeTab === Tab.Context
-            ? 'text-primary dark:text-primary-light'
-            : 'text-gray-500 dark:text-gray-400'
+          activeTab === Tab.Context ? 'text-primary dark:text-primary-light' : 'text-gray-500 dark:text-gray-400'
        }`}
      >
        <span className="text-xl">📋</span>
@@ -51,9 +41,7 @@ export const Footer: React.FC<FooterProps> = ({
        <button
          onClick={() => setActiveTab(Tab.Wallet)}
          className={`flex flex-col items-center justify-center w-full h-full ${
-            activeTab === Tab.Wallet
-              ? 'text-primary dark:text-primary-light'
-              : 'text-gray-500 dark:text-gray-400'
+            activeTab === Tab.Wallet ? 'text-primary dark:text-primary-light' : 'text-gray-500 dark:text-gray-400'
          }`}
        >
          <span className="text-xl">👛</span>
--- a/src/components/ui/Header.tsx
+++ b/src/components/ui/Header.tsx
@@ -1,10 +1,9 @@
-'use client';
+"use client";

-import { useState } from 'react';
-import Image from 'next/image';
-import sdk from '@farcaster/miniapp-sdk';
-import { useMiniApp } from '@neynar/react';
-import { APP_NAME } from '~/lib/constants';
+import { useState } from "react";
+import { APP_NAME } from "~/lib/constants";
+import sdk from "@farcaster/miniapp-sdk";
+import { useMiniApp } from "@neynar/react";

 type HeaderProps = {
  neynarUser?: {
@@ -19,19 +18,23 @@ export function Header({ neynarUser }: HeaderProps) {

  return (
    <div className="relative">
-      <div className="mt-4 mb-4 mx-4 px-2 py-2 bg-gray-100 dark:bg-gray-800 rounded-lg flex items-center justify-between border-[3px] border-double border-primary">
-        <div className="text-lg font-light">Welcome to {APP_NAME}!</div>
+      <div 
+        className="mt-4 mb-4 mx-4 px-2 py-2 bg-gray-100 dark:bg-gray-800 rounded-lg flex items-center justify-between border-[3px] border-double border-primary"
+      >
+        <div className="text-lg font-light">
+          Welcome to {APP_NAME}!
+        </div>
        {context?.user && (
-          <div
+          <div 
            className="cursor-pointer"
            onClick={() => {
              setIsUserDropdownOpen(!isUserDropdownOpen);
            }}
          >
            {context.user.pfpUrl && (
-              <Image
-                src={context.user.pfpUrl}
-                alt="Profile"
+              <img 
+                src={context.user.pfpUrl} 
+                alt="Profile" 
                className="w-10 h-10 rounded-full border-2 border-primary"
              />
            )}
@@ -39,16 +42,14 @@ export function Header({ neynarUser }: HeaderProps) {
        )}
      </div>
      {context?.user && (
-        <>
+        <>      
          {isUserDropdownOpen && (
            <div className="absolute top-full right-0 z-50 w-fit mt-1 mx-4 bg-white dark:bg-gray-800 rounded-lg shadow-lg border border-gray-200 dark:border-gray-700">
              <div className="p-3 space-y-2">
                <div className="text-right">
-                  <h3
+                  <h3 
                    className="font-bold text-sm hover:underline cursor-pointer inline-block"
-                    onClick={() =>
-                      sdk.actions.viewProfile({ fid: context.user.fid })
-                    }
+                    onClick={() => sdk.actions.viewProfile({ fid: context.user.fid })}
                  >
                    {context.user.displayName || context.user.username}
                  </h3>
--- a/src/components/ui/NeynarAuthButton/AuthDialog.tsx
+++ b/src/components/ui/NeynarAuthButton/AuthDialog.tsx
@@ -169,7 +169,7 @@ export function AuthDialog({
                    {/* eslint-disable-next-line @next/next/no-img-element */}
                    <img
                      src={`https://api.qrserver.com/v1/create-qr-code/?size=200x200&data=${encodeURIComponent(
-                        content.qrUrl,
+                        content.qrUrl
                      )}`}
                      alt="QR Code"
                      className="w-48 h-48"
@@ -197,13 +197,13 @@ export function AuthDialog({
                        content.qrUrl
                          .replace(
                            'https://farcaster.xyz/',
-                            'https://client.farcaster.xyz/deeplinks/',
+                            'https://client.farcaster.xyz/deeplinks/'
                          )
                          .replace(
                            'https://client.farcaster.xyz/deeplinks/signed-key-request',
-                            'https://farcaster.xyz/~/connect',
+                            'https://farcaster.xyz/~/connect'
                          ),
-                        '_blank',
+                        '_blank'
                      );
                    }
                  }}
--- a/src/components/ui/NeynarAuthButton/ProfileButton.tsx
+++ b/src/components/ui/NeynarAuthButton/ProfileButton.tsx
@@ -16,14 +16,8 @@ export function ProfileButton({

  useDetectClickOutside(ref, () => setShowDropdown(false));

-  const name =
-    userData?.username && userData.username.trim() !== ''
-      ? userData.username
-      : `!${userData?.fid}`;
-  const pfpUrl =
-    userData?.pfpUrl && userData.pfpUrl.trim() !== ''
-      ? userData.pfpUrl
-      : 'https://farcaster.xyz/avatar.png';
+  const name = userData?.username ?? `!${userData?.fid}`;
+  const pfpUrl = userData?.pfpUrl ?? 'https://farcaster.xyz/avatar.png';

  return (
    <div className="relative" ref={ref}>
@@ -33,7 +27,7 @@ export function ProfileButton({
          'flex items-center gap-3 px-4 py-2 min-w-0 rounded-lg',
          'bg-transparent border border-gray-300 dark:border-gray-600 text-gray-900 dark:text-gray-100',
          'hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors',
-          'focus:outline-none focus:ring-1 focus:ring-primary',
+          'focus:outline-none focus:ring-1 focus:ring-primary'
        )}
      >
        {/* eslint-disable-next-line @next/next/no-img-element */}
@@ -41,7 +35,7 @@ export function ProfileButton({
          src={pfpUrl}
          alt="Profile"
          className="w-6 h-6 rounded-full object-cover flex-shrink-0"
-          onError={e => {
+          onError={(e) => {
            (e.target as HTMLImageElement).src =
              'https://farcaster.xyz/avatar.png';
          }}
@@ -52,7 +46,7 @@ export function ProfileButton({
        <svg
          className={cn(
            'w-4 h-4 transition-transform flex-shrink-0',
-            showDropdown && 'rotate-180',
+            showDropdown && 'rotate-180'
          )}
          fill="none"
          stroke="currentColor"
--- a/src/components/ui/NeynarAuthButton/index.tsx
+++ b/src/components/ui/NeynarAuthButton/index.tsx
@@ -1,17 +1,24 @@
 '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 { AuthDialog } from '~/components/ui/NeynarAuthButton/AuthDialog';
 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/miniapp-sdk';
@@ -102,19 +109,21 @@ export function NeynarAuthButton() {
  // New state for unified dialog flow
  const [showDialog, setShowDialog] = useState(false);
  const [dialogStep, setDialogStep] = useState<'signin' | 'access' | 'loading'>(
-    'loading',
+    'loading'
  );
  const [signerApprovalUrl, setSignerApprovalUrl] = useState<string | null>(
-    null,
+    null
  );
  const [pollingInterval, setPollingInterval] = useState<NodeJS.Timeout | null>(
-    null,
+    null
  );
  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 () => {
@@ -135,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'],
+      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,
@@ -156,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
@@ -180,7 +189,7 @@ export function NeynarAuthButton() {
        return null;
      }
    },
-    [],
+    []
  );

  // Helper function to generate signed key request
@@ -208,7 +217,7 @@ export function NeynarAuthButton() {
        if (!response.ok) {
          const errorData = await response.json();
          throw new Error(
-            `Failed to generate signed key request: ${errorData.error}`,
+            `Failed to generate signed key request: ${errorData.error}`
          );
        }

@@ -220,7 +229,7 @@ export function NeynarAuthButton() {
        // throw error;
      }
    },
-    [],
+    []
  );

  // Helper function to fetch all signers
@@ -229,20 +238,20 @@ export function NeynarAuthButton() {
      try {
        setSignersLoading(true);

-        const endpoint = useBackendFlow
+        const endpoint = useMiniappFlow
          ? `/api/auth/session-signers?message=${encodeURIComponent(
-              message,
+              message
            )}&signature=${signature}`
          : `/api/auth/signers?message=${encodeURIComponent(
-              message,
+              message
            )}&signature=${signature}`;

        const response = await fetch(endpoint);
        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 ||
@@ -251,12 +260,12 @@ 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) {
              const fetchedUser = (await fetchUserData(
-                signerData.signers[0].fid,
+                signerData.signers[0].fid
              )) as StoredAuthState['user'];
              user = fetchedUser;
            }
@@ -283,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}`,
+            `/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();
@@ -318,7 +359,7 @@ export function NeynarAuthButton() {

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

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

@@ -349,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,
@@ -375,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
@@ -392,8 +434,8 @@ export function NeynarAuthButton() {
  });

  const {
-    signIn: frontendSignIn,
-    signOut: frontendSignOut,
+    signIn: webappSignIn,
+    signOut: webappSignOut,
    connect,
    reconnect,
    isSuccess,
@@ -408,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 =
@@ -430,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) {
@@ -446,7 +502,7 @@ export function NeynarAuthButton() {
            // Step 2: Generate signed key request
            const signedKeyData = await generateSignedKeyRequest(
              newSigner.signer_uuid,
-              newSigner.public_key,
+              newSigner.public_key
            );

            // Step 3: Show QR code in access dialog for signer approval
@@ -456,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 {
@@ -480,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;
    }

@@ -514,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);
@@ -525,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);
      }
@@ -567,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 &&
@@ -585,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 || '',
@@ -617,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>
@@ -662,4 +716,4 @@ export function NeynarAuthButton() {
      }
    </>
  );
-}
+}
--- a/src/components/ui/Share.tsx
+++ b/src/components/ui/Share.tsx
@@ -1,10 +1,10 @@
 'use client';

 import { useCallback, useState, useEffect } from 'react';
-import { type ComposeCast } from '@farcaster/miniapp-sdk';
-import { useMiniApp } from '@neynar/react';
-import { APP_URL } from '~/lib/constants';
 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;
@@ -24,16 +24,9 @@ interface ShareButtonProps {
  isLoading?: boolean;
 }

-export function ShareButton({
-  buttonText,
-  cast,
-  className = '',
-  isLoading = false,
-}: ShareButtonProps) {
+export function ShareButton({ buttonText, cast, className = '', isLoading = false }: ShareButtonProps) {
  const [isProcessing, setIsProcessing] = useState(false);
-  const [bestFriends, setBestFriends] = useState<
-    { fid: number; username: string }[] | null
-  >(null);
+  const [bestFriends, setBestFriends] = useState<{ fid: number; username: string; }[] | null>(null);
  const [isLoadingBestFriends, setIsLoadingBestFriends] = useState(false);
  const { context, actions } = useMiniApp();

@@ -59,7 +52,7 @@ export function ShareButton({
      if (cast.bestFriends) {
        if (bestFriends) {
          // Replace @N with usernames, or remove if no matching friend
-          finalText = finalText.replace(/@\d+/g, match => {
+          finalText = finalText.replace(/@\d+/g, (match) => {
            const friendIndex = parseInt(match.slice(1)) - 1;
            const friend = bestFriends[friendIndex];
            if (friend) {
@@ -75,7 +68,7 @@ export function ShareButton({

      // Process embeds
      const processedEmbeds = await Promise.all(
-        (cast.embeds || []).map(async embed => {
+        (cast.embeds || []).map(async (embed) => {
          if (typeof embed === 'string') {
            return embed;
          }
@@ -84,10 +77,7 @@ export function ShareButton({
            const url = new URL(`${baseUrl}${embed.path}`);

            // Add UTM parameters
-            url.searchParams.set(
-              'utm_source',
-              `share-cast-${context?.user?.fid || 'unknown'}`,
-            );
+            url.searchParams.set('utm_source', `share-cast-${context?.user?.fid || 'unknown'}`);

            // If custom image generator is provided, use it
            if (embed.imageUrl) {
@@ -98,7 +88,7 @@ export function ShareButton({
            return url.toString();
          }
          return embed.url || '';
-        }),
+        })
      );

      // Open cast composer with all supported intents
--- a/src/components/ui/input.tsx
+++ b/src/components/ui/input.tsx
@@ -1,21 +1,22 @@
-import * as React from 'react';
-import { cn } from '~/lib/utils';
+import * as React from "react"

-const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<'input'>>(
+import { cn } from "~/lib/utils"
+
+const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<"input">>(
  ({ className, type, ...props }, ref) => {
    return (
      <input
        type={type}
        className={cn(
-          'flex h-10 w-full rounded-md border border-neutral-200 bg-white px-3 py-2 text-base ring-offset-white file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-neutral-950 placeholder:text-neutral-500 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-neutral-950 focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm dark:border-neutral-800 dark:bg-neutral-950 dark:ring-offset-neutral-950 dark:file:text-neutral-50 dark:placeholder:text-neutral-400 dark:focus-visible:ring-neutral-300',
-          className,
+          "flex h-10 w-full rounded-md border border-neutral-200 bg-white px-3 py-2 text-base ring-offset-white file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-neutral-950 placeholder:text-neutral-500 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-neutral-950 focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm dark:border-neutral-800 dark:bg-neutral-950 dark:ring-offset-neutral-950 dark:file:text-neutral-50 dark:placeholder:text-neutral-400 dark:focus-visible:ring-neutral-300",
+          className
        )}
        ref={ref}
        {...props}
      />
-    );
-  },
-);
-Input.displayName = 'Input';
+    )
+  }
+)
+Input.displayName = "Input"

-export { Input };
+export { Input }
--- a/src/components/ui/label.tsx
+++ b/src/components/ui/label.tsx
@@ -1,13 +1,14 @@
-'use client';
+"use client"

-import * as React from 'react';
-import * as LabelPrimitive from '@radix-ui/react-label';
-import { cva, type VariantProps } from 'class-variance-authority';
-import { cn } from '~/lib/utils';
+import * as React from "react"
+import * as LabelPrimitive from "@radix-ui/react-label"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "~/lib/utils"

 const labelVariants = cva(
-  'text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70',
-);
+  "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70"
+)

 const Label = React.forwardRef<
  React.ElementRef<typeof LabelPrimitive.Root>,
@@ -19,7 +20,7 @@ const Label = React.forwardRef<
    className={cn(labelVariants(), className)}
    {...props}
  />
-));
-Label.displayName = LabelPrimitive.Root.displayName;
+))
+Label.displayName = LabelPrimitive.Root.displayName

-export { Label };
+export { Label }
--- 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,22 +1,12 @@
 'use client';

 import { useCallback, useState } from 'react';
-import { type Haptics } from '@farcaster/miniapp-sdk';
 import { useMiniApp } from '@neynar/react';
-import { APP_URL } from '~/lib/constants';
-import { Button } from '../Button';
 import { ShareButton } from '../Share';
+import { Button } from '../Button';
 import { SignIn } from '../wallet/SignIn';
-
-// Optional import for NeynarAuthButton - may not exist in all templates
-let NeynarAuthButton: React.ComponentType | null = null;
-try {
-  const module = require('../NeynarAuthButton/index');
-  NeynarAuthButton = module.NeynarAuthButton;
-} catch (error) {
-  // Component doesn't exist, that's okay
-  console.log('NeynarAuthButton not available in this template');
-}
+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.
@@ -61,7 +51,7 @@ export function ActionsTab() {
   * @returns Promise that resolves when the notification is sent or fails
   */
  const sendFarcasterNotification = useCallback(async () => {
-    setNotificationState(prev => ({ ...prev, sendStatus: '' }));
+    setNotificationState((prev) => ({ ...prev, sendStatus: '' }));
    if (!notificationDetails || !context) {
      return;
    }
@@ -76,22 +66,22 @@ export function ActionsTab() {
        }),
      });
      if (response.status === 200) {
-        setNotificationState(prev => ({ ...prev, sendStatus: 'Success' }));
+        setNotificationState((prev) => ({ ...prev, sendStatus: 'Success' }));
        return;
      } else if (response.status === 429) {
-        setNotificationState(prev => ({
+        setNotificationState((prev) => ({
          ...prev,
          sendStatus: 'Rate limited',
        }));
        return;
      }
      const responseText = await response.text();
-      setNotificationState(prev => ({
+      setNotificationState((prev) => ({
        ...prev,
        sendStatus: `Error: ${responseText}`,
      }));
    } catch (error) {
-      setNotificationState(prev => ({
+      setNotificationState((prev) => ({
        ...prev,
        sendStatus: `Error: ${error}`,
      }));
@@ -108,11 +98,11 @@ export function ActionsTab() {
    if (context?.user?.fid) {
      const userShareUrl = `${APP_URL}/share/${context.user.fid}`;
      await navigator.clipboard.writeText(userShareUrl);
-      setNotificationState(prev => ({ ...prev, shareUrlCopied: true }));
+      setNotificationState((prev) => ({ ...prev, shareUrlCopied: true }));
      setTimeout(
        () =>
-          setNotificationState(prev => ({ ...prev, shareUrlCopied: false })),
-        2000,
+          setNotificationState((prev) => ({ ...prev, shareUrlCopied: false })),
+        2000
      );
    }
  }, [context?.user?.fid]);
@@ -148,9 +138,6 @@ export function ActionsTab() {
      {/* Authentication */}
      <SignIn />

-      {/* Neynar Authentication */}
-      {NeynarAuthButton && <NeynarAuthButton />}
-
      {/* Mini app actions */}
      <Button
        onClick={() =>
@@ -195,9 +182,9 @@ export function ActionsTab() {
        </label>
        <select
          value={selectedHapticIntensity}
-          onChange={e =>
+          onChange={(e) =>
            setSelectedHapticIntensity(
-              e.target.value as Haptics.ImpactOccurredType,
+              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"
--- a/src/components/ui/tabs/ContextTab.tsx
+++ b/src/components/ui/tabs/ContextTab.tsx
@@ -1,19 +1,19 @@
-'use client';
+"use client";

-import { useMiniApp } from '@neynar/react';
+import { useMiniApp } from "@neynar/react";

 /**
 * ContextTab component displays the current mini app context in JSON format.
- *
+ * 
 * This component provides a developer-friendly view of the Farcaster mini app context,
 * including user information, client details, and other contextual data. It's useful
 * for debugging and understanding what data is available to the mini app.
- *
+ * 
 * The context includes:
 * - User information (FID, username, display name, profile picture)
 * - Client information (safe area insets, platform details)
 * - Mini app configuration and state
- *
+ * 
 * @example
 * ```tsx
 * <ContextTab />
@@ -21,7 +21,7 @@ import { useMiniApp } from '@neynar/react';
 */
 export function ContextTab() {
  const { context } = useMiniApp();
-
+  
  return (
    <div className="mx-6">
      <h2 className="text-lg font-semibold mb-2">Context</h2>
@@ -32,4 +32,4 @@ export function ContextTab() {
      </div>
    </div>
  );
-}
+} 
--- a/src/components/ui/tabs/HomeTab.tsx
+++ b/src/components/ui/tabs/HomeTab.tsx
@@ -1,12 +1,12 @@
-'use client';
+"use client";

 /**
 * HomeTab component displays the main landing content for the mini app.
- *
+ * 
 * This is the default tab that users see when they first open the mini app.
 * It provides a simple welcome message and placeholder content that can be
 * customized for specific use cases.
- *
+ * 
 * @example
 * ```tsx
 * <HomeTab />
@@ -17,10 +17,8 @@ export function HomeTab() {
    <div className="flex items-center justify-center h-[calc(100vh-200px)] px-6">
      <div className="text-center w-full max-w-md mx-auto">
        <p className="text-lg mb-2">Put your content here!</p>
-        <p className="text-sm text-gray-500 dark:text-gray-400">
-          Powered by Neynar 🪐
-        </p>
+        <p className="text-sm text-gray-500 dark:text-gray-400">Powered by Neynar 🪐</p>
      </div>
    </div>
  );
-}
+} 
--- a/src/components/ui/tabs/WalletTab.tsx
+++ b/src/components/ui/tabs/WalletTab.tsx
@@ -1,32 +1,22 @@
-'use client';
+"use client";

-import { useCallback, useMemo, useState, useEffect } from 'react';
-import { useMiniApp } from '@neynar/react';
+import { useCallback, useMemo, useState, useEffect } from "react";
+import { useAccount, useSendTransaction, useSignTypedData, useWaitForTransactionReceipt, useDisconnect, useConnect, useSwitchChain, useChainId, type Connector } from "wagmi";
 import { useWallet as useSolanaWallet } from '@solana/wallet-adapter-react';
-import {
-  useAccount,
-  useSendTransaction,
-  useSignTypedData,
-  useWaitForTransactionReceipt,
-  useDisconnect,
-  useConnect,
-  useSwitchChain,
-  useChainId,
-  type Connector,
-} from 'wagmi';
-import { base, degen, mainnet, optimism, unichain } from 'wagmi/chains';
-import { USE_WALLET, APP_NAME } from '../../../lib/constants';
-import { renderError } from '../../../lib/errorUtils';
-import { truncateAddress } from '../../../lib/truncateAddress';
-import { Button } from '../Button';
-import { SendEth } from '../wallet/SendEth';
-import { SendSolana } from '../wallet/SendSolana';
-import { SignEvmMessage } from '../wallet/SignEvmMessage';
-import { SignSolanaMessage } from '../wallet/SignSolanaMessage';
+import { base, degen, mainnet, optimism, unichain } from "wagmi/chains";
+import { Button } from "../Button";
+import { truncateAddress } from "../../../lib/truncateAddress";
+import { renderError } from "../../../lib/errorUtils";
+import { SignEvmMessage } from "../wallet/SignEvmMessage";
+import { SendEth } from "../wallet/SendEth";
+import { SignSolanaMessage } from "../wallet/SignSolanaMessage";
+import { SendSolana } from "../wallet/SendSolana";
+import { USE_WALLET, APP_NAME } from "../../../lib/constants";
+import { useMiniApp } from "@neynar/react";

 /**
 * WalletTab component manages wallet-related UI for both EVM and Solana chains.
- *
+ * 
 * This component provides a comprehensive wallet interface that supports:
 * - EVM wallet connections (Farcaster Frame, Coinbase Wallet, MetaMask)
 * - Solana wallet integration
@@ -34,10 +24,10 @@ import { SignSolanaMessage } from '../wallet/SignSolanaMessage';
 * - Transaction sending for both chains
 * - Chain switching for EVM chains
 * - Auto-connection in Farcaster clients
- *
+ * 
 * The component automatically detects when running in a Farcaster client
 * and attempts to auto-connect using the Farcaster Frame connector.
- *
+ * 
 * @example
 * ```tsx
 * <WalletTab />
@@ -57,8 +47,7 @@ function WalletStatus({ address, chainId }: WalletStatusProps) {
    <>
      {address && (
        <div className="text-xs w-full">
-          Address:{' '}
-          <pre className="inline w-full">{truncateAddress(address)}</pre>
+          Address: <pre className="inline w-full">{truncateAddress(address)}</pre>
        </div>
      )}
      {chainId && (
@@ -101,14 +90,13 @@ function ConnectionControls({
  if (context) {
    return (
      <div className="space-y-2 w-full">
-        <Button
-          onClick={() => connect({ connector: connectors[0] })}
-          className="w-full"
-        >
+        <Button onClick={() => connect({ connector: connectors[0] })} className="w-full">
          Connect (Auto)
        </Button>
        <Button
          onClick={() => {
+            console.log("Manual Farcaster connection attempt");
+            console.log("Connectors:", connectors.map((c, i) => `${i}: ${c.name}`));
            connect({ connector: connectors[0] });
          }}
          className="w-full"
@@ -120,16 +108,10 @@ function ConnectionControls({
  }
  return (
    <div className="space-y-3 w-full">
-      <Button
-        onClick={() => connect({ connector: connectors[1] })}
-        className="w-full"
-      >
+      <Button onClick={() => connect({ connector: connectors[1] })} className="w-full">
        Connect Coinbase Wallet
      </Button>
-      <Button
-        onClick={() => connect({ connector: connectors[2] })}
-        className="w-full"
-      >
+      <Button onClick={() => connect({ connector: connectors[2] })} className="w-full">
        Connect MetaMask
      </Button>
    </div>
@@ -138,10 +120,8 @@ function ConnectionControls({

 export function WalletTab() {
  // --- State ---
-  const [evmContractTransactionHash, setEvmContractTransactionHash] = useState<
-    string | null
-  >(null);
-
+  const [evmContractTransactionHash, setEvmContractTransactionHash] = useState<string | null>(null);
+  
  // --- Hooks ---
  const { context } = useMiniApp();
  const { address, isConnected } = useAccount();
@@ -157,12 +137,10 @@ export function WalletTab() {
    isPending: isEvmTransactionPending,
  } = useSendTransaction();

-  const {
-    isLoading: isEvmTransactionConfirming,
-    isSuccess: isEvmTransactionConfirmed,
-  } = useWaitForTransactionReceipt({
-    hash: evmContractTransactionHash as `0x${string}`,
-  });
+  const { isLoading: isEvmTransactionConfirming, isSuccess: isEvmTransactionConfirmed } =
+    useWaitForTransactionReceipt({
+      hash: evmContractTransactionHash as `0x${string}`,
+    });

  const {
    signTypedData,
@@ -184,32 +162,38 @@ export function WalletTab() {
  // --- Effects ---
  /**
   * Auto-connect when Farcaster context is available.
-   *
+   * 
   * This effect detects when the app is running in a Farcaster client
   * and automatically attempts to connect using the Farcaster Frame connector.
   * It includes comprehensive logging for debugging connection issues.
   */
  useEffect(() => {
    // Check if we're in a Farcaster client environment
-    const isInFarcasterClient =
-      typeof window !== 'undefined' &&
-      (window.location.href.includes('warpcast.com') ||
-        window.location.href.includes('farcaster') ||
-        window.ethereum?.isFarcaster ||
-        context?.client);
-
-    if (
-      context?.user?.fid &&
-      !isConnected &&
-      connectors.length > 0 &&
-      isInFarcasterClient
-    ) {
+    const isInFarcasterClient = typeof window !== 'undefined' && 
+      (window.location.href.includes('warpcast.com') || 
+       window.location.href.includes('farcaster') ||
+       window.ethereum?.isFarcaster ||
+       context?.client);
+    
+    if (context?.user?.fid && !isConnected && connectors.length > 0 && isInFarcasterClient) {
+      console.log("Attempting auto-connection with Farcaster context...");
+      console.log("- User FID:", context.user.fid);
+      console.log("- Available connectors:", connectors.map((c, i) => `${i}: ${c.name}`));
+      console.log("- Using connector:", connectors[0].name);
+      console.log("- In Farcaster client:", isInFarcasterClient);
+      
      // Use the first connector (farcasterFrame) for auto-connection
      try {
        connect({ connector: connectors[0] });
      } catch (error) {
-        console.error('Auto-connection failed:', error);
+        console.error("Auto-connection failed:", error);
      }
+    } else {
+      console.log("Auto-connection conditions not met:");
+      console.log("- Has context:", !!context?.user?.fid);
+      console.log("- Is connected:", isConnected);
+      console.log("- Has connectors:", connectors.length > 0);
+      console.log("- In Farcaster client:", isInFarcasterClient);
    }
  }, [context?.user?.fid, isConnected, connectors, connect, context?.client]);

@@ -243,7 +227,7 @@ export function WalletTab() {

  /**
   * Sends a transaction to call the yoink() function on the Yoink contract.
-   *
+   * 
   * This function sends a transaction to a specific contract address with
   * the encoded function call data for the yoink() function.
   */
@@ -251,20 +235,20 @@ export function WalletTab() {
    sendTransaction(
      {
        // call yoink() on Yoink contract
-        to: '0x4bBFD120d9f352A0BEd7a014bd67913a2007a878',
-        data: '0x9846cd9efc000023c0',
+        to: "0x4bBFD120d9f352A0BEd7a014bd67913a2007a878",
+        data: "0x9846cd9efc000023c0",
      },
      {
-        onSuccess: hash => {
+        onSuccess: (hash) => {
          setEvmContractTransactionHash(hash);
        },
-      },
+      }
    );
  }, [sendTransaction]);

  /**
   * Signs typed data using EIP-712 standard.
-   *
+   * 
   * This function creates a typed data structure with the app name, version,
   * and chain ID, then requests the user to sign it.
   */
@@ -272,16 +256,16 @@ export function WalletTab() {
    signTypedData({
      domain: {
        name: APP_NAME,
-        version: '1',
+        version: "1",
        chainId,
      },
      types: {
-        Message: [{ name: 'content', type: 'string' }],
+        Message: [{ name: "content", type: "string" }],
      },
      message: {
        content: `Hello from ${APP_NAME}!`,
      },
-      primaryType: 'Message',
+      primaryType: "Message",
    });
  }, [chainId, signTypedData]);

@@ -324,12 +308,12 @@ export function WalletTab() {
            <div className="text-xs w-full">
              <div>Hash: {truncateAddress(evmContractTransactionHash)}</div>
              <div>
-                Status:{' '}
+                Status:{" "}
                {isEvmTransactionConfirming
-                  ? 'Confirming...'
+                  ? "Confirming..."
                  : isEvmTransactionConfirmed
-                    ? 'Confirmed!'
-                    : 'Pending'}
+                  ? "Confirmed!"
+                  : "Pending"}
              </div>
            </div>
          )}
@@ -363,4 +347,4 @@ export function WalletTab() {
      )}
    </div>
  );
-}
+} 
--- a/src/components/ui/tabs/index.ts
+++ b/src/components/ui/tabs/index.ts
@@ -1,4 +1,4 @@
 export { HomeTab } from './HomeTab';
 export { ActionsTab } from './ActionsTab';
 export { ContextTab } from './ContextTab';
-export { WalletTab } from './WalletTab';
+export { WalletTab } from './WalletTab'; 
--- a/src/components/ui/wallet/SendEth.tsx
+++ b/src/components/ui/wallet/SendEth.tsx
@@ -1,29 +1,25 @@
-'use client';
+"use client";

-import { useCallback, useMemo } from 'react';
-import {
-  useAccount,
-  useSendTransaction,
-  useWaitForTransactionReceipt,
-} from 'wagmi';
-import { base } from 'wagmi/chains';
-import { renderError } from '../../../lib/errorUtils';
-import { truncateAddress } from '../../../lib/truncateAddress';
-import { Button } from '../Button';
+import { useCallback, useMemo } from "react";
+import { useAccount, useSendTransaction, useWaitForTransactionReceipt } from "wagmi";
+import { base } from "wagmi/chains";
+import { Button } from "../Button";
+import { truncateAddress } from "../../../lib/truncateAddress";
+import { renderError } from "../../../lib/errorUtils";

 /**
 * SendEth component handles sending ETH transactions to protocol guild addresses.
- *
+ * 
 * This component provides a simple interface for users to send small amounts
 * of ETH to protocol guild addresses. It automatically selects the appropriate
 * recipient address based on the current chain and displays transaction status.
- *
+ * 
 * Features:
 * - Chain-specific recipient addresses
 * - Transaction status tracking
 * - Error handling and display
 * - Transaction hash display
- *
+ * 
 * @example
 * ```tsx
 * <SendEth />
@@ -40,34 +36,32 @@ export function SendEth() {
    isPending: isEthTransactionPending,
  } = useSendTransaction();

-  const {
-    isLoading: isEthTransactionConfirming,
-    isSuccess: isEthTransactionConfirmed,
-  } = useWaitForTransactionReceipt({
-    hash: ethTransactionHash,
-  });
+  const { isLoading: isEthTransactionConfirming, isSuccess: isEthTransactionConfirmed } =
+    useWaitForTransactionReceipt({
+      hash: ethTransactionHash,
+    });

  // --- Computed Values ---
  /**
   * Determines the recipient address based on the current chain.
-   *
+   * 
   * Uses different protocol guild addresses for different chains:
   * - Base: 0x32e3C7fD24e175701A35c224f2238d18439C7dBC
   * - Other chains: 0xB3d8d7887693a9852734b4D25e9C0Bb35Ba8a830
-   *
+   * 
   * @returns string - The recipient address for the current chain
   */
  const protocolGuildRecipientAddress = useMemo(() => {
    // Protocol guild address
    return chainId === base.id
-      ? '0x32e3C7fD24e175701A35c224f2238d18439C7dBC'
-      : '0xB3d8d7887693a9852734b4D25e9C0Bb35Ba8a830';
+      ? "0x32e3C7fD24e175701A35c224f2238d18439C7dBC"
+      : "0xB3d8d7887693a9852734b4D25e9C0Bb35Ba8a830";
  }, [chainId]);

  // --- Handlers ---
  /**
   * Handles sending the ETH transaction.
-   *
+   * 
   * This function sends a small amount of ETH (1 wei) to the protocol guild
   * address for the current chain. The transaction is sent using the wagmi
   * sendTransaction hook.
@@ -94,15 +88,15 @@ export function SendEth() {
        <div className="mt-2 text-xs">
          <div>Hash: {truncateAddress(ethTransactionHash)}</div>
          <div>
-            Status:{' '}
+            Status:{" "}
            {isEthTransactionConfirming
-              ? 'Confirming...'
+              ? "Confirming..."
              : isEthTransactionConfirmed
-                ? 'Confirmed!'
-                : 'Pending'}
+              ? "Confirmed!"
+              : "Pending"}
          </div>
        </div>
      )}
    </>
  );
-}
+} 
--- a/src/components/ui/wallet/SendSolana.tsx
+++ b/src/components/ui/wallet/SendSolana.tsx
@@ -1,32 +1,29 @@
-'use client';
+"use client";

-import { useCallback, useState } from 'react';
-import {
-  useConnection as useSolanaConnection,
-  useWallet as useSolanaWallet,
-} from '@solana/wallet-adapter-react';
+import { useCallback, useState } from "react";
+import { useConnection as useSolanaConnection, useWallet as useSolanaWallet } from '@solana/wallet-adapter-react';
 import { PublicKey, SystemProgram, Transaction } from '@solana/web3.js';
-import { renderError } from '../../../lib/errorUtils';
-import { truncateAddress } from '../../../lib/truncateAddress';
-import { Button } from '../Button';
+import { Button } from "../Button";
+import { truncateAddress } from "../../../lib/truncateAddress";
+import { renderError } from "../../../lib/errorUtils";

 /**
 * SendSolana component handles sending SOL transactions on Solana.
- *
+ * 
 * This component provides a simple interface for users to send SOL transactions
 * using their connected Solana wallet. It includes transaction status tracking
 * and error handling.
- *
+ * 
 * Features:
 * - SOL transaction sending
 * - Transaction status tracking
 * - Error handling and display
 * - Loading state management
- *
+ * 
 * Note: This component is a placeholder implementation. In a real application,
 * you would integrate with a Solana wallet adapter and transaction library
 * like @solana/web3.js to handle actual transactions.
- *
+ * 
 * @example
 * ```tsx
 * <SendSolana />
@@ -45,8 +42,7 @@ export function SendSolana() {

  // This should be replaced but including it from the original demo
  // https://github.com/farcasterxyz/frames-v2-demo/blob/main/src/components/Demo.tsx#L718
-  const ashoatsPhantomSolanaWallet =
-    'Ao3gLNZAsbrmnusWVqQCPMrcqNi6jdYgu8T6NCoXXQu1';
+  const ashoatsPhantomSolanaWallet = 'Ao3gLNZAsbrmnusWVqQCPMrcqNi6jdYgu8T6NCoXXQu1';

  /**
   * Handles sending the Solana transaction
@@ -76,8 +72,7 @@ export function SendSolana() {
      transaction.recentBlockhash = blockhash;
      transaction.feePayer = new PublicKey(fromPubkeyStr);

-      const simulation =
-        await solanaConnection.simulateTransaction(transaction);
+      const simulation = await solanaConnection.simulateTransaction(transaction);
      if (simulation.value.err) {
        // Gather logs and error details for debugging
        const logs = simulation.value.logs?.join('\n') ?? 'No logs';
@@ -105,8 +100,7 @@ export function SendSolana() {
      >
        Send Transaction (sol)
      </Button>
-      {solanaTransactionState.status === 'error' &&
-        renderError(solanaTransactionState.error)}
+      {solanaTransactionState.status === 'error' && renderError(solanaTransactionState.error)}
      {solanaTransactionState.status === 'success' && (
        <div className="mt-2 text-xs">
          <div>Hash: {truncateAddress(solanaTransactionState.signature)}</div>
@@ -114,4 +108,4 @@ export function SendSolana() {
      )}
    </>
  );
-}
+} 
--- a/src/components/ui/wallet/SignEvmMessage.tsx
+++ b/src/components/ui/wallet/SignEvmMessage.tsx
@@ -1,26 +1,26 @@
-'use client';
+"use client";

-import { useCallback } from 'react';
-import { useAccount, useConnect, useSignMessage } from 'wagmi';
-import { base } from 'wagmi/chains';
-import { APP_NAME } from '../../../lib/constants';
-import { renderError } from '../../../lib/errorUtils';
-import { config } from '../../providers/WagmiProvider';
-import { Button } from '../Button';
+import { useCallback } from "react";
+import { useAccount, useConnect, useSignMessage } from "wagmi";
+import { base } from "wagmi/chains";
+import { Button } from "../Button";
+import { config } from "../../providers/WagmiProvider";
+import { APP_NAME } from "../../../lib/constants";
+import { renderError } from "../../../lib/errorUtils";

 /**
 * SignEvmMessage component handles signing messages on EVM-compatible chains.
- *
+ * 
 * This component provides a simple interface for users to sign messages using
 * their connected EVM wallet. It automatically handles wallet connection if
 * the user is not already connected, and displays the signature result.
- *
+ * 
 * Features:
 * - Automatic wallet connection if needed
 * - Message signing with app name
 * - Error handling and display
 * - Signature result display
- *
+ * 
 * @example
 * ```tsx
 * <SignEvmMessage />
@@ -41,12 +41,12 @@ export function SignEvmMessage() {
  // --- Handlers ---
  /**
   * Handles the message signing process.
-   *
+   * 
   * This function first ensures the user is connected to an EVM wallet,
   * then requests them to sign a message containing the app name.
   * If the user is not connected, it automatically connects using the
   * Farcaster Frame connector.
-   *
+   * 
   * @returns Promise<void>
   */
  const signEvmMessage = useCallback(async () => {
@@ -78,4 +78,4 @@ export function SignEvmMessage() {
      )}
    </>
  );
-}
+} 
--- a/src/components/ui/wallet/SignIn.tsx
+++ b/src/components/ui/wallet/SignIn.tsx
@@ -127,4 +127,4 @@ export function SignIn() {
      )}
    </>
  );
-}
+}
--- a/src/components/ui/wallet/SignSolanaMessage.tsx
+++ b/src/components/ui/wallet/SignSolanaMessage.tsx
@@ -1,8 +1,8 @@
-'use client';
+"use client";

-import { useCallback, useState } from 'react';
-import { renderError } from '../../../lib/errorUtils';
-import { Button } from '../Button';
+import { useCallback, useState } from "react";
+import { Button } from "../Button";
+import { renderError } from "../../../lib/errorUtils";

 interface SignSolanaMessageProps {
  signMessage?: (message: Uint8Array) => Promise<Uint8Array>;
@@ -10,20 +10,20 @@ interface SignSolanaMessageProps {

 /**
 * SignSolanaMessage component handles signing messages on Solana.
- *
+ * 
 * This component provides a simple interface for users to sign messages using
 * their connected Solana wallet. It accepts a signMessage function as a prop
 * and handles the complete signing flow including error handling.
- *
+ * 
 * Features:
 * - Message signing with Solana wallet
 * - Error handling and display
 * - Signature result display (base64 encoded)
 * - Loading state management
- *
+ * 
 * @param props - Component props
 * @param props.signMessage - Function to sign messages with Solana wallet
- *
+ * 
 * @example
 * ```tsx
 * <SignSolanaMessage signMessage={solanaWallet.signMessage} />
@@ -38,11 +38,11 @@ export function SignSolanaMessage({ signMessage }: SignSolanaMessageProps) {
  // --- Handlers ---
  /**
   * Handles the Solana message signing process.
-   *
+   * 
   * This function encodes a message as UTF-8 bytes, signs it using the provided
   * signMessage function, and displays the base64-encoded signature result.
   * It includes comprehensive error handling and loading state management.
-   *
+   * 
   * @returns Promise<void>
   */
  const handleSignMessage = useCallback(async () => {
@@ -51,7 +51,7 @@ export function SignSolanaMessage({ signMessage }: SignSolanaMessageProps) {
      if (!signMessage) {
        throw new Error('no Solana signMessage');
      }
-      const input = new TextEncoder().encode('Hello from Solana!');
+      const input = new TextEncoder().encode("Hello from Solana!");
      const signatureBytes = await signMessage(input);
      const signature = btoa(String.fromCharCode(...signatureBytes));
      setSignature(signature);
@@ -84,4 +84,4 @@ export function SignSolanaMessage({ signMessage }: SignSolanaMessageProps) {
      )}
    </>
  );
-}
+} 
--- a/src/components/ui/wallet/index.ts
+++ b/src/components/ui/wallet/index.ts
@@ -2,4 +2,4 @@ export { SignIn } from './SignIn';
 export { SignEvmMessage } from './SignEvmMessage';
 export { SendEth } from './SendEth';
 export { SignSolanaMessage } from './SignSolanaMessage';
-export { SendSolana } from './SendSolana';
+export { SendSolana } from './SendSolana'; 
--- a/src/hooks/useDetectClickOutside.ts
+++ b/src/hooks/useDetectClickOutside.ts
@@ -2,7 +2,7 @@ import { useEffect } from 'react';

 export function useDetectClickOutside<T extends HTMLElement>(
  ref: React.RefObject<T | null>,
-  callback: () => void,
+  callback: () => void
 ) {
  useEffect(() => {
    function handleClickOutside(event: MouseEvent) {
--- a/src/hooks/useNeynarUser.ts
+++ b/src/hooks/useNeynarUser.ts
@@ -1,4 +1,4 @@
-import { useEffect, useState } from 'react';
+import { useEffect, useState } from "react";

 export interface NeynarUser {
  fid: number;
@@ -19,21 +19,20 @@ export function useNeynarUser(context?: { user?: { fid?: number } }) {
    setLoading(true);
    setError(null);
    fetch(`/api/users?fids=${context.user.fid}`)
-      .then(response => {
-        if (!response.ok)
-          throw new Error(`HTTP error! status: ${response.status}`);
+      .then((response) => {
+        if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
        return response.json();
      })
-      .then(data => {
+      .then((data) => {
        if (data.users?.[0]) {
          setUser(data.users[0]);
        } else {
          setUser(null);
        }
      })
-      .catch(err => setError(err.message))
+      .catch((err) => setError(err.message))
      .finally(() => setLoading(false));
  }, [context?.user?.fid]);

  return { user, loading, error };
-}
+} 
--- a/src/hooks/useQuickAuth.ts
+++ b/src/hooks/useQuickAuth.ts
@@ -204,4 +204,4 @@ export function useQuickAuth(): UseQuickAuthReturn {
    signOut,
    getToken,
  };
-}
+}
--- a/src/lib/constants.ts
+++ b/src/lib/constants.ts
@@ -1,4 +1,4 @@
-import { type AccountAssociation } from '@farcaster/miniapp-node';
+import { type AccountAssociation } from '@farcaster/miniapp-core/src/manifest';

 /**
 * Application constants and configuration values.
@@ -80,7 +80,7 @@ export const APP_ACCOUNT_ASSOCIATION: AccountAssociation | undefined =
 * Text displayed on the main action button.
 * Used for the primary call-to-action in the mini app.
 */
-export const APP_BUTTON_TEXT: string = 'Launch NSK';
+export const APP_BUTTON_TEXT: string = 'Launch Mini App';

 // --- Integration Configuration ---
 /**
@@ -102,7 +102,7 @@ export const APP_WEBHOOK_URL: string =
 * When false, wallet functionality is completely hidden from the UI.
 * Useful for mini apps that don't require wallet integration.
 */
-export const USE_WALLET: boolean = true;
+export const USE_WALLET: boolean = false;

 /**
 * Flag to enable/disable analytics tracking.
@@ -113,6 +113,26 @@ export const USE_WALLET: boolean = 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 = {
  name: 'Farcaster SignedKeyRequestValidator',
--- a/src/lib/errorUtils.tsx
+++ b/src/lib/errorUtils.tsx
@@ -1,9 +1,9 @@
-import { type ReactElement } from 'react';
-import { BaseError, UserRejectedRequestError } from 'viem';
+import { type ReactElement } from "react";
+import { BaseError, UserRejectedRequestError } from "viem";

 /**
 * Renders an error object in a user-friendly format.
- *
+ * 
 * This utility function takes an error object and renders it as a React element
 * with consistent styling. It handles different types of errors including:
 * - Error objects with message properties
@@ -11,14 +11,14 @@ import { BaseError, UserRejectedRequestError } from 'viem';
 * - String errors
 * - Unknown error types
 * - User rejection errors (special handling for wallet rejections)
- *
+ * 
 * The rendered error is displayed in a gray container with monospace font
 * for better readability of technical error details. User rejections are
 * displayed with a simpler, more user-friendly message.
- *
+ * 
 * @param error - The error object to render
 * @returns ReactElement - A styled error display component, or null if no error
- *
+ * 
 * @example
 * ```tsx
 * {isError && renderError(error)}
@@ -27,11 +27,11 @@ import { BaseError, UserRejectedRequestError } from 'viem';
 export function renderError(error: unknown): ReactElement | null {
  // Handle null/undefined errors
  if (!error) return null;
-
+  
  // Special handling for user rejections in wallet operations
  if (error instanceof BaseError) {
    const isUserRejection = error.walk(
-      e => e instanceof UserRejectedRequestError,
+      (e) => e instanceof UserRejectedRequestError
    );

    if (isUserRejection) {
@@ -43,10 +43,10 @@ export function renderError(error: unknown): ReactElement | null {
      );
    }
  }
-
+  
  // Extract error message from different error types
  let errorMessage: string;
-
+  
  if (error instanceof Error) {
    errorMessage = error.message;
  } else if (typeof error === 'object' && error !== null && 'error' in error) {
@@ -63,4 +63,4 @@ export function renderError(error: unknown): ReactElement | null {
      <div className="whitespace-pre-wrap break-words">{errorMessage}</div>
    </div>
  );
-}
+} 
--- a/src/lib/kv.ts
+++ b/src/lib/kv.ts
@@ -1,9 +1,9 @@
-import { FrameNotificationDetails } from '@farcaster/miniapp-sdk';
+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;
@@ -19,18 +19,18 @@ function getUserNotificationDetailsKey(fid: number): string {
 }

 export async function getUserNotificationDetails(
-  fid: number,
-): Promise<FrameNotificationDetails | null> {
+  fid: number
+): 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) {
@@ -41,7 +41,7 @@ export async function setUserNotificationDetails(
 }

 export async function deleteUserNotificationDetails(
-  fid: number,
+  fid: number
 ): Promise<void> {
  const key = getUserNotificationDetailsKey(fid);
  if (redis) {
--- a/src/lib/neynar.ts
+++ b/src/lib/neynar.ts
@@ -1,15 +1,11 @@
-import {
-  NeynarAPIClient,
-  Configuration,
-  WebhookUserCreated,
-} from '@neynar/nodejs-sdk';
+import { NeynarAPIClient, Configuration, WebhookUserCreated } from '@neynar/nodejs-sdk';
 import { APP_URL } from './constants';

 let neynarClient: NeynarAPIClient | null = null;

 // Example usage:
 // const client = getNeynarClient();
-// const user = await client.lookupUserByFid(fid);
+// const user = await client.lookupUserByFid(fid); 
 export function getNeynarClient() {
  if (!neynarClient) {
    const apiKey = process.env.NEYNAR_API_KEY;
@@ -37,12 +33,12 @@ export async function getNeynarUser(fid: number): Promise<User | null> {

 type SendMiniAppNotificationResult =
  | {
-      state: 'error';
+      state: "error";
      error: unknown;
    }
-  | { state: 'no_token' }
-  | { state: 'rate_limit' }
-  | { state: 'success' };
+  | { state: "no_token" }
+  | { state: "rate_limit" }
+  | { state: "success" };

 export async function sendNeynarMiniAppNotification({
  fid,
@@ -62,19 +58,19 @@ export async function sendNeynarMiniAppNotification({
      target_url: APP_URL,
    };

-    const result = await client.publishFrameNotifications({
-      targetFids,
-      notification,
+    const result = await client.publishFrameNotifications({ 
+      targetFids, 
+      notification 
    });

    if (result.notification_deliveries.length > 0) {
-      return { state: 'success' };
+      return { state: "success" };
    } else if (result.notification_deliveries.length === 0) {
-      return { state: 'no_token' };
+      return { state: "no_token" };
    } else {
-      return { state: 'error', error: result || 'Unknown error' };
+      return { state: "error", error: result || "Unknown error" };
    }
  } catch (error) {
-    return { state: 'error', error };
+    return { state: "error", error };
  }
-}
+} 
--- a/src/lib/notifs.ts
+++ b/src/lib/notifs.ts
@@ -1,18 +1,18 @@
 import {
  SendNotificationRequest,
  sendNotificationResponseSchema,
-} from '@farcaster/miniapp-sdk';
-import { getUserNotificationDetails } from '~/lib/kv';
-import { APP_URL } from './constants';
+} from "@farcaster/miniapp-sdk";
+import { getUserNotificationDetails } from "~/lib/kv";
+import { APP_URL } from "./constants";

 type SendMiniAppNotificationResult =
  | {
-      state: 'error';
+      state: "error";
      error: unknown;
    }
-  | { state: 'no_token' }
-  | { state: 'rate_limit' }
-  | { state: 'success' };
+  | { state: "no_token" }
+  | { state: "rate_limit" }
+  | { state: "success" };

 export async function sendMiniAppNotification({
  fid,
@@ -25,13 +25,13 @@ export async function sendMiniAppNotification({
 }): Promise<SendMiniAppNotificationResult> {
  const notificationDetails = await getUserNotificationDetails(fid);
  if (!notificationDetails) {
-    return { state: 'no_token' };
+    return { state: "no_token" };
  }

  const response = await fetch(notificationDetails.url, {
-    method: 'POST',
+    method: "POST",
    headers: {
-      'Content-Type': 'application/json',
+      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      notificationId: crypto.randomUUID(),
@@ -48,17 +48,17 @@ export async function sendMiniAppNotification({
    const responseBody = sendNotificationResponseSchema.safeParse(responseJson);
    if (responseBody.success === false) {
      // Malformed response
-      return { state: 'error', error: responseBody.error.errors };
+      return { state: "error", error: responseBody.error.errors };
    }

    if (responseBody.data.result.rateLimitedTokens.length) {
      // Rate limited
-      return { state: 'rate_limit' };
+      return { state: "rate_limit" };
    }

-    return { state: 'success' };
+    return { state: "success" };
  } else {
    // Error response
-    return { state: 'error', error: responseJson };
+    return { state: "error", error: responseJson };
  }
 }
--- a/src/lib/truncateAddress.ts
+++ b/src/lib/truncateAddress.ts
@@ -1,4 +1,4 @@
 export const truncateAddress = (address: string) => {
-  if (!address) return '';
+  if (!address) return "";
  return `${address.slice(0, 14)}...${address.slice(-12)}`;
 };
--- a/src/lib/utils.ts
+++ b/src/lib/utils.ts
@@ -1,6 +1,6 @@
-import { type Manifest } from '@farcaster/miniapp-node';
 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,
@@ -24,6 +24,9 @@ export function getMiniAppEmbedMetadata(ogImageUrl?: string) {
  return {
    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: {
@@ -43,20 +46,17 @@ export function getMiniAppEmbedMetadata(ogImageUrl?: string) {

 export async function getFarcasterDomainManifest(): Promise<Manifest> {
  return {
-    accountAssociation: APP_ACCOUNT_ASSOCIATION,
+    accountAssociation: APP_ACCOUNT_ASSOCIATION!,
    miniapp: {
      version: '1',
      name: APP_NAME ?? 'Neynar Starter Kit',
-      iconUrl: APP_ICON_URL,
      homeUrl: APP_URL,
+      iconUrl: APP_ICON_URL,
      imageUrl: APP_OG_IMAGE_URL,
      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/tailwind.config.ts
+++ b/tailwind.config.ts
@@ -0,0 +1,60 @@
+import type { Config } from "tailwindcss";
+
+/**
+ * Tailwind CSS Configuration
+ * 
+ * This configuration centralizes all theme colors for the mini app.
+ * To change the app's color scheme, simply update the 'primary' color value below.
+ * 
+ * Example theme changes:
+ * - Blue theme: primary: "#3182CE"
+ * - Green theme: primary: "#059669" 
+ * - Red theme: primary: "#DC2626"
+ * - Orange theme: primary: "#EA580C"
+ */
+export default {
+    darkMode: "media",
+    content: [
+    "./src/pages/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/components/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/app/**/*.{js,ts,jsx,tsx,mdx}",
+  ],
+  theme: {
+  	extend: {
+  		colors: {
+  			// Main theme color - change this to update the entire app's color scheme
+  			primary: "#8b5cf6", // Main brand color
+  			"primary-light": "#a78bfa", // For hover states
+  			"primary-dark": "#7c3aed", // For active states
+  			
+  			// Secondary colors for backgrounds and text
+  			secondary: "#f8fafc", // Light backgrounds
+  			"secondary-dark": "#334155", // Dark backgrounds
+  			
+  			// Legacy CSS variables for backward compatibility
+  			background: 'var(--background)',
+  			foreground: 'var(--foreground)'
+  		},
+  		borderRadius: {
+  			lg: 'var(--radius)',
+  			md: 'calc(var(--radius) - 2px)',
+  			sm: 'calc(var(--radius) - 4px)'
+  		},
+  		// Custom spacing for consistent layout
+  		spacing: {
+  			'18': '4.5rem',
+  			'88': '22rem',
+  		},
+  		// Custom container sizes
+  		maxWidth: {
+  			'xs': '20rem',
+  			'sm': '24rem',
+  			'md': '28rem',
+  			'lg': '32rem',
+  			'xl': '36rem',
+  			'2xl': '42rem',
+  		}
+  	}
+  },
+  plugins: [require("tailwindcss-animate")],
+} satisfies Config;
--- 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"]
 }
--- a/vercel.json
+++ b/vercel.json
@@ -1,4 +1,4 @@
 {
  "buildCommand": "next build",
  "framework": "nextjs"
-}
+}
Author	SHA1	Message	Date
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