Skip to content

README.md

Latest commit

 

History

History
139 lines (99 loc) · 4.28 KB

README.md

File metadata and controls

139 lines (99 loc) · 4.28 KB

Kitty Lette - NFT Roulette Game

Screenshot 2025-10-27 at 19 28 01

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.