osmanclan1/somali-learning-app

# Somali Learning Web App A simple and effective web-based platform designed to help learners acquire Somali vocabulary, grammar, and sentence structure. The app focuses on interactive exercises and progress tracking, using local storage to keep user progress without requiring an external database. ## Features - **Vocabulary Builder**: Learn Somali words with example sentences - **Grammar Lessons**: Simple explanations of Somali grammar with interactive exercises - **Sentence Formation**: Fill-in-the-blank and drag-and-drop exercises - **Multiple-Choice Quizzes**: Reinforce learning with question-answer exercises - **Flashcards**: Help memorize words with spaced repetition - **Progress Tracking**: XP, levels, streaks, and achievements - **Local Storage**: All user data is saved in the browser's local storage ## Getting Started ### Prerequisites - Node.js (v14 or higher) - npm (v6 or higher) ### Installation 1. Clone the repository: ``` git clone github.com cd somali-learning-app ``` 2. Install dependencies: ``` npm install ``` 3. Start the development server: ``` npm start ``` 4. Open your browser and navigate to `localhost` ## Usage ### Learning Modes - **Guided Mode**: Follow structured lessons for beginners and advanced learners - **Practice Mode**: Review with randomized exercises - **Flashcard Mode**: Memorize words with spaced repetition ### Progress Tracking - **Daily Streaks**: Maintain a streak by using the app daily - **XP & Leveling**: Earn points for completing lessons and exercises - **Achievements**: Unlock badges for reaching milestones ## Project Structure ``` somali-learning-app/ ├── public/ │ ├── index.html │ └── ... ├── src/ │ ├── components/ │ │ ├── Home.tsx │ │ ├── VocabularyBuilder.tsx │ │ ├── GrammarLessons.tsx │ │ ├── SentenceFormation.tsx │ │ ├── Quizzes.tsx │ │ ├── Flashcards.tsx │ │ └── ... │ ├── data/ │ │ ├── vocabularyData.t …