typing-trainer

# typing-trainer

Practice typing code to improve speed and accuracy. Works entirely in the browser. No account needed.

## When to use

- Practicing typing speed on real code in your language of choice
- Tracking WPM improvement over time
- Building a custom snippet library for patterns you frequently write
- Setting and tracking daily practice goals

## Usage

Open `typing-trainer` in a browser (run `pnpm dev` from the project root).

### Start a session

1. Open the app (defaults to Home page)
2. Select a language (JavaScript, Python, Go, Rust, TypeScript, SQL, Bash)
3. Select difficulty (Easy, Medium, Hard)
4. Click "Start Practice"
5. Type the displayed code snippet
6. Results show automatically on completion

### Keyboard shortcuts

| Key | Action |
|---|---|
| Any key | Start the timer (first keypress) |
| Backspace | Delete last character |
| Escape | Pause / resume |
| Tab | (disabled - all tabs are spaces in snippets) |

### WPM calculation

```
Net WPM = (correct characters / 5) / minutes * (accuracy / 100)
```

The timer starts on first keypress and stops when the last character is typed correctly.

## Custom snippets

1. Go to Snippets -> Add Custom
2. Enter a title and select a language
3. Paste your code (40-200 characters recommended)
4. Click Save

Custom snippets are stored in localStorage. They appear in the library with a "Custom" badge.

## Goals

Set daily targets at Goals:
- Sessions per day (default: 5)
- WPM target (default: 80)
- Accuracy target (default: 95%)

Progress resets at midnight. Streak counts consecutive days where the session goal was met.

## Environment Variables

| Variable | Default | Description |
|---|---|---|
| `VITE_APP_VERSION` | `dev` | Version string shown in Settings |

## Data storage

All data is stored in localStorage under the `tt_` prefix:

| Key | Contents |
|---|---|
| `tt_sessions` | Array of completed sessions (last 1000) |
| `tt_custom` | Array of custom snippets |
| `tt_goals` | Daily goal settings |
| `tt_settings` | User preferences |

Clearing browser data removes all history. Use the Export CSV button in History to back up sessions first.

## Troubleshooting

### WPM shows 0 after completing a snippet

The timer requires at least one keypress to start. If you paste text instead of typing, the measurement is incorrect. Only keyboard input is measured.

### Snippet not advancing on correct key

Check the Settings page - if "Stop on error" is on, you must correct mistakes before continuing. If off, incorrect keys still advance the cursor but count as errors.

### Custom snippets disappeared

Custom snippets are stored in localStorage. Clearing your browser's site data for this origin will remove them. Export a backup from the Snippets page before clearing.