vocabhack-logo

Welcome to the Vocabhack repository! This project is a simple yet engaging card game designed to help users learn a new language. Currently, the game focuses on the theme of fruit and is available in European Portuguese (pt pt). It was developed as part of a web development bootcamp, marking the completion of the first module.

📋 Table of Contents

🌐 Demo

Check out the live demo here

🌟 Features

  • Language Learning: Engage in a fun card game while learning new words for common fruit in Portuguese.
  • Easy to Understand: Simple and intuitive gameplay suitable for users of all ages.
  • Timer: Challenge yourself with a built-in timer to track your performance and add an element of challenge to the game.
  • Audio Pronunciation: Learn pronunciation by hearing the word when clicking on a card.

🔜 Additional Features We Are Currently Working On

  • Responsive Design
  • Mobile Version
  • Additional Vocabulary Card Decks
  • Additional Languages

⚡️ Technologies

This project is built using the following technologies:

  • HTML
  • CSS
  • JavaScript

🚀 Getting Started

To run the game locally, follow these steps:

  1. Clone this repository:

    git clone https://github.com/mary-brooks/vocabhack.git
    
  2. Navigate to the project directory:

    cd vocabhack
    
  3. Open the index.html file in your preferred web browser.

👩‍💻 Usage

  • Start Screen: Upon opening the game, you will see the start screen with options to begin the game.
  • Gameplay: Flip the cards to match pairs of fruit with their corresponding words in Portuguese.
  • Winning: Successfully match all the pairs within the given timeframe to complete the game.

🤝 Contributing

Contributions are welcome! If you have ideas for improvements or new features, please open an issue or submit a pull request.

📄 License

This project is licensed under the MIT License, which means you are free to use, modify, and distribute the code.