KABBALAH CODE - Web3 Mystical Game

Daily mystical predictions powered by sacred Kabbalah numerology, your unique Web3 soul signature, and the eternal Tree of Life.

🌟 Features

• Daily Rituals - Receive mystical prophecies and earn KCODE tokens
• Daily Meditation - Unlock ancient wisdom and spiritual insights
• Wheel of Fortune - Spin for rewards with mystical energy
• Task System - Complete quests to earn tokens and unlock achievements
• Referral System - Invite friends and earn milestone rewards
• Social Integration - Connect Twitter, Telegram, and Discord
• Tree of Life - Unlock sacred Sephirot and mint unique NFTs (Coming Soon)
• Smart Contracts - On-chain token rewards and NFT minting

🚀 Tech Stack

Frontend

• Next.js 16 - React framework with App Router
• TypeScript - Type-safe development
• Tailwind CSS - Utility-first styling
• Radix UI - Accessible component primitives
• Wagmi - React hooks for Ethereum
• Viem - TypeScript Ethereum library

Backend

• Supabase - PostgreSQL database and authentication
• Next.js API Routes - Serverless API endpoints
• Sentry - Error tracking and monitoring

Blockchain

• Polygon Amoy Testnet - Layer 2 scaling solution
• Hardhat - Smart contract development
• Ethers.js - Ethereum library
• KCODE Token - ERC20 utility token
• Kabbalah NFT - ERC721 collectibles

Integrations

• WalletConnect - Multi-wallet support
• MetaMask - Browser wallet integration
• Coinbase Wallet - Mobile wallet support
• Discord OAuth - Social authentication
• Telegram Bot - Bot verification
• Twitter API - Tweet verification

📦 Installation

Prerequisites

• Node.js 18+
• npm or yarn
• MetaMask or compatible Web3 wallet
• Supabase account
• Vercel account (for deployment)

Setup

1. Clone the repository

git clone https://github.com/your-username/kabbalah-code.git
cd kabbalah-code

2. Install dependencies

npm install

3. Configure environment variables

cp .env.example .env.local

Edit .env.local with your credentials:

• Supabase URL and keys
• Smart contract addresses
• Social integration credentials
• Sentry DSN (optional)

4. Run development server

npm run dev

Open http://localhost:3000

🔧 Configuration

Environment Variables

See .env.example for all required variables:

• Blockchain: Chain ID, RPC URL, contract addresses
• Database: Supabase URL and keys
• Social: Discord, Telegram, Twitter credentials
• Monitoring: Sentry DSN
• Admin: Admin wallet addresses

Smart Contracts

Deploy contracts to Polygon Amoy:

cd contracts-deploy
npm install
npx hardhat compile
npx hardhat run scripts/deploy.js --network polygon-amoy

Update contract addresses in .env.local

Database Setup

1. Create Supabase project
2. Run migrations from supabase/migrations/
3. Set up Row Level Security policies
4. Configure authentication providers

📚 Documentation

English

• Production Checklist - Complete deployment guide
• Quick Deploy - Deploy in 30 minutes
• Sentry Setup - Error tracking configuration
• Test Sentry - Test error tracking
• Level System - User progression mechanics
• Wheel Spin Fix - Race condition solutions
• Security Audit - Security analysis
• Social Integrations - OAuth setup

Russian Documentation

• Готовность к продакшену - Production readiness
• Настройка Sentry - Sentry setup guide
• Система уровней - Level system
• Исправление спинов - Wheel spin fixes
• Токеномика - Token economics
• Верификация заданий - Task verification
• Реферальная система - Referral milestones
• Исправления безопасности - Security fixes

🎮 How to Play

1. Connect Wallet - Use MetaMask, WalletConnect, or Coinbase Wallet
2. Complete Daily Ritual - Receive prophecy and earn 0.5 KCODE
3. Daily Meditation - Unlock wisdom and earn 0.5 KCODE
4. Spin the Wheel - Win KCODE tokens and multipliers
5. Complete Tasks - Social connections, referrals, and more
6. Invite Friends - Earn milestone rewards from referrals
7. Level Up - Progress through 75 levels
8. Unlock Sephirot - Mint unique NFTs (Coming Soon)

🏗️ Project Structure

├── app/                    # Next.js App Router
│   ├── api/               # API routes
│   ├── dashboard/         # Main dashboard
│   └── layout.tsx         # Root layout
├── components/            # React components
│   ├── dashboard/        # Dashboard components
│   ├── ui/               # UI primitives
│   └── web3/             # Web3 components
├── lib/                   # Utilities and helpers
│   ├── api/              # API clients
│   ├── db/               # Database utilities
│   ├── points/           # Points calculation
│   ├── referrals/        # Referral system
│   ├── security/         # Security utilities
│   └── web3/             # Web3 utilities
├── contracts/             # Smart contracts
├── supabase/             # Database migrations
└── public/               # Static assets

🔐 Security

• CSRF Protection - Token-based validation
• Rate Limiting - API abuse prevention
• Input Validation - Zod schema validation
• SQL Injection Protection - Parameterized queries
• XSS Protection - React auto-escaping
• Content Security Policy - Strict CSP headers
• Row Level Security - Database access control

🧪 Testing

# Run all tests
npm run test:all

# API health check
npm run test:api-health

# Contract tests
npm run contracts:test

# E2E tests
npm run test:e2e

🚀 Deployment

Vercel (Recommended)

1. Connect repository to Vercel
2. Configure environment variables
3. Deploy

vercel --prod

Manual Deployment

npm run build
npm start

📊 Monitoring

• Sentry - Error tracking and performance monitoring
• Vercel Analytics - Web vitals and performance
• Supabase Dashboard - Database monitoring
• Polygon Scan - Blockchain transactions

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Kabbalah Wisdom - Ancient mystical teachings
• Polygon - Layer 2 scaling solution
• Supabase - Backend infrastructure
• Vercel - Deployment platform
• Next.js - React framework
• Community - All contributors and users

📞 Support

• Documentation: Check the docs folder
• Issues: GitHub Issues
• Discord: Join our community
• Twitter: @KabbalahCode

🗺️ Roadmap

• Core gameplay mechanics
• Smart contract integration
• Social integrations
• Referral system
• Sentry monitoring
• Tree of Life NFTs
• Mobile app
• Mainnet deployment
• Advanced analytics
• Community governance

---

Built with ❤️ and mystical energy ✨

Discover your destiny through the sacred wisdom of Kabbalah