Skip to content

FahmidaTasmia/cricket-bid-pro

Repository files navigation

🏏 Cricket Bid Pro

Cricket Bid Pro is a dynamic and interactive bidding platform built with React and Vite, simulating a real-time cricket auction experience. Whether you're managing your own cricket team or simulating a sports management league, this project demonstrates a robust, scalable, and engaging user experience.

🚀 Project Highlights

  • 🔥 Built with React + Vite for blazing-fast development.
  • ⚙️ Modular component design using functional programming principles.
  • 🎨 Modern UI with interactive player cards, hover animations, and bid validation.
  • 🧠 LocalStorage support for persistent user data.
  • 📢 Real-time notifications using react-toastify.
  • 📬 Newsletter subscription logic with simple form validation.
  • 🛡️ Player selection with role and coin validation.

🧩 Features

Feature Description
🔄 Bidding System Users can bid on players with virtual coins, enforcing bid limits.
🧍 Team Builder Users form a cricket team by selecting valid players across roles.
🔔 Toast Notifications Real-time feedback for bidding, errors, and confirmations.
💾 Persistent State Data stored in LocalStorage to preserve team selections across sessions.
📨 Newsletter Signup Simple email subscription interface to simulate engagement.

📂 Folder Structure

cricket-bid-pro/
│
├── LICENSE                 # MIT License file
├── README.md
├── package.json
├── vite.config.js
├── public/                 # Static assets
├── src/
│   ├── components/         # Reusable components (PlayerCard, TeamGrid, etc.)
│   ├── pages/              # App pages (Home, Players, Bidding, Team)
│   ├── utils/              # Helper functions for bid logic, localStorage, etc.
│   ├── assets/             # Images and icons
│   └── App.jsx             # Main application component

🛠️ Technologies Used

  • Frontend: React, Vite, JSX
  • Styling: tailwindcss, daisyUI, Animations
  • State Management: useState, useEffect, LocalStorage
  • Notifications: react-toastify
  • Form Handling: HTML5 validation

🧠 What You’ll Learn (Or Showcase!)

  • Real-world React component structuring
  • Functional design thinking for user interactivity
  • LocalStorage integration for data persistence
  • Custom hook patterns and prop-drilling
  • UI/UX design strategies in sports platforms

🖼️ Screenshots

🎮 Homepage Interface

Homepage Screenshot

🧾 Player Bidding Interface

Player Bidding Screen


📦 Installation

git clone https://github.com/yourusername/cricket-bid-pro
cd cricket-bid-pro
npm install
npm run dev

💡 Future Improvements

  • 🔗 Backend/Firebase Integration
  • 🔐 User Authentication System
  • ⚔️ Multiplayer Bidding Support
  • 🏁 Leaderboards and Stats History

👤 Author

Fahmida Tasmia
A passionate full-stack developer focused on building high-impact, user-centric applications.


📄 License

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

About

Real-time cricket player auction platform: Dynamic bidding system, seamless user experience, and interactive team management | React (Vite) + Node.js

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors