# 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\`.