Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 

Repository files navigation

AI generated

GRIDFLUX

Stop looking down. Master your layout. Trust your fingers.

HTML5 Zero Dependencies eSports Ready Moosy Research

A 3D spatial typing engine that turns ergonomic layout memorization into a color-coded, high-speed arcade rhythm game.


Launch GridFlux




📊 The Ergonomic Transition Trap

Switching to an advanced ergonomic keyboard (like a Glove80) initially destroys your muscle memory. Standard typing websites fail to help you transition because they only show you what to type, not how to physically reach it.

  • The Visual Crutch: You keep looking down at your hands to find the keys, breaking your flow state and capping your speed.
  • The Repetitive Strain Risk: Without visual guidance, users tend to improvise sloppy key-reaches, twisting their wrists or overextending weak fingers, which rapidly leads to fatigue.
  • 2D Training for a 3D Board: Flat keyboard diagrams don't translate to the physical keywells and thumb clusters of modern ergonomic hardware.

🧠 What This Game Actually Trains

GridFlux is not a reading test; it is a visual coordination and biomechanical training tool. By combining 3D spatial tracking with strict color-coded finger assignments, it forces your brain to map hardware directly to your motor cortex.

  • Strict Finger Discipline: GridFlux assigns a distinct color to every finger. You are forced to execute key presses with the anatomically correct digit, preventing bad habits before they form.
  • The 3D Grid: Nodes don't just appear; they descend toward you on a Z-axis, replicating the physical layout and column stagger of your exact keyboard.
  • The Ghost Tutors: Live, semi-transparent hand overlays show you the exact resting position and micro-movements required for every single incoming keystroke.

You are not just typing—you are building a 3D topographical map of your keyboard in your mind.


🚀 How It Works

Typing becomes a high-speed rhythm game.

  • Match the Color: Every falling node is color-coded to a specific finger (Pinky, Ring, Middle, Index, Thumb).

🔬 Source & Validation: Color-associative learning bypasses the cognitive delay of translating a "letter" to a "physical location." By matching colors to digits, GridFlux leverages the Stroop effect and visual-motor mapping to hardwire finger-discipline instantly.

  • Clear the Grid: Hit the corresponding key before the data node crashes into your hardware.
  • Survive the Glitch: Make a mistake, and the game’s engine distorts—hitting you with Fisheye, Cipher, and Surge visual glitches that force you to recover under pressure.
  • Trigger Hyperdrive: Build your combo to unleash massive score multipliers and screen-clearing tactical shields.

The result:
👉 An immersive feedback loop that completely eliminates the urge to look down at your hands.


🎯 What You Gain

  • Zero Visual Dependency: You will learn to navigate keywells, thumb clusters, and symbol layers entirely by touch.
  • Pain-Free Execution: Enforcing proper finger assignment prevents the repetitive strain caused by sloppy, improvised reaching.
  • Reactive Muscle Memory: Faster transitions through rhythm-based continuous input, rather than static paragraph reading.

🔥 Core Systems

  • Hardware-Aware 3D Engine: GridFlux reads your layout and projects it into a 3D space. It knows exactly where your satellite thumb keys are (e.g., C2R6 on a Glove80) and maps them perfectly.
  • Color-Coded Learning: A strict visual system that trains finger-discipline instantly. You stop thinking about "the letter T" and start reacting to "Green / Index Finger."
  • Dynamic Threat Nodes: * Juggernauts: Massive, high-priority targets.
    • Word Blocks: Rapid-fire strings that test your burst WPM.
    • Decoys: Glitched red nodes that damage you if typed.
  • Live Esports HUD: Track your live combo streaks, WPM, and health via a sleek, distraction-free interface.

⌨️ Supported Keyboards

  • MoErgo Glove80
  • MoErgo Go60
  • ZSA Voyager
  • Corne (42-key)
  • Standard ANSI 60% keyboards

📁 Custom Layout Support

Upload your own JSON layout configuration:

  • Keys are mapped correctly to the 3D grid automatically.
  • Tutor hands instantly adjust their resting positions to match your physical hardware.
  • Perfect for custom ZMK or MoErgo Layout Editor exports. No manual CSS or coding required.

🕹️ Quick Start

  • Open the game.
  • Select your hardware.
  • Place your hands on the home row.
  • Watch the colors. Trust your fingers.

No installs. No setup. No friction.


🧬 Bottom Line

You don't need to look down. You don't need to guess your reaches. You need rhythm, color coordination, and flow state.

Stop looking down. Master your layout. Trust your fingers.

About

Train precise finger placement A Tetris-inspired typing game that teaches you exactly which finger to use for each key. Reinforce proper technique with color-guided cues, whether you’re learning from scratch or refining your form.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages