Samuel-Kaniel/tigrinya-guide

A Flutter application for learning the Tigrinya alphabet # Tigrinya Guide A Flutter mobile and web application for learning the Tigrinya alphabet with pronunciation guides, examples, and interactive quizzes. ## Features - **Alphabet Learning**: Browse through all Tigrinya letters with pronunciations - **Practice Mode**: Flashcard-style practice with show/hide answers - **Interactive Quiz**: Test your knowledge with multiple-choice questions - **Progress Tracking**: Track your learning progress locally - **Cloud Sync**: Synchronize data with AWS backend - **Cross-Platform**: Works on iOS, Android, and Web ## Screenshots The app includes: - Home screen with navigation to different learning modes - Alphabet grid view with letter details - Practice flashcards with pronunciation and examples - Quiz system with scoring and progress tracking ## Technology Stack ### Frontend - **Flutter**: Cross-platform mobile and web framework - **Dart**: Programming language - **Provider**: State management - **SQLite**: Local database storage - **HTTP**: API communication ### Backend (AWS) - **API Gateway**: REST API endpoints - **Lambda**: Serverless functions (Python) - **DynamoDB**: NoSQL database - **S3**: Static web hosting - **CloudFront**: CDN for global distribution - **CloudFormation**: Infrastructure as Code ## Getting Started ### Prerequisites - Flutter SDK (>=3.10.0) - Dart SDK (>=3.0.0) - AWS CLI configured with appropriate permissions - Python 3.9+ (for Lambda functions) ### Local Development 1. **Clone the repository** ```bash git clone cd flutter_tigrinya_guide ``` 2. **Install dependencies** ```bash flutter pub get ``` 3. **Run the app** ```bash # For mobile development flutter run # For web development flutter run -d chrome ``` ### AWS Deployment 1. **Configure AWS credentials** ```bash aws configure ``` 2. **Deploy infrastructure and app** ```bash chmod +x deploy.sh ./deploy.sh ``` This script will: - Deploy AWS infrastructure using CloudFormation - Build the Flutter web app - Upload to S3 for hosting - …