User Documentation - English Expressions

Welcome

Welcome to the English Expressions learning app! This application helps you learn English expressions and their French translations through interactive flashcards, quizzes, and progress tracking. Whether you're a beginner or looking to expand your vocabulary, this app provides a comprehensive learning experience.

Getting Started

When you first open the app, you'll see the Home page with an overview of your learning progress. Here's what you'll find:

Total Expressions: The number of expressions available in the database
Learned: Expressions you've marked as learned
Favorites: Expressions you've saved to your favorites
Categories: Different categories of expressions available

From the Home page, you can quickly access the main features using the "Get Started" buttons or navigate using the menu at the top (desktop) or bottom (mobile).

Navigation

The app has several main sections accessible through the navigation menu:

🏠 Home: Overview of your progress and quick access to all features
🎴 Flashcards: Interactive flashcard learning mode
🎯 Quiz: Test your knowledge with multiple-choice questions
🔍 Browse: Search and explore all expressions
⭐ Favorites: View and manage your favorite expressions
📊 Progress: Track your learning statistics and achievements

Features

🎴 Flashcards

The flashcard feature allows you to learn expressions by flipping cards. Each card shows either the English expression or its French translation. Click or tap the card to flip it and see the translation. You can mark expressions as learned or add them to favorites directly from the flashcard view.

How to use:

Navigate to the Flashcards section
Use the "Hide Learned" checkbox to filter out expressions you've already mastered
Use the "Show Vulgar" checkbox to include expressions marked as vulgar (hidden by default)
Click or tap a card to flip it and see the translation
Use the arrow buttons (← / →) to move between cards
Click the "Flip" button or tap the card to see the other side
Click the star icon to add/remove from favorites
Click the checkmark to mark as learned

🎯 Quiz

Test your knowledge with interactive quizzes. The quiz presents you with an English expression and multiple-choice answers in French. Select the correct translation to score points.

How to use:

Navigate to the Quiz section
Select a category (including "Favorites") to test specific expressions
Read the English expression within the 15-second time limit
Select the correct French translation from the options
Get immediate feedback on your answer
Continue through the quiz to improve your score

🔍 Browse

The Browse section allows you to search and explore all available expressions. You can filter by category, difficulty level, or search for specific expressions.

How to use:

Navigate to the Browse section
Use the search bar to find specific expressions
Filter by category (including "Favorites") or difficulty using the filter options
Click on any expression to see details and examples
Add expressions to favorites or mark as learned

⭐ Favorites

Save your favorite expressions for quick access. The Favorites section shows all expressions you've marked as favorites, making it easy to review them later.

How to use:

Click the star icon on any expression to add it to favorites
Navigate to the Favorites section to view all saved expressions
Click the star icon again to remove from favorites

📊 Progress

Track your learning progress with detailed statistics. See how many expressions you've learned, your favorite categories, and your overall progress.

What you'll see:

Total expressions learned
Progress percentage
Category breakdown
Learning streaks and achievements

Tips for Effective Learning

Practice regularly: Consistent daily practice is more effective than occasional long sessions
Use flashcards: Review expressions multiple times using the flashcard feature to reinforce memory
Take quizzes: Test yourself regularly to identify areas that need more practice
Save favorites: Mark difficult or important expressions as favorites for focused review
Review progress: Check your progress regularly to stay motivated and track your improvement
Use examples: Pay attention to example sentences to understand context and usage

Keyboard Shortcuts

For faster navigation, you can use keyboard shortcuts (when available):

Space or Enter: Flip flashcard or submit quiz answer
Arrow Left/Right: Navigate between flashcards
Escape: Close modals or return to previous view

Data Storage

Your learning progress, favorites, and learned expressions are stored locally in your browser. This means:

Your data is private and stored on your device
Progress is saved automatically
If you clear your browser data, your progress will be reset
Progress is specific to each browser and device

Text-to-Speech

The app supports text-to-speech functionality to help you learn pronunciation. When available, you can click the speaker icon to hear the expression pronounced. This feature uses your browser's built-in speech synthesis or the Puter.js API when available.

Troubleshooting

Expressions not loading

If expressions are not loading, try refreshing the page. Make sure you have a stable internet connection if the app is loading data from a server.

Progress not saving

Ensure that your browser allows local storage. Check your browser settings and make sure cookies and site data are enabled for this application.

Text-to-speech not working

Text-to-speech requires browser support. If it's not working, try using a modern browser like Chrome, Firefox, or Edge. Some browsers may require user interaction before allowing speech synthesis.

Support

If you encounter any issues or have questions about using the app, please refer to this documentation or check the README file in the project repository for technical details.

For the best experience, we recommend using a modern web browser with JavaScript enabled. The app is designed to work on both desktop and mobile devices.