Summary

This project provides a web-based phonics learning tool for English beginners and educators. It systematically teaches over 100 phonics rules, improving reading and spelling skills. The application offers a progressive learning path, interactive features, and AI-powered tools for vocabulary expansion, making phonics acquisition accessible and personalized.

How It Works

The tool employs a structured approach, categorizing phonics rules into 16 distinct groups, progressing from basic letters to complex syllable types. Each word features a phoneme breakdown with color-highlighted core sounds. High-quality audio is generated via Google Cloud TTS. An AI-driven "Workshop" mode allows for vocabulary generation and TTS audio creation, with customizable prompts enabling personalized learning. The application is built as a Progressive Web App (PWA) for offline access and easy installation.

Quick Start & Requirements

Clone the repository and use npx serve . for a basic preview. For AI Workshop features, run npm install then npm run studio. Prerequisites include Node.js and its package manager. Configuration for Google Cloud TTS (via ADC or service account) and API keys for AI services (Gemini, OpenAI, Claude, DeepSeek, or local Ollama) are necessary. Audio files are not included and must be generated.

Highlighted Details

• Comprehensive coverage of 100+ phonics rules across 16 scientific categories.
• AI-powered vocabulary generation and TTS tools integrated into a "Workshop" mode.
• Progressive learning path with phoneme breakdown and color-highlighted sounds.
• PWA support for offline access and mobile installation.
• Flashcard mode for focused, single-word study.

Maintenance & Community

The project welcomes contributions via Issues and Pull Requests. It is licensed under the MIT License, permissive for most uses. Specific details on active maintenance, core contributors, or dedicated community channels beyond GitHub are not detailed.

Licensing & Compatibility

The project is released under the MIT License. This license is highly permissive, allowing commercial use, modification, distribution, and private use without significant restrictions, making it compatible with closed-source projects.

Limitations & Caveats

Audio assets are not bundled and require separate generation. Full utilization of AI features necessitates configuration of external API keys or local AI model setups. Advanced functionalities depend on these external service integrations.