49 lines
1.0 KiB
Markdown
49 lines
1.0 KiB
Markdown
# 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
|
|
```
|