# YouSaidWhat

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

## What It Does

- Provides random English pronunciation practice lines.
- Uses speech-to-text feedback through the browser Web Speech API.
- Colors matched and missed words after speaking.
- Shows a simple score for each spoken attempt.
- Shows a short feedback message for the score.
- Links each phrase word to Google Translate for pronunciation checks.
- 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 lines 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, colors matched and missed words, and shows extra words.

## Practice Content

The phrase catalog is AI-assisted and research-constrained. Practice lines are designed to be short, one-clause, everyday lines 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 tool.