Nymb is a cutting-edge Telegram Mini App that combines gaming, social features, and blockchain technology. Built on the TON (The Open Network) blockchain, it offers users an immersive gaming experience with NFT minting, social interactions, and reward systems.

• Swipe Game: Interactive card-based gaming mechanics
• Battle Game: Competitive gameplay with Rive animations
• Daily Rewards: Claim daily bonuses to keep players engaged
• Farming System: Earn rewards through various activities

• Star Board: Leaderboard system to track top performers
• Referrals (Frens): Invite friends and earn rewards
• Tasks System: Complete challenges for additional rewards

• TON Connect: Seamless wallet connectivity
• NFT Minting: Mint unique NFTs with 0.1 TON transactions
• Early Access NFTs: Special minting opportunities for early users
• Transaction Verification: Real-time blockchain transaction monitoring

• React 19 with TypeScript
• Vite for fast development and building
• React Router DOM for navigation
• Rive Animations for rich interactive graphics
• Lottie for additional animations

• TON Connect UI for wallet integration
• ton-core for blockchain interactions
• Custom transaction handling with BOC (Bag of Cells) processing

• ESLint with TypeScript support
• Prettier for code formatting
• PostCSS for styling
• Vite SVGR for SVG component generation

The app is specifically designed as a Telegram Mini App with:

• Telegram Web App API integration
• Safe area handling for mobile devices
• Custom styling for Telegram's dark theme
• Optimized for mobile-first experience

• Node.js (v18 or higher)
• npm or yarn
• Telegram account for testing

1. Clone the repository:

git clone <repository-url>
cd nymb

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

The app will be available at http://localhost:3000

npm run build

This will generate optimized files in the dist/ directory with a post-build script for additional processing.

The app uses various polyfills and configurations for blockchain compatibility:

• Buffer polyfills for browser compatibility
• Global variable definitions for TON Connect
• Custom Vite configuration for Node.js modules

The app connects to TON wallets using a manifest file:

https://nymb-frontend.vercel.app/manifest/tonconnect-manifest.json

src/
├── api/           # API client and backend integrations
├── assets/        # Images, icons, and animations
├── common/        # Reusable components
├── context/       # React context providers (Auth, etc.)
├── hooks/         # Custom React hooks
├── pages/         # Main application pages
├── types/         # TypeScript type definitions
├── utils/         # Utility functions
├── App.tsx        # Main application component
└── main.tsx       # Application entry point

• Index: Main landing page with animations and game previews
• Home: User dashboard
• Star Board: Leaderboard and rankings
• Tasks: Challenge and quest system
• Frens: Referral and social features
• Daily Rewards: Daily check-in system
• Swipe Game: Card-based gaming interface

• Authentication: Telegram-based user authentication
• Wallet Integration: TON Connect for blockchain operations
• NFT Minting: Complete transaction flow for NFT creation
• Animation System: Rive-based animations for enhanced UX

• TypeScript for type safety
• ESLint configuration for code quality
• Secure transaction handling
• Proper error handling for blockchain operations
• Local storage management for user data

The application is configured for deployment on Vercel with:

• Optimized build configuration
• Proper asset handling
• TON Connect manifest hosting

• Lazy loading for animations
• Optimized bundle splitting
• Efficient React rendering
• Minimal blockchain API calls

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run linting and tests
5. Submit a pull request

• npm run dev - Start development server
• npm run build - Build for production
• npm run postbuild - Run post-build processing
• npm run lint - Run ESLint
• npm run preview - Preview production build

• TON Connect Documentation
• Telegram Mini Apps
• Rive Animations

Nymb - Where gaming meets blockchain in the Telegram ecosystem.