MORE RE-ORGANIZING

spikes/flutter-scene-spike/README.md

@@ -0,0 +1,66 @@
+# Flutter Scene Card Spike
+
+Bounded comparison of Flutter Scene against the approved Three.js
+`runtime-look-v4-2026-09-07` card renderer.
+
+## Pinned toolchain
+
+- Flutter 3.47.2 stable
+- Dart 3.13.2
+- `flutter_scene` 0.23.0
+
+The Flutter SDK used during the spike is installed at:
+
+```text
+C:\Users\dakovale\development\flutter
+```
+
+## Scope
+
+- Procedural rounded card geometry
+- David Paper + Holographic baseline
+- Reveal-safe universal back
+- Front, Grazing, Edge, and Back poses
+- One-finger rotation, pinch zoom, flip, reset, and sweep
+- Web execution over the local network
+
+The full Three.js laboratory is intentionally not being duplicated.
+
+## Run
+
+The validated release build can be served to the local network with:
+
+```powershell
+python -m http.server 5180 --bind 0.0.0.0 --directory build\web
+```
+
+Open `http://10.0.0.193:5180/` from the current network.
+
+For Flutter debug iteration:
+
+```powershell
+$flutter = "$HOME\development\flutter\bin\flutter.bat"
+& $flutter run -d web-server --web-hostname 0.0.0.0 --web-port 5180
+```
+
+For a native target after its platform tooling is installed:
+
+```powershell
+& $flutter run --enable-flutter-gpu
+```
+
+Android-native validation is currently blocked because this machine does not
+have Java, the Android SDK, or `adb` installed. The web comparison does not
+depend on that tooling.
+
+## Validate
+
+```powershell
+& $flutter analyze
+& $flutter test
+& $flutter build web
+```
+
+Source assets in `assets\` are immutable copies of the approved Three.js
+fixture. Scene's initialized build hook compiles loose textures and `.fmat`
+materials into `flutter_scene_generated\`.