# YouSaidWhat

YouSaidWhat is a browser-based pronunciation practice game for English speaking clarity. Users read random everyday sentences aloud, and the app uses browser speech recognition to compare the spoken transcript with the target text.

## What It Does

- Provides random English pronunciation prompts.
- Uses speech-to-text feedback through the browser Web Speech API.
- Shows word-level hits and misses after speaking.
- Shows a simple score for each spoken attempt.
- Normalizes common speech-recognition formatting such as times, prices, numbers, dates, and contractions before scoring.
- Gives quick feedback to make pronunciation practice feel lighter and more repeatable.

## How It Works

1. The app fetches short English practice phrases from the YouSaidWhat API.
2. The user reads one phrase aloud in a supported browser.
3. Browser speech recognition turns the audio into a transcript.
4. The app compares the target words with the transcript and labels word-level hits, misses, and extra words.

## Practice Content

The phrase catalog is AI-assisted and research-constrained. Practice lines are designed to be short, one-clause, everyday sentences using common vocabulary. The generation rules prioritize CEFR-style communication situations, pronunciation features that matter for intelligibility, and wording that is safer for browser speech recognition.

## Best For

- English learners practicing pronunciation.
- ESL speakers improving speaking clarity.
- Users who want quick, low-pressure speaking drills.
- Teachers or tutors looking for a simple browser-based pronunciation activity.

## Technical Notes

The app runs in the browser and requires speech recognition support, such as Chrome or Safari. It does not require an account for the core pronunciation game.