JSPM

  • Created
  • Published
  • Downloads 132
  • Score
    100M100P100Q101716F
  • License MIT

TARL - Three component reading assistant library (Repeter, Lire, Ecrire)

Package Exports

  • @lelbakna/tarl
  • @lelbakna/tarl/dist/tarl.css
  • @lelbakna/tarl/styles

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 dev

Project 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