Sanctification/sanctification-tcg/flutter-scene-spike/README.md

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:

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:

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:

$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:

& $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

& $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\.