Skip to content

Latest commit

 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 Brain Rot Typing Game

HTML5 CSS3 JavaScript Model-Viewer

A quirky, high-energy typing test that combines internet "brain rot" memes with interactive 3D models. Test your speed, accuracy, and sanity all at once.


✨ Features

  • 🧊 Dynamic 3D Models: Uses <model-viewer> to display unique 3D characters (sahur, bombardiro, etc.) that swap automatically based on the current typing paragraph.
  • Real-time Analytics: Track your WPM (Words Per Minute), CPM (Characters Per Minute), and Score as you type.
  • 🕒 Blitz Sessions: 30-second timers designed for quick, intense bursts of typing.
  • 🧠 Curated Brain Rot: A collection of legendary brain rot phrases to keep things "interesting."
  • 🪄 Premium Aesthetics: Features a modern glassmorphism UI with backdrop blurs, responsive layouts, and smooth animations.
  • Strict Accuracy: Custom input handling that enforces correct spacing and character matching.

🎮 How to Play

  1. Start Typing: The timer starts as soon as you press the first key.
  2. Follow the Highlight: The active character is underlined. Correct hits turn green; mistakes turn red.
  3. Finish the Phrase: Once a paragraph is completed, the next one loads instantly with a new 3D model.
  4. Beat the Clock: Score as many points as possible before the 30 seconds are up!

🛠️ Tech Stack

  • Structure: Semantic HTML5
  • Styling: Vanilla CSS3 (Flexbox, Grid, Glassmorphism, Media Queries)
  • Logic: Vanilla JavaScript (ES6+)
  • 3D Rendering: Google Model-Viewer
  • Assets: GLB models and custom background imagery.

📂 Project Structure

├── assets/
│   ├── models/        # .glb 3D models for each paragraph
│   ├── bg.jpeg        # Thematic background image
│   └── model-viewer.min.js
├── index.html         # Main entry point and UI structure
├── main.js            # Game engine, timer logic, and state management
├── styles.css         # Custom design system and animations
└── README.md          # Project documentation

🚀 Getting Started

Prerequisites

You only need a modern web browser (Chrome, Edge, or Firefox recommended for 3D support).

Local Setup

  1. Clone the repository:
    git clone https://github.com/pulge/brain-rot-typing-test.git
  2. Navigate to the directory:
    cd brain-rot-typing-test
  3. Launch: Open index.html directly in your browser or use a live server extension.

🤝 Contributing

  1. Fork the project.
  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

Distributed under the MIT License. See LICENSE for more information.


"Tung Tung Tung Sahur" - The Game

About

Typing speed test featuring brain rot memes and interactive 3D characters. Tung tung tung sahur.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages