@lelbakna/reading-assistant
v3.0.33
Published
Reading Assistant Library - Two Main Components (ActivityViewer, DictationActivity) with scoped CSS
Maintainers
Readme
ReadRight - Reading Assistant Platform
ReadRight is an interactive reading assistant platform designed to help students improve their reading and pronunciation skills. Inspired by language learning apps like Duolingo, ReadRight provides a gamified experience for practicing reading aloud with real-time feedback.
Features
- Interactive Reading Practice: Students can read texts aloud and receive feedback on their pronunciation
- Progressive Learning: If a student makes mistakes, they get multiple attempts with guidance
- Audio Guidance: After three attempts, the platform provides audio guidance for correct pronunciation
- Modern UI/UX: Clean, intuitive interface with gamification elements
- Progress Tracking: Track reading progress, streaks, and points
- Categorized Content: Various reading materials organized by difficulty level and category
Tech Stack
- React (v19)
- Tailwind CSS for styling
- React Speech Recognition for voice input (simulated in current version)
Getting Started
Prerequisites
- Node.js (v18 or higher)
- npm or yarn
Installation
# Install dependencies
npm install
# Start the development server
npm run devProject Structure
/src/components- React components/src/data- Mock data for texts and exercises/src/assets- Images and other static assets
Current Limitations
This is a prototype version with the following limitations:
- Speech recognition is simulated (not using actual Web Speech API)
- Audio playback for guidance is mocked
- Limited set of reading materials
Future Enhancements
- Implement real speech recognition using Web Speech API
- Add user authentication and profiles
- Expand content library with more reading materials
- Add analytics dashboard for teachers/parents
- Mobile app version
