Mini Word Cards

Chinese documentation: README_zh.md

Mini Word Cards is a lightweight Flutter app for vocabulary learning. It supports CSV dictionary import, fast lookup, and flashcard-based review sessions. It was designed for niche vocabularies that are hard to find or import in mainstream vocabulary apps, while keeping the product compact and focused.

Features

• Flashcard learning UI
• 3D card flip animation (front/back)
• Independent black-mask toggles for word/meaning (button + tap on text)
• Swipe left/right to switch cards
• Two study modes:
  • Free review
  • N cards per session
• Automatic lazy loading for large datasets (>300 words)
• Built-in dictionaries (managed separately from external imports):
  • CET-4 / CET-6
  • TEM-4 (full/core/hot), TEM-8 (full/core/hot)
  • SAT (full)
  • First launch imports default.csv only; other built-in dictionaries can be imported/removed in Dictionary Management
• Local dictionary management:
  • Import CSV
  • Enable/disable dictionaries
  • Export dictionaries
  • Delete dictionaries
• Settings:
  • Theme mode
  • Lazy-load optimization toggle (enabled by default, persisted)

Project Structure

lib/
  data/            bundled dictionary data
  dto/             data transfer objects
  pages/           screens and widgets
  repositories/    repository layer
  services/        database/settings/file services
test/              tests

Environment

• Flutter: 3.x (match your local project SDK)
• Dart: ^3.10.4
• Android build chain: AGP 8.9.1

Quick Start

flutter pub get
flutter run

Common Commands

flutter analyze
flutter test
flutter run -d windows
flutter run -d chrome
flutter build apk --release --target-platform android-arm64

Recommended CSV Fields

• index
• word
• meaning
• abbreviation (optional)

Default Dictionary

• lib/data/default.csv
• Loaded on first launch only
• Intended as a lightweight starter dictionary for quick verification and onboarding

Dictionary Sources

• CET-4/CET-6/SAT vocabularies are sourced from:
  https://github.com/KyleBing/english-vocabulary
• TEM-4/TEM-8 vocabularies are sourced from:
  https://github.com/mikigo/english-chinese-words

Troubleshooting

• Could not acquire the lock to .dart_tool/.../.lock
  • Kill stale dart/flutter processes, remove the lock file, then retry.
• Android AAR metadata / AGP compatibility errors
  • Keep the Android toolchain in this repo (AGP 8.9.1).

Roadmap

We will keep improving software quality and ship practical features while preserving the "small but polished" product direction. PRs and suggestions are welcome.

• v1.0.0 Core features: CSV import, flashcards, dictionary management
• v1.1.0 Built-in dictionaries: support CET-4/6, TEM-4/8, SAT packs with managed import/remove
• v1.2.0 Format expansion: JSON dictionary import
• v1.3.0 Online search: FreeDictionary API integration
• v2.0.0 UI refinement: initial custom themes and UI improvements