{"id":21116654,"url":"https://github.com/a-samod/dyslexia-app-v2","last_synced_at":"2026-01-02T02:32:56.226Z","repository":{"id":263488549,"uuid":"889164393","full_name":"A-Samod/dyslexia-app-v2","owner":"A-Samod","description":"Mobile application to support children with dyslexia, focusing on Sinhala language handwriting practice, text-to-speech, and progress tracking.","archived":false,"fork":false,"pushed_at":"2024-11-29T06:54:47.000Z","size":35615,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-21T04:43:17.857Z","etag":null,"topics":["dyslexia","handwriting-recognition","machine-learning","sinhaladyslexia","text-to-speech"],"latest_commit_sha":null,"homepage":"https://www.avishka.tech/projects/sinhala-dyslexia-support-app","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/A-Samod.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-15T18:28:12.000Z","updated_at":"2024-11-29T10:06:30.000Z","dependencies_parsed_at":"2024-11-18T21:07:50.907Z","dependency_job_id":null,"html_url":"https://github.com/A-Samod/dyslexia-app-v2","commit_stats":null,"previous_names":["a-samod/dyslexia-app-v2"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A-Samod%2Fdyslexia-app-v2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A-Samod%2Fdyslexia-app-v2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A-Samod%2Fdyslexia-app-v2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A-Samod%2Fdyslexia-app-v2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/A-Samod","download_url":"https://codeload.github.com/A-Samod/dyslexia-app-v2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243565411,"owners_count":20311701,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dyslexia","handwriting-recognition","machine-learning","sinhaladyslexia","text-to-speech"],"created_at":"2024-11-20T02:32:11.714Z","updated_at":"2026-01-02T02:32:51.209Z","avatar_url":"https://github.com/A-Samod.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dyslexia Learning Assistant for Sinhala Children\n\nThis repository hosts the **Dyslexia Learning Assistant for Sinhala Children**, a mobile app designed to help Sinhala-speaking children with dyslexia improve their writing skills. The app addresses the unique challenges of Sinhala’s complex script through innovative tools like Text-to-Speech (TTS) for pronunciation, machine-learning-powered handwriting recognition, and real-time feedback. Tailored exercises, guided by input from teachers, parents, and specialists, provide a personalized learning experience focused on enhancing writing skills.\n\n---\n\n## Features\n\n- **Authentication**: Secure login and registration with Firebase.\n- **Interactive Exercises**:\n  - Text-to-Speech (TTS) for Sinhala word pronunciation.\n  - Handwriting recognition with real-time feedback.\n  - Sinhala letter and word practice (single letter, two-letter words, three-letter words).\n- **Progress Tracking**: User activity and progress displayed on an interactive dashboard.\n- **Personalized Feedback**:\n  - Mistake identification and corrections.\n  - Suggestions for alternative words.\n- **User-Friendly Interface**: Simple navigation tailored for children and parents.\n\n---\n\n## Tech Stack\n\n- **Mobile Framework**: Flutter\n- **Backend**: Node.js APIs\n- **Database**: MongoDB\n- **Authentication**: Firebase\n- **Machine Learning**: TensorFlow with CNN integration for Sinhala handwriting recognition\n\n---\n\n## Backend Repository\n\nThe mobile app communicates with a dedicated backend server for storing data, processing exercises, and managing user progress.  \nFind the backend repository here: [Dyslexia Backend Repository](https://github.com/A-Samod/dyslexia-app-backend-v2)\n\n---\n\n## Installation and Setup\n### 1. Clone the repositories:\nClone the **frontend (mobile app)** repository:\n```bash\ngit https://github.com/A-Samod/dyslexia-app-v2.git\n```\nClone the backend API repository:\n```bash\ngit https://github.com/A-Samod/dyslexia-app-backend-v2.git\n```\nBackend Repo\n### 2. Set Up the Backend\n\n1. Navigate to the backend directory:\n```bash\ncd dyslexia-backend\n```\n\n2. Install dependencies\n```bash\nnpm install\n```\n3. Set up environment variables\n- Create a .env file in the root directory of the backend project.\n- Add necessary configurations: MongoDB connection string and Firebase credentials.\n\n4. Start the backend server:\n```bash\nnpm start\n```\n\nThe backend should now be running on http://localhost:4000 (or another configured port).\n\n### 3. Set Up the Mobile App (Frontend)\n1. Navigate to the mobile app directory:\n```bash\ncd dyslexia-app-v2\n```\n\n2. Install dependencies\n```bash\nflutter pub get\n```\n\n3. Set up Firebase:\n- Add your Firebase project configuration to the app (e.g., google-services.json for Android and GoogleService-Info.plist for iOS).\n\n4. Ensure the backend is running.\n\n### 4. Run the App\n1. Start the Flutter app:\n```bash\nflutter run\n```\n2. Test connectivity:\n- The app communicates with the backend via the configured APIs.\n- Ensure the backend server and mobile app are running simultaneously for proper functionality.\n---\n## Screenshots\n\n 1. Login \u0026 Register Screen\n\n![Login \u0026 Register Screen](./assets/screenshots/login_screen.png)\n\n2. Home Screen\n\n![Home Screen](./assets/screenshots/home_screen.png)\n\n3. Writing Screen\n\n![Writing Screen](./assets/screenshots/writing_screen.png)\n\n4. Completion Screen\n\n![Completion Screen](./assets/screenshots/completion_screen.png)\n\n5. Profile Screen\n\n![Completion Screen](./assets/screenshots/profile_screen.png)\n\n6. Dashboard Screen\n\n![Dashboard Screen](./assets/screenshots/dashboard_screen.png)\n\n---\n## How It Works\n1. Login or Register: Users (parents or children) can log in or register for an account.\n2. Home Screen: Navigate through the app features and start exercises.\n3. Writing Exercise: \n    - Listen to a word via TTS. \n    - Write the word directly on the mobile screen.\n    - Receive real-time feedback on mistakes.\n4. Completion Screen: View success messages and suggestions after completing a session.\n5. Dashboard: Track performance, time spent, and progress over time.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-samod%2Fdyslexia-app-v2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa-samod%2Fdyslexia-app-v2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-samod%2Fdyslexia-app-v2/lists"}