valuecards/README.md

Values Sort

Flutter Android app for a guided personal-values card-sort practice. Built with Flutter 3.47 (Dart 3.13), Material 3, Provider, and local persistence.

Package name: com.example.myapp

Practice flow

1. Welcome (+ how-it-works guide)
2. Sort each value into five reflective piles
3. Review / refine piles
4. Rank your most important values
5. Reflect with journal prompts

Progress (stage, piles, ranking, reflections) is saved on device with shared_preferences.

Folder structure

lib/
├── main.dart
├── data/values_deck.dart
├── models/
├── providers/
├── screens/          # welcome → sort → overview → rank → reflect
├── services/storage_service.dart
├── utils/
└── widgets/
assets/
├── data/values_deck.json
└── images/emblem.png
stitch/               # exported Stitch HTML/PNG design references

Run

flutter pub get
flutter run

Useful extras:

flutter analyze
flutter test