A spaced-repetition flashcard app for learning Armenian vocabulary. Study anywhere with full offline support—no internet required. Tested on iPhone (physical device).

Offline-first architecture: All data persists locally in SQLite. Fully functional without internet.

lib/
├── core/
│   ├── constants.dart          # GradeConfig, AppColors, asset paths
│   └── utils/
│       ├── hash.dart           # SHA-256 externalRowId
│       └── slug.dart           # URL-safe deck slugs
├── domain/srs/
│   ├── fsrs.dart               # FSRS scheduler (SM-2 variant, pure Dart)
│   └── mastery.dart            # Bidirectional mastery gate
├── data/
│   ├── database/app_database.dart   # SQLite singleton, DDL, migrations
│   ├── models/                      # deck, card, card_state, review_log
│   ├── repositories/               # deck, card, card_state, review_log
│   └── csv/
│       ├── csv_parser.dart     # 7-col / 8-col Armenian Anki CSV
│       └── csv_exporter.dart   # Export to 8-col CSV
├── presentation/
│   ├── providers/              # Riverpod: deck, card, study
│   ├── screens/                # home, study, deck_detail, settings
│   └── widgets/                # flashcard, grade_buttons, deck_list_tile
├── services/
│   ├── sample_deck_service.dart   # Idempotent Hayeren 1 installer
│   └── backup_service.dart        # Phase 2: Google Drive backup/restore
├── app.dart                    # MaterialApp, Material 3 theme
└── main.dart                   # ProviderScope entry point

State management: flutter_riverpod — AsyncNotifier + FamilyAsyncNotifier
Persistence: sqflite + path_provider, versioned migrations
SRS: Direct Dart port of fsrs.ts + mastery.ts from the Next.js repo

cd armenian_anki_flutter
flutter pub get

cd ios && pod install && cd ..
open ios/Runner.xcworkspace

In Xcode:

1. Select the Runner target → Signing & Capabilities
2. Set Team to your Personal Team (free Apple ID is sufficient for simulator/device)
3. Change Bundle Identifier to something unique, e.g. com.yourname.armenianAnki
4. Close Xcode, then:

flutter run                  # simulator or connected device
flutter build ipa            # release IPA (paid account required for distribution)

flutter emulators                        # list available emulators
flutter emulators --launch <emulator_id> # start one
flutter run                              # hot-reload debug run
flutter build apk --release              # release APK
flutter build appbundle --release        # App Bundle for Play Store

Release APK is written to build/app/outputs/flutter-apk/app-release.apk.

flutter test

Armenian Script | Translit. | English Meaning | Example Sentence + [Translation] | Grammar | Cheat Phrase | Topic

Difficulty | Armenian Script | Translit. | English Meaning | Example Sentence + [Translation] | Grammar | Cheat Phrase | Topic

Example sentence cell format: Armenian sentence. - [English Translation]

A sample file is bundled at assets/samples/hayeren1.csv and can be installed from Settings → Install Hayeren 1 Deck.

Ease factor is clamped to [1.3, 2.5]. A card is mastered when both forward (Armenian → English) and reverse (English → Armenian) have been answered correctly (grade ≥ 1) at least once.

Implemented in lib/services/backup_service.dart, surfaced in Settings → Google Drive Backup.
The core app works fully offline; signing in is optional.

1. Enable the Google Drive API.
2. Create OAuth 2.0 Client IDs for iOS and Android.
3. iOS: Download GoogleService-Info.plist, add to the Xcode Runner target, and add the reversed client ID to Info.plist URL schemes.
4. Android: Download google-services.json, place in android/app/, and apply the com.google.gms.google-services Gradle plugin.

Backup stores all four tables (decks, cards, card_states, review_logs) as a single JSON file in the Drive appDataFolder (hidden from the user's Drive UI).