# Typing Tutor

> Practice touch typing with short lessons and local bests.

Typing Tutor is a browser-based touch-typing practice app in MyBox. It offers short lessons, live WPM and accuracy, per-character feedback, and local bests. It is desktop-first because mobile virtual keyboards cannot teach touch typing, but an external keyboard works.

## Lessons

- Home row: anchor the fingers on A S D F and J K L ;.
- Top row: reach Q W E R T Y U I O P from the home row.
- Bottom row: practise Z X C V B N M and nearby punctuation.
- Numbers: stretch to 1 2 3 4 5 6 7 8 9 0.
- Punctuation: practise comma, period, semicolon, apostrophe, slash, and hyphen.
- Common words: build rhythm with short, familiar English words.

## How a lesson works

- Choose a lesson to show its target text and focus the typing input.
- The timer starts on the first keystroke. Deleting and retyping a character updates the result.
- Each typed character is compared with the target. Incorrect positions are marked with an underline and a background, not color alone; the current position is also marked.
- Live metrics show WPM, accuracy, errors, and elapsed time. A progress bar tracks completed characters.
- A completed lesson shows a summary, a new-best indicator when WPM improves, and actions to restart or continue to the next lesson.
- Pasting and dropping text are disabled so the target cannot be copied into the input.

## Metrics

- WPM uses the standard formula: correct characters divided by 5, then divided by elapsed minutes.
- Accuracy is correct characters divided by typed characters, shown as a percentage.
- Zero elapsed time and empty input produce 0 WPM and 0% accuracy, never `Infinity` or `NaN`.
- Extra characters beyond the target count as errors.

## Progress and privacy

- The selected lesson, best WPM, best accuracy, and completed attempt count are saved in this browser under `mybox-typing-tutor-v1`.
- Typed text and target text are never stored. Clearing progress affects only this key and does not change other MyBox apps or settings.
- No account, backend, API key, or external content is needed. All lesson text is built into the page.
- Analytics are limited to aggregate events: `typing_lesson_start` with the lesson id and `typing_lesson_complete` with a WPM bucket. Typed text, target text, and free text are never sent.

## Accessibility and devices

- The typing input has a persistent label, a description, and a polite live status for progress and completion.
- The on-screen keyboard highlights the next expected key for physical-keyboard users.
- Visible focus rings and a keyboard-only flow support keyboard navigation. Character feedback does not rely on color alone.
- A physical keyboard is recommended. Reduced-motion preferences disable character highlight transitions.

## Notes

- Lessons use a US English keyboard layout. Other layouts, custom text, and imported lessons are not supported in this version.
- This Markdown twin is static. Open the interactive page to type a lesson and see local progress.

## Related

- [Typing Tutor](https://mybox.id/typing)
- [Math Practice](https://mybox.id/math-practice)
- [Graph Plotter](https://mybox.id/graph-plotter)
- [Solar System](https://mybox.id/solar-system)
- [Apps](https://mybox.id/apps): Every app with a short description.
