Table of Contents

1. Getting Started 2. Top Bar & Controls (Level & Difficulty) 3. Ramp Row (Shields, Speed, Tier) 4. Kill Position Gauge 5. Expert Row (Reset, Expert Mode, Timer) 6. Scoreboard 7. Gameplay Mechanics (Bubbles, Typing, Particles) 8. Expert / FCFS Mode 9. Timer Sessions 10. Skill Tiers & Shield System 11. Inactivity Pause 12. Practice Editor 13. Speed Ramp System

1. Getting Started

When you load Typemasters, you are greeted by a circular multicolor overlay asking for your name.

Enter "Typist Name"
Player
Go
  1. 1

    Enter your name

    Type any name (or leave the default "Typist Name") and click Go. This name will appear as your badge during the game.

  2. 2

    Game UI appears

    After submitting, the full game interface is revealed: top bar with name badge and level controls, ramp row with shields and tier badge, gauge zone, scoreboard at bottom, and expert/timer row.

  3. 3

    Bubbles start falling

    Colored letter bubbles begin falling from the top of the screen. Your job is to type the matching key to pop them before they reach the bottom.

Player
Level 1
Easy
A
S
D
F
G
CPM 0 • Level 1 • Easy
The game interface after entering a name — bubbles are falling, the scoreboard appears at bottom.

2. Top Bar & Controls

The top bar contains your name badge (clickable — opens the practice editor), and the core game controls.

Player
Level 1
Level 2
Level 3
Easy
Medium
Hard

Level Buttons

Choose which keys to practice. Level 1: Home row (A S D F G H J K L ;). Level 2: Top row (Q W E R T Y U I O P). Level 3: Bottom row (Z X C V B N M , . /).

Combined Levels (Long Press)

Hold a level button for 500ms to combine it with all lower levels. Long-press Level 2 to get Level 1+2. Long-press Level 3 for all three rows. The button gets a white ring when combined.

Difficulty Buttons

Controls bubble spawn rate. Easy: 1 bubble every 2 seconds. Medium: 1 per second. Hard: 2 per second (every 500ms).

Name Badge

Click your name badge at any time to open the practice text editor — a rich-text area for freeform typing practice.

Pro Tip: Start with Level 1 (Easy) and only move to the next level when you can hit every key without mistyping. Accuracy builds speed.

3. Ramp Row (Shields, Speed, Tier)

The ramp row sits below the top bar and contains three key elements.

1x
2x
3x
Beginner

Shield Progress (Left)

Six shield SVG icons representing skill milestones. Shields fill with gold as you achieve higher CPM tiers. They only move forward — never reset within a session.

Speed Circles (Center)

Three circles: 1x, 2x, 3x. Multiplies bubble spawn rate. At 3x on Hard, bubbles come every ~167ms. The active circle glows white.

Tier Badge (Right)

Shows your current skill tier name (Beginner → Professional). It glows and pulses when a new tier is achieved. Updates every second with CPM.

4. Kill Position Gauge

The gauge is a horizontal dotted line that moves vertically along a hidden track. It shows your average reaction time by measuring where on screen you pop bubbles.

Novice
Expert (top 33%)
Beginner (33%-66%)
Novice (bottom 34%)

How It Works

Every time you pop a bubble, the fraction of screen height where the pop occurred is recorded (0 = top, 1 = bottom). A running average is maintained. The gauge line's position reflects this average.

What It Means

Expert (green, top 33%): You react fast, popping near the top. Beginner (purple, middle): Average reaction. Novice (orange, bottom 34%): Bubbles fall far before you hit them — you need to react faster.

Note: The gauge stays hidden for the first 30 seconds to gather enough data, then reveals with a pulse animation.

5. Expert Row (Reset, Expert Mode, Timer)

RESET
EXPERT
1m
3m
5m
10m

RESET Button

Instantly clears all bubbles, timers, shields, scores, and overlays. Resets everything to the starting state (name is preserved).

EXPERT Toggle

Activates FCFS (First Come First Served) mode. See section 8 below for details.

Timer Pills (1m / 3m / 5m / 10m)

Select a timed session. A countdown appears above. When time expires, results overlay shows CPM, WPM, correct/mistyped counts, and skill tier. Click the same timer to deselect and return to free play.

6. Scoreboard

Scoreboard
LEVEL 1 EASY
A
S
Q
20 CPM

Level & Difficulty Display

Shows what level set and difficulty are currently active (e.g., "LEVEL 1+2", "HARD").

Correct / Mistyped History

Green mini-bubbles show the last 5 correctly typed characters. Red mini-bubbles show the last 5 mistyped characters. Use this to spot problem keys.

CPM Display

Real-time Characters Per Minute, updated every second. This is your primary performance metric.

7. Gameplay Mechanics

Bubble Spawning

Bubbles spawn at the top of the screen at random X positions with a random fall duration of 5-7 seconds.

A
S
D
F
G
H

Typing to Pop

  1. 1

    Press a key

    The game listens for keydown events. Only single character keys trigger bubble matching (arrow keys, modifiers, etc. are ignored).

  2. 2

    Match check

    The pressed key (uppercased) is compared to every visible bubble's character. If a match is found (and in Expert mode, it's the oldest bubble), the bubble pops.

  3. 3

    Pop animation

    The bubble gets the .popping class, triggering popBurst: scale up to 1.5x, shrink to 0, fade out. Simultaneously, 4 colored particles burst outward from the pop position.

  4. 4

    Scoring

    Correct hits increment CPM and add to the correct history. Misses (pressing a key that matches no bubble) add to mistyped history.

  5. 5

    Missed bubbles

    If a bubble reaches the bottom without being popped, it's removed and counts as a "kill" at fraction 1.0 (bottom of screen), dragging your gauge toward Novice.

8. Expert / FCFS Mode

Toggle Expert mode via the green EXPERT button. When active, the button gets a white border and full opacity.

A
S
D
Yellow dot = oldest bubble (must type this one first)

In Expert mode, a pulsing yellow dot marks the oldest (longest-falling) bubble. You can only pop the marked bubble — pressing any other key has no effect. This forces:

When to use it: Enable Expert mode after you're comfortable with all keys. It's excellent for building reading-ahead ability and consistent cadence.

9. Timer Sessions

Timer sessions add a time constraint and produce an end-of-session results screen. This is the best way to measure improvement over time.

Starting a Timer

Click 1m, 3m, 5m, or 10m. All bubbles are cleared, a countdown appears below the ramp row, and the game begins fresh at the current level/difficulty/speed.

Countdown Display

A white pill below the ramp row shows MM:SS countdown. When under 10 seconds, it turns red and blinks.

End of Session

The results overlay shows: CPM, WPM, Correct, Mistyped, and your Skill Tier with color and star icon. Click PLAY AGAIN to dismiss.

Deselecting a Timer

Click the same timer pill again to cancel the session and return to untimed free play.

TIME'S UP
CPM 42
WPM 8
Correct 127
Mistyped 3
Intermediate
PLAY AGAIN
End-of-session results screen showing CPM, WPM, accuracy, and skill tier.

10. Skill Tiers & Shield System

Typemasters has 7 skill tiers based on your CPM. Tiers are sticky — you can only go up, never down (within a session).

TierMin CPMMin WPMShield
Beginner1050★ Shield 0
Elementary1575★ Shield 1
Intermediate25125★ Shield 2
Advanced35175★ Shield 3
Proficient45225★ Shield 4
Fast60300★ Shield 5
Professional80400★ Shield 6

How Tiers Work

Every second, CPM is recalculated and checked against tiers. When you cross a threshold, the corresponding shield fills with gold gradient, animates into view, and the tier badge updates with a glow pulse.

Shield Visuals

Each shield is an SVG with a gradient fill. Unlocked shields transition from gray to gold. A star appears inside, and the whole shield animates with a spring-like pop.

11. Inactivity Pause

If no key is pressed for 40 seconds, the game automatically pauses:

PAUSED
No activity detected
RESTART

The inactivity timer does not run when a timer session is active (so your timed session won't pause due to inactivity).

12. Practice Editor

Click your name badge at any time to open the practice text editor — a full rich-text typing area for freeform practice.

Font Size Color
B
I
U
Background
Start typing here...

Formatting Toolbar

Font family (6 options), font size (6 levels), font color (12-swatch picker), Bold/Italic/Underline toggles, and background color.

Fullscreen Mode

Click the expand icon (⛛) to make the editor fullscreen. Click again to return to windowed mode.

13. Speed Ramp System

The game automatically increases difficulty over time through speed ramping.

ParameterValue
Ramp intervalEvery 2 minutes
Speed increase1.5x faster each ramp
Minimum interval150ms (hard floor)
Multiplier stacking1x/2x/3x divides the current interval

Example progression on Easy (starting at 2000ms):

Using 3x speed multiplier on Hard difficulty: starts at 167ms, floor is 150ms, so you hit maximum speed almost immediately. This creates intense practice sessions.

Pro Tip: Use the speed ramp to your advantage. Play on Easy/1x for endurance training (long sessions that get progressively harder). Use Hard/3x for short, explosive speed drills.

Ready to Play?

You now know everything about Typemasters. Launch the game and start training.

Play Typemasters