Kitty Lette - NFT Roulette Game

Overview

Kitty Lette is an innovative NFT Roulette Game built on the Flow blockchain, leveraging the $FROTH token ecosystem. Experience the thrill of chance and collection in this playful, speculative, and rewarding Web3 gaming experience.

🎯 Project Description

Kitty Lette combines the excitement of traditional roulette with the innovative world of NFTs and blockchain technology. Players use $FROTH tokens to spin the roulette wheel and receive random NFT rewards across various rarity tiers.

Key Features

• 🎰 Roulette Gameplay: Spin the wheel using $FROTH tokens
• 🎁 NFT Rewards: Receive random NFTs with varying rarities
• 🏆 Rarity Tiers: Common, Rare, Legendary, and Mythic NFTs
• 🌐 Web3 Integration: Built on Flow blockchain for seamless transactions

🚀 Getting Started

Prerequisites

• Node.js 18+ installed
• Flow wallet (Blocto, Lilico, or other compatible wallets)
• $FROTH tokens for gameplay

Installation

1. Clone the repository

   git clone https://github.com/your-username/kitty-lette.git
   cd kitty-lette

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Run the development server

   npm run dev
   # or
   yarn dev
   # or
   pnpm dev
   # or
   bun dev

4. Open your browser Navigate to http://localhost:3000 to view the application.

🎮 How to Play

1. Connect Wallet: Link your Flow-compatible wallet to the application
2. Deposit $FROTH: Fund your account with $FROTH tokens
3. Spin the Wheel: Use $FROTH tokens to spin the roulette
4. Claim NFT: Receive a random NFT based on the spin result
5. Manage Collection: View, trade, or use your NFTs in the ecosystem

Rarity Distribution

Rarity	Probability	Description
Common	60%	Basic tier NFTs
Rare	25%	Enhanced features
Legendary	10%	Exclusive designs
Mythic	5%	Ultra-rare collectibles

🛠 Technology Stack

• Frontend: Next.js 14, React, TypeScript
• Blockchain: Flow Blockchain
• Smart Contracts: Cadence
• Wallet Integration: Flow-compatible wallets
• Styling: Tailwind CSS
• NFT Standard: Flow NFT standards

📁 Project Structure

kitty-lette/
├── app/                 # Next.js app directory
├── components/          # React components
├── lib/                # Utility functions and configurations
├── contracts/          # Cadence smart contracts
├── public/             # Static assets
└── styles/             # Global styles

🎯 Hackathon Alignment

This project was developed for the KittyPunch: Build on $FROTH Challenge with the following alignment:

Category: Gaming Applications & NFT Integrations

• $FROTH as In-Game Currency: Primary token for roulette spins
• NFT Minting & Distribution: Dynamic NFT generation through gameplay
• Engaging Gameplay: Combines chance, collection, and speculation
• Ecosystem Integration: Designed for future use cases within KittyPunch ecosystem

🚀 Deployment

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

npm run build
# or
yarn build

Check out the Next.js deployment documentation for more details.

📄 License

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

🐛 Bug Reports

If you encounter any bugs or issues, please open an issue with detailed information about the problem.

🙏 Acknowledgments

• KittyPunch Team for the $FROTH token ecosystem
• Flow Blockchain for the robust infrastructure
• Forte Hacks for the opportunity and platform

---

Built with ❤️ for the KittyPunch: Build on $FROTH Challenge

For questions or support, please contact the development team or join our community channels.