Skip to content

djmarquito/loteria

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎴 Mexican Lotería Web App

Welcome to the Mexican Lotería Web App – a digital version of the traditional Lotería game that eliminates the need for physical cards! This web application acts as a virtual deck that randomly shuffles and calls out cards, making it perfect for parties, family gatherings, or casual play.

👉 Try it live: https://djmarquito.github.io/loteria/

🧩 Features

  • 🎲 Automatic Shuffle: Every game starts with a freshly shuffled deck.
  • 🔊 Calls Cards Out Loud: Each card is displayed with its image and called out via audio.
  • 📱 Tap or Click to Control: Tap (on mobile) or click (on desktop) anywhere on the screen to start, pause, or resume the game.
  • 🧾 Review While Paused: Scroll the screen while the game is paused to review all the previously called cards.
  • ⏱️ Adjustable Speed: Use the ➕ plus and ➖ minus buttons at the top right to control the speed of the card calls.
  • 🟢 Game Status Display: The current game status (Playing, Paused, or Final) is shown in the top-left corner of the screen.

💻 How It Works

  1. Visit https://djmarquito.github.io/loteria/
  2. Tap or click anywhere to start the game.
  3. Cards will be called out loud and shown one at a time.
  4. Tap or click again to pause the game.
  5. While paused, scroll to review called cards.
  6. Tap/click again to resume play.
  7. Use the +/- buttons at the top right to adjust the speed of the card announcements.
  8. Watch the game status in the top-left to know whether the game is playing, paused, or finished.

🚀 Getting Started Locally

To run the app on your computer:

git clone https://github.com/djmarquito/loteria.git
cd loteria
open index.html

No server setup required – it runs entirely in your browser.

📱 Perfect For

  • Family game nights
  • School or cultural activities
  • Spanish language and culture practice
  • Casual fun with friends

🛠 Built With

  • HTML5
  • CSS3
  • JavaScript
  • Web Audio and DOM APIs

🤝 Contributing

Pull requests are welcome! If you have ideas to improve the app or add features, feel free to fork the repo and open a PR.

📄 License

This project is open source and available under the MIT License.

---------------------------------SPANISH-----------------------------------

🎴 Aplicación Web de Lotería Mexicana Bienvenido a la Aplicación Web de Lotería Mexicana, una versión digital del tradicional juego de lotería que elimina la necesidad de usar cartas físicas. Esta aplicación funciona como una baraja virtual que se mezcla automáticamente y canta las cartas en voz alta, ideal para fiestas, reuniones familiares o juegos casuales.

👉 Pruébala aquí: https://djmarquito.github.io/loteria/

🧩 Características 🎲 Mezcla Automática: Cada partida comienza con una baraja completamente mezclada al azar.

🔊 Canta las Cartas: Cada carta se muestra visualmente y se anuncia con audio.

📱 Toca o Haz Clic para Controlar: Toca (en móvil) o haz clic (en PC) en cualquier parte de la pantalla para iniciar, pausar o reanudar el juego.

🧾 Revisar Cartas Anteriores: Cuando el juego está en pausa, puedes desplazarte por la pantalla para revisar las cartas que ya salieron.

⏱️ Velocidad Ajustable: Usa los botones de ➕ más y ➖ menos en la esquina superior derecha para controlar la velocidad del llamado de cartas.

🟢 Estado del Juego: El estado actual del juego (Jugando, Pausado o Finalizado) se muestra en la esquina superior izquierda de la pantalla.

💻 Cómo Funciona Abre https://djmarquito.github.io/loteria/ en tu navegador.

Toca o haz clic en cualquier parte de la pantalla para iniciar la partida.

Las cartas se mostrarán y se cantarán una por una.

Toca o haz clic de nuevo para pausar el juego.

Mientras esté pausado, puedes desplazarte para revisar las cartas llamadas.

Toca/clic de nuevo para reanudar.

Usa los botones +/- para ajustar la velocidad de la partida.

Observa el estado del juego en la parte superior izquierda de la pantalla.

🚀 Ejecutar Localmente Para usar la aplicación en tu computadora:

bash Copy Edit git clone https://github.com/djmarquito/loteria.git cd loteria open index.html No necesitas instalar ningún servidor – todo funciona directamente en tu navegador.

📱 Ideal Para Noches de juego en familia

Eventos escolares o culturales

Enseñanza del idioma español y cultura latina

Diversión casual entre amigos

🛠 Tecnologías Usadas HTML5

CSS3

JavaScript

APIs de Audio Web y DOM

🤝 Contribuciones ¡Las contribuciones son bienvenidas! Si deseas mejorar la app o sugerir nuevas funciones, haz un fork del repositorio y abre un Pull Request.

📄 Licencia Este proyecto es de código abierto y está disponible bajo la Licencia MIT.

Releases

No releases published

Packages

 
 
 

Contributors