Main

.dockerignore

@@ -0,0 +1,69 @@
+# Dependencies (will be installed during build)
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Build artifacts (generated during deployment)
+.next/
+out/
+dist/
+build/
+.vercel/
+
+# Development files
+.git/
+.gitignore
+.env*.local
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+coverage/
+.nyc_output/
+*.log
+
+# Archives and cleanup
+_archive/
+backstop_data/
+playwright-report/
+test-results/
+
+# Documentation and planning (HUGE - 7.4GB!)
+*.md
+planning/
+docs-archive/
+
+# Cache directories
+.cache/
+cache/
+.turbo/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Large static assets not needed
+planning/template
+*.zip
+*.fig
+*.mmdb
+*.sketch
+
+# Contract artifacts
+lib/openzeppelin-contracts/.git
+
+# Railway and deployment
+.railway
+railway-set-env.sh
+deploy-modules.sh
+
+# Local environment
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local

.env.example

@@ -0,0 +1,255 @@
+# ============================================================================
+# Gmeowbased Environment Configuration
+# ============================================================================
+# Copy this file to .env.local and fill in your values
+# NEVER commit .env.local to version control
+
+# ============================================================================
+# Required: Application URLs
+# ============================================================================
+NEXT_PUBLIC_BASE_URL=http://localhost:3000
+NEXT_PUBLIC_FRAME_ORIGIN=http://localhost:3000
+MAIN_URL=http://localhost:3000
+
+# ============================================================================
+# Required: Supabase Configuration
+# ============================================================================
+# Get these from: https://app.supabase.com/project/_/settings/api
+NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_ANON_KEY=your-anon-key
+SUPABASE_SECRET_TOKEN=your-secret-token
+
+# Supabase Storage Buckets (must exist in dashboard)
+SUPABASE_BADGE_BUCKET=badges
+# Note: Also create 'avatars' and 'covers' buckets for profile uploads
+
+# Supabase Database Configuration
+SUPABASE_LEADERBOARD_TABLE=leaderboard
+SUPABASE_LEADERBOARD_VIEW_CURRENT=leaderboard_current
+SUPABASE_BADGE_TEMPLATE_TABLE=badge_templates
+SUPABASE_LEADERBOARD_SEASON_KEY=season_1
+SUPABASE_MAX_RETRIES=3
+SUPABASE_TIMEOUT_MS=5000
+
+# Supabase Database Columns
+SUPABASE_LEADERBOARD_RANK_COLUMN=rank
+SUPABASE_LEADERBOARD_GLOBAL_COLUMN=global_score
+SUPABASE_LEADERBOARD_CHAIN_COLUMN=chain_score
+SUPABASE_LEADERBOARD_SEASON_COLUMN=season_score
+SUPABASE_LEADERBOARD_UPDATED_COLUMN=updated_at
+
+# ============================================================================
+# Required: Neynar API (Farcaster)
+# ============================================================================
+# Get API key from: https://neynar.com
+NEXT_PUBLIC_NEYNAR_API_KEY=your-neynar-api-key
+NEYNAR_API_KEY=your-neynar-api-key
+NEXT_PUBLIC_NEYNAR_CLIENT_ID=your-client-id
+NEYNAR_WEBHOOK_SECRET=your-webhook-secret
+NEXT_PUBLIC_NEYNAR_WEBHOOK_SECRET=your-webhook-secret
+
+# Neynar Account Configuration
+NEYNAR_BOT_FID=your-bot-fid
+NEYNAR_OWNER_FID=your-owner-fid
+NEYNAR_HEYCAT_FID=your-heycat-fid
+HEY_CAT_FID=your-heycat-fid
+NEYNAR_BOT_SIGNER_UUID=your-signer-uuid
+NEYNAR_SIGNER_UUID=your-signer-uuid
+NEYNAR_SERVER_WALLET_ID=your-wallet-id
+
+# Neynar API Endpoints
+NEXT_PUBLIC_NEYNAR_GLOBAL_API=https://api.neynar.com/v2
+NEYNAR_GLOBAL_API=https://api.neynar.com/v2
+NEYNAR_WEBHOOK_SECRET_VIRAL=your-viral-webhook-secret
+
+# ============================================================================
+# Required: Upstash (Redis Caching & Rate Limiting)
+# ============================================================================
+# Get from: https://console.upstash.com
+# Redis - For caching Neynar API responses
+UPSTASH_REDIS_REST_URL=https://your-redis.upstash.io
+UPSTASH_REDIS_REST_TOKEN=your-redis-token
+REDIS_URL=redis://default:your-redis-token@your-redis.upstash.io:6379
+
+# Redis KV - For rate limiting
+KV_REST_API_URL=https://your-kv.upstash.io
+KV_REST_API_TOKEN=your-kv-token
+
+# Upstash Vector (optional)
+UPSTASH_VECTOR_REST_URL=https://your-vector.upstash.io
+UPSTASH_VECTOR_REST_TOKEN=your-vector-token
+
+# ============================================================================
+# Required: Blockchain Configuration
+# ============================================================================
+# Base Chain (Primary)
+NEXT_PUBLIC_RPC_BASE=https://mainnet.base.org
+RPC_BASE=https://mainnet.base.org
+
+# Contract Addresses
+NEXT_PUBLIC_GM_BASE_CORE=0x...
+NEXT_PUBLIC_GM_BASE_GUILD=0x...
+NEXT_PUBLIC_GM_BASE_NFT=0x...
+NEXT_PUBLIC_GM_BASE_PROXY=0x...
+NEXT_PUBLIC_BADGE_CONTRACT_BASE=0x...
+
+# Chain Start Blocks (for event indexing)
+CHAIN_START_BLOCK_BASE=1234567
+CHAIN_START_BLOCK_ARBITRUM=1234567
+CHAIN_START_BLOCK_OP=1234567
+CHAIN_START_BLOCK_CELO=1234567
+CHAIN_START_BLOCK_INK=1234567
+CHAIN_START_BLOCK_UNICHAIN=1234567
+
+# Additional Chain RPCs
+NEXT_PUBLIC_RPC_OP=https://mainnet.optimism.io
+NEXT_PUBLIC_RPC_CELO=https://forno.celo.org
+NEXT_PUBLIC_RPC_INK=https://rpc-gel-sepolia.inkonchain.com
+NEXT_PUBLIC_RPC_UNICHAIN=https://sepolia.unichain.org
+RPC_OP=https://mainnet.optimism.io
+RPC_CELO=https://forno.celo.org
+RPC_INK=https://rpc-gel-sepolia.inkonchain.com
+RPC_UNICHAIN=https://sepolia.unichain.org
+
+# Oracle Configuration
+ORACLE_PRIVATE_KEY=0x...
+
+# ============================================================================
+# Required: Admin & Authentication
+# ============================================================================
+ADMIN_JWT_SECRET=your-jwt-secret-min-32-chars
+ADMIN_TOTP_SECRET=your-totp-secret
+ADMIN_ACCESS_CODE=your-admin-code
+
+# Maintenance Mode
+MAINTENANCE_ENABLED=false
+MAINTENANCE_PASSWORD=your-maintenance-password
+MAINTENANCE_TOKEN=your-maintenance-token
+
+# ============================================================================
+# Optional: External APIs
+# ============================================================================
+# Coinbase Developer Platform
+COINBASE-API_KEY_ID=your-coinbase-key-id
+COINBASE_API_SECRET=your-coinbase-secret
+NEXT_PUBLIC_ONCHAINKIT_API_KEY=your-onchainkit-key
+ONCHAINKIT_API_KEY=your-onchainkit-key
+NEXT_PUBLIC_ONCHAINKIT_APP_NAME=Gmeowbased
+NEXT_PUBLIC_ONCHAINKIT_LOGO=https://...
+
+# WalletConnect
+NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your-walletconnect-id
+
+# Alchemy
+ALCHEMY_API_KEY=your-alchemy-key
+
+# Block Explorers
+ETHERSCAN_API_KEY=your-etherscan-key
+NEXT_PUBLIC_BASESCAN_API_KEY=your-basescan-key
+
+# DeBank
+DEBANK_API_KEY=your-debank-key
+
+# Talent Protocol
+NEXT_PUBLIC_TALENT_API_KEY=your-talent-key
+TALENT_API_KEY=your-talent-key
+
+# ============================================================================
+# Optional: Task Queues & Webhooks
+# ============================================================================
+# Upstash QStash (for scheduled tasks)
+QSTASH_TOKEN=your-qstash-token
+QSTASH_CURRENT_SIGNING_KEY=your-signing-key
+QSTASH_NEXT_SIGNING_KEY=your-next-signing-key
+QSTASH_URL=https://qstash.upstash.io
+
+# Webhook Secrets
+WEBHOOK_SECRET=your-webhook-secret
+BADGE_MINT_WEBHOOK_URL=https://your-app.com/api/webhook/badge-mint
+GMEOW_BADGE_ADVENTURE_SECRET=your-adventure-secret
+CRON_SECRET=your-cron-secret
+
+# ============================================================================
+# Optional: Badge Minting Configuration
+# ============================================================================
+MINT_BATCH_SIZE=10
+MINT_INTERVAL_MS=5000
+MINT_MAX_RETRIES=3
+
+# ============================================================================
+# Optional: Agent Configuration
+# ============================================================================
+NEXT_PUBLIC_AGENT_EVENTS_INITIAL_LIMIT=50
+NEXT_PUBLIC_AGENT_EVENTS_DELTA_LIMIT=10
+NEXT_PUBLIC_AGENT_EVENTS_POLL_MS=30000
+
+# ============================================================================
+# Optional: UI Assets
+# ============================================================================
+SITE_BG_URL=https://...
+SITE_FONT_URL=https://...
+OG_BG_IMG_DEFAULT=https://...
+OG_BG_IMG_BRONZE=https://...
+OG_BG_IMG_GOLD=https://...
+OG_BG_IMG_PLATINUM=https://...
+
+# ============================================================================
+# Optional: Admin Configuration
+# ============================================================================
+NEXT_PUBLIC_GM_ADMIN_ADDRESSES=0x...,0x...
+
+# ============================================================================
+# PostgreSQL (if using external Postgres instead of Supabase)
+# ============================================================================
+PGUSER=postgres
+PGPASSWORD=your-password
+PGDATABASE=gmeowbased
+
+# ============================================================================
+# Development Notes
+# ============================================================================
+# 1. Supabase Storage Buckets Required:
+#    - avatars (for profile avatars)
+#    - covers (for profile cover images)
+#    - badges (for badge images)
+#    Create these in Supabase Dashboard > Storage
+#
+# 2. Storage Policies:
+#    Buckets should allow:
+#    - Public read access
+#    - Authenticated upload/update
+#
+# 3. Redis Caching:
+#    Optional but recommended for production
+#    App gracefully degrades without Redis
+#
+# 4. Rate Limiting:
+#    Requires Upstash KV (KV_REST_API_URL/TOKEN)
+#    Without it, rate limiting is disabled
+#
+# 5. Neynar API:
+#    Required for Farcaster integration
+#    Free tier available at https://neynar.com
+
+# ============================================================================
+# Optional: Redis Caching (Phase 7 Priority 2)
+# ============================================================================
+# Local Development: Use Docker Compose redis service
+# Production: Use managed Redis (Upstash, Redis Cloud, ElastiCache)
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=
+REDIS_DB=0
+
+# Admin API key for cache management
+ADMIN_API_KEY=your-admin-api-key-here
+
+# ============================================================================
+# Cron Jobs (Vercel)
+# ============================================================================
+# Secret token for authenticating cron job requests
+# Generate with: openssl rand -base64 32
+CRON_SECRET=your-cron-secret-here

.env.local.example

@@ -0,0 +1,17 @@
+# Coinbase Developer Platform
+NEXT_PUBLIC_ONCHAINKIT_API_KEY=your_onchainkit_api_key_here
+
+# WalletConnect Project ID (get from https://cloud.walletconnect.com)
+NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_walletconnect_project_id_here
+
+# RPC URLs (optional - defaults provided)
+NEXT_PUBLIC_RPC_BASE=https://mainnet.base.org
+NEXT_PUBLIC_RPC_OPTIMISM=https://opt-mainnet.g.alchemy.com/v2/demo
+NEXT_PUBLIC_RPC_CELO=https://forno.celo.org
+
+# Neynar API Key (for Farcaster data)
+NEXT_PUBLIC_NEYNAR_API_KEY=your_neynar_api_key_here
+
+# Database (Supabase)
+NEXT_PUBLIC_SUPABASE_URL=your_supabase_url_here
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key_here

.eslintignore

@@ -1,4 +1,5 @@
-next-env.d.ts
-Planing/**
-planning/templates/gmeow2/**
-planning/templates/gmeow3/**
+node_modules
+.next
+planning/
+*.config.js
+*.config.ts

.eslintrc.json

@@ -1,7 +1,18 @@
 {
   "extends": [
     "next/core-web-vitals",
-    "next/typescript"
+    "next/typescript",
+    "plugin:tailwindcss/recommended"
+  ],
+  "plugins": ["tailwindcss"],
+  "ignorePatterns": [
+    "__tests__/**/*",
+    "*.test.ts",
+    "*.test.tsx",
+    "*.spec.ts",
+    "*.spec.tsx",
+    "e2e/**/*",
+    "coverage/**/*"
   ],
   "rules": {
     "@typescript-eslint/no-explicit-any": "off",
@@ -16,6 +27,9 @@
     "@typescript-eslint/prefer-readonly": "off",
     "prefer-const": "warn",
     "react-hooks/exhaustive-deps": "warn",
-    "react/jsx-no-comment-textnodes": "off"
+    "react/jsx-no-comment-textnodes": "off",
+    "tailwindcss/classnames-order": "warn",
+    "tailwindcss/no-custom-classname": "off",
+    "tailwindcss/no-contradicting-classname": "off"
   }
 }

.gitattributes

@@ -0,0 +1,9 @@
+# Tell git to exclude these paths from archives
+planning/ export-ignore
+_archive/ export-ignore
+.next/ export-ignore
+backstop_data/ export-ignore
+test-results/ export-ignore
+playwright-report/ export-ignore
+*.md export-ignore
+*.log export-ignore