# Values Compass

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

Package name: `com.valuesort.app`

## Practice flow

1. Welcome (+ how-it-works guide)
2. Sort each value into five reflective piles
3. Review piles and reorder cards as needed
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 → hub → overview / rank / reflect
├── services/storage_service.dart
├── utils/
└── widgets/
assets/
├── data/values_deck.json
└── images/emblem.png / app_icon.png
stitch/               # exported Stitch HTML/PNG design references
```

## Run

```bash
flutter pub get
flutter run
```

Useful extras:

```bash
flutter analyze
flutter test
```