Skip to content

a-bhula/guess-the-emoji

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽ‰ Guess the Emoji ๐ŸŽญ

Guess the Emoji is an interactive one-page game where players try to guess words, phrases, movies, or songs based on emoji clues. It was developed as part of a hackaton by:
๐Ÿ‘จ๐Ÿฝโ€๐Ÿ’ปJesse Obeng
๐Ÿ‘จ๐Ÿฝโ€๐Ÿ’ปAmmaar Bhula
๐Ÿ‘ฉ๐Ÿฝโ€๐Ÿ’ปNadia Bakal

Live Demo

๐Ÿ”— Play the Game Here: Guess The Emoji

Introduction

๐Ÿ“– Table of Contents


๐Ÿ“Œ Project Overview

๐ŸŽฏ Key Objectives:

  • Build a one-page interactive front-end web application using HTML, CSS, and JavaScript.
  • Focus on user experience, accessibility, responsiveness, and DOM manipulation.
  • Test and validate the application using W3C Validator and Jigsaw Validator.
  • Deploy the project using Git and GitHub Pages.

๐ŸŽจ UX/UI Design

๐Ÿ› ๏ธ User Stories

As a player, I want to...
โœ… See emojis displayed prominently so I can guess their meaning.
โœ… Enter my guess in an input field and submit my answer.
โœ… Receive immediate feedback on whether my guess is correct.
โœ… Keep track of my score as I play.
โœ… Request hints when needed.
โœ… Have a timer for each round (optional).
โœ… Enjoy smooth animations and fun visuals.
โœ… Play on mobile, tablet, and desktop devices seamlessly.

๐ŸŽจ Colours

The colour palette for the Guess the Emoji game was carefully chosen to create a fun, energetic, and engaging experience.

Colour Hex Code Usage
๐Ÿ”ด Coral Red #FF6F61 Background, buttons, header gradient
๐ŸŸก Sunshine Yellow #FFCC5C Buttons, score display, header gradient
๐ŸŸ  Warm Orange #FFB347 Button hover effect
โšช White #FFFFFF Emoji display background, modal background
โšซ Dark Grey #333333 Main text colour
๐ŸŸค Shadow Grey rgba(0, 0, 0, 0.3) Box shadows and subtle depth effects

These colours help create a playful and vibrant look while ensuring readability and accessibility.

Main palette

colour pallette

created on: https://coolors.co/

๐Ÿ”  Fonts

The project uses Fredoka, a friendly and modern font that enhances readability.

๐Ÿ“ Wireframes

Detailed wireframes were created for mobile, tablet, and desktop layouts.
๐Ÿ“Œ **View Wireframes: Add wireframe image

๐Ÿ–ผ๏ธ Imagery

The site uses emoji-based visuals rather than external images to create a fun and lightweight experience.


๐Ÿš€ Features

๐ŸŽฎ Core Game Features

โœ… Random Emoji Puzzles โ€“ Guess phrases, movies, and songs from emojis.
โœ… Interactive Input & Submit Button โ€“ Players type their guess and submit.
โœ… Instant Feedback โ€“ Green for correct, red for incorrect.
โœ… Score Tracking โ€“ Score updates dynamically.
โœ… Hint System โ€“ Players can get a hint (e.g., first letter of each word).
โœ… Game Timer โ€“ A countdown adds urgency to the challenge (optional).

๐ŸŽจ UI & Animation

โœ… Confetti & Bounce Animations for correct answers.
โœ… Responsive Design โ€“ Works on mobile, tablet, and desktop.
โœ… Accessible for Screen Readers โ€“ ARIA attributes included.


๐Ÿ› ๏ธ Built With

๐Ÿ–ฅ๏ธ Technology & Languages

HTML
CSS
JavaScript

๐Ÿ“š Libraries & Frameworks

  • Google Fonts (Fredoka)
  • Confetti.js (for fun animations)

๐Ÿ› ๏ธ Tools Used

  • GitHub โ€“ Version control & deployment
  • VS Code โ€“ Code editor
  • Chrome DevTools โ€“ Debugging & testing

โœ… Testing

  • โœ… HTML Validation โ€“ Checked with W3C Validator.
    alt text
  • โœ… CSS Validation โ€“ Tested with Jigsaw Validator.
  • โœ… JavaScript Debugging โ€“ Console logging & error fixing.
  • โœ… Lighthouse Performance Testing โ€“ Checked for accessibility, SEO, and speed.

lighthouse

  • โœ… Responsiveness Testing โ€“ Tested on mobile, tablet, and desktop.

responsiveness

๐Ÿš€ Deployment

Deployed via GitHub Pages

๐Ÿ“Œ Live Demo: Guess The Emoji Game


๐Ÿ”ฎ Future Features

๐Ÿš€ More difficulty levels (Easy, Medium, Hard).
๐Ÿš€ Leaderboard (Store high scores using localStorage).
๐Ÿš€ Multiplayer mode (Compete with friends).
๐Ÿš€ Dark Mode Toggle.


๐Ÿž Known Bugs

โŒ Some screen reader feedback may need improvements.
โŒ Timer resets inconsistently in some cases.


๐Ÿ“œ Citations

The following resources were used in the development of Guess the Emoji:

๐ŸŽจ Fonts

๐Ÿ–ผ๏ธ Images & Icons

๐Ÿ› ๏ธ Libraries & Frameworks

๐Ÿค– AI Assistance

  • Microsoft Copilot: Microsoft Copilot for providing AI-powered support in Visual Studio Code.

๐ŸŽ‰ Thank you for playing Guess The Emoji! ๐ŸŽญ We hope you enjoyed it ๐Ÿš€

About

Guess The Emoji Game

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •