Initial Flutter MVP for bottle-cap mosaic generator

README.md

@@ -0,0 +1,57 @@
+# Korken Mosaic (Flutter MVP)
+
+Prototype Flutter app for generating bottle-cap mosaics from imported images.
+
+## Implemented MVP
+
+- Import target image from gallery (`image_picker`)
+- Resolution controls:
+  - explicit grid width/height
+  - or auto grid by approximate cap size in source image pixels
+- Cap palette management:
+  - list caps with name + color
+  - add color via picker and/or manual hex
+  - remove caps
+- Mosaic generation:
+  - resize source to grid
+  - nearest cap color match using CIELAB + DeltaE (CIE76)
+  - fallback concept is RGB distance, but LAB path is implemented directly
+- Output:
+  - mosaic grid preview
+  - bill of materials counts per cap color
+
+## Current blocker on this machine
+
+`flutter` SDK is not installed (`flutter: command not found`), so I could not run:
+
+- `flutter create`
+- `flutter pub get`
+- `flutter analyze`
+- `flutter build apk --debug`
+
+## Setup commands (Ubuntu/Debian)
+
+```bash
+cd /home/yadciel/.openclaw/workspace
+sudo snap install flutter --classic
+# OR: install manually from flutter.dev and add to PATH
+
+flutter doctor
+
+cd /home/yadciel/.openclaw/workspace/korken_mosaic
+flutter create .
+flutter pub get
+flutter run
+flutter build apk --debug
+```
+
+Expected APK artifact:
+
+`build/app/outputs/flutter-apk/app-debug.apk`
+
+## Project files
+
+- `lib/main.dart` – complete MVP UI + mosaic logic
+- `pubspec.yaml` – dependencies
+- `analysis_options.yaml`
+- `.gitignore`