Skip to content

TaiVanNgo/pick-your-club

Repository files navigation

Pick Your Club - Random Team Selector

Live Demo: https://pick-your-club.vercel.app/

"Pick Your Club" is a web application designed for soccer gamers (e.g., eFootball, PES, EA SPORTS FC) who want to add an element of surprise and challenge to their gameplay. Instead of always picking your favorite or strongest team, this tool allows you to randomly select clubs based on various customizable criteria.

⚽ Features

  • Random Club Selection: Get one or more random clubs to play with.
  • Filter by Star Rating: Specify a minimum and maximum star rating for the clubs.
  • Filter by League: Choose specific leagues to include or exclude from the selection pool.
  • Include National Teams: Option to include national teams in the random selection.
  • Number of Clubs: Select how many regular clubs and national teams you want to pick.
  • Sleek User Interface: Modern and intuitive design for easy navigation and use.
  • Responsive Design: Works well on desktop and mobile devices.

🎮 How to Use

  1. Visit the Live Demo: https://pick-your-club.vercel.app/
  2. Adjust Settings (Optional):
    • Click the "Settings" (gear) icon.
    • Set your preferred star rating range.
    • Select the leagues you want to include.
    • Choose the number of regular clubs to pick.
    • Enable "Include National Teams" and set the number of national teams if desired.
    • Click "Apply Settings".
  3. Pick Clubs: Click the main "Shuffle" button.
  4. View Results: The application will display the randomly selected club(s). If multiple clubs are selected, you can navigate between them.
  5. Enjoy your game!

🛠️ Technologies Used

  • React: A JavaScript library for building user interfaces.
  • TypeScript: Superset of JavaScript that adds static typing.
  • Tailwind CSS: A utility-first CSS framework for rapid UI development.
  • Vite: A fast build tool and development server.
  • Lucide React: Beautiful and consistent icons.
  • Shadcn/ui (Dialog, Slider, Checkbox, Button): Re-usable components built using Radix UI and Tailwind CSS.

🚀 Getting Started Locally (Development)

To run this project locally:

  1. Clone the repository:

    git clone <repository-url>
    cd club-picker-pes-random
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Run the development server:

    npm run dev
    # or
    yarn dev
  4. Open your browser and navigate to http://localhost:8080 (or the port specified in your terminal).

📞 Contact

For questions or feedback, please contact:


Enjoy adding a new layer of fun to your soccer gaming sessions!

About

A web app to randomly pick football/soccer clubs for games like eFootball & EA SPORTS FC, with customizable filters

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages