Skip to content

Latest commit

 

History

History
88 lines (65 loc) · 2.36 KB

README.md

File metadata and controls

88 lines (65 loc) · 2.36 KB

Bingo Card Generator

This project is a web application that allows users to generate custom bingo cards for 90-ball or 75-ball bingo games. Users can create multiple unique cards, customize them with an occasion name, and download them as a PDF for easy printing. Additionally, users can host their own bingo games online, making it a fun and interactive experience for family and friends.

Features

  • Generate 90-ball or 75-ball bingo cards
  • Customize cards with an occasion name
  • Option to include a FREE space
  • Generate multiple unique cards at once
  • Download generated cards as a PDF
  • Host online bingo games

Technologies Used

  • React
  • Next.js
  • Tailwind CSS
  • jsPDF (for PDF generation)
  • html2canvas (for capturing card designs)

Getting Started

Prerequisites

  • Node.js (version 14 or later)
  • npm or yarn

Installation

  1. Clone the repository:

    git clone https://github.com/anishjoshi1999/bingo.git

  2. Navigate to the project directory:

    cd bingo

  3. Install dependencies:

    npm install

    or if you're using yarn:

    yarn install

  4. Run the development server:

    npm run dev

    or with yarn:

    yarn dev

  5. Open http://localhost:3000 in your browser to see the application.

Usage

  1. Choose between 90-ball or 75-ball bingo cards.
  2. Enter the occasion name (optional).
  3. Specify the number of cards you want to generate.
  4. Choose whether to include a FREE space (optional).
  5. Click "Generate Cards" to create your bingo cards.
  6. Use the "Download Cards as PDF" button to save your cards for printing.
  7. To host a bingo game, click on Play Bingo, select your categories, and the host will generate random numbers for the bingo game

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

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

Acknowledgments

  • Thanks to the creators and maintainers of React, Next.js, Tailwind CSS, jsPDF, and html2canvas.
  • Inspired by the joy of bingo games everywhere!