🚀 Product Overview

K-Route is a premium, highly optimized Flutter application specifically crafted for students preparing for the EPS-TOPIK (Korean Language Examination). It tackles the single biggest challenge students face: waking up early and consistently memorizing vocabulary.

Unlike standard alarm apps that users can effortlessly snooze or dismiss, K-Route features an uncompromising "Hard Alarm" system. It forces users to actively recall and type the correct Korean word (Hangeul) matching the morning's vocabulary challenge before the alarm will turn off.

🌟 Key Features

• Gamified Hard Alarm System: Cannot be snoozed or closed via background processes until the exact Korean Hangeul word is correctly typed.
• Self-Healing Background Service: Implemented with robust Android lifecycle observers to guarantee alarm firing even if the OS aggressively clears memory.
• Native Korean Audio (TTS Integration): One-tap high-quality Text-to-Speech pronunciation utilizing native Android engines.
• Smart Chapter Filters & Search: Users can search seamlessly in English or Korean and filter vocabulary lists by exam chapters.
• Modern Android SDK 36 Compliance: Rewritten with dynamic canScheduleExactAlarms() safe fallbacks to ensure smooth execution on Android 14+ without runtime crashes.
• Dynamic JSON Architecture: 100% data-driven! Swap out the centralized JSON file to adapt this app for Japanese (JLPT), German, Spanish, or English in under 5 minutes.

📦 What is Included?

• Cross-Platform Framework: Complete Flutter & Dart Source Code
• Modern Android Compatibility: Android 14+ Ready & Target SDK 36 Compliant
• Advanced Alarm Logic: Gamified Hard Alarm System (Type to dismiss)
• Background Stability: Self-Healing Background Service & Intent Receivers
• Audio Integration: Native Korean Text-to-Speech (TTS) Audio Engine
• Data Management: Smart Chapter Filtering & Dual-Language Search
• Highly Customizable: Dynamic JSON-driven vocabulary structure (Easy to Re-skin)
• Build Configuration: Modern Kotlin DSL Gradle Scripting
• Developer Friendly: Clean, Modular, and Well-Documented Architecture
• Bonus Asset: Premium Dark-Themed Responsive HTML Documentation Included

• Flutter SDK: Version 3.22.x or higher installed on your machine.
• Dart SDK: Version 3.4.x or higher.
• Development IDE: Visual Studio Code (VS Code) or Android Studio with Flutter extensions installed.
• Android Build Tools: Java Development Kit (JDK 17) and Android SDK configured properly.
• Minimum Android OS: Android 5.0 (API Level 21) or higher on physical test devices or emulators.
• Basic Knowledge: Fundamental understanding of Flutter development and the package configuration command (flutter pub get).

1. Extract the Package: Download and extract the purchased .zip file to a preferred location on your computer.
2. Open in IDE: Launch Visual Studio Code or Android Studio, select "Open Folder", and choose the extracted project root directory.
3. Fetch Dependencies: Open your IDE's integrated terminal and run the following command to download all necessary packages:
   flutter pub get
4. Run the Application: Connect a physical Android device (with USB Debugging enabled) or start an emulator, then execute:
   flutter run
5. Review Documentation: For detailed guides on building the release APK and customizing the vocabulary list via the JSON asset structure, please open the pre-packaged Documentation.html file directly in any web browser.