We are excited to have you tinker on [the Impeller Scene Demo presented at Flutter Forward](https://www.youtube.com/live/zKQYGKAe5W8?feature=share&t=7048). While we spend time learning the use-cases and finalizing the API, the functionality for Impeller Scene is behind a compile-time flag. During this time, there are no guarantees around API stability.

**Compiling the Engine**

- Configure your Mac host to compile the Flutter Engine by [following the guidance in wiki](https://github.com/flutter/flutter/wiki/Setting-up-the-Engine-development-environment).
- Ensure that you are on the [main branch of the Flutter Engine](https://github.com/flutter/engine/tree/main).
- Ensure that you are on the [main branch of the Flutter Framework](https://github.com/flutter/flutter/tree/main).
- Configure the host build: `./flutter/tools/gn --enable-impeller-3d --no-lto`
- Configure the iOS build: `./flutter/tools/gn --enable-impeller-3d --no-lto --ios`
  - Add the `--simulator  --simulator-cpu=arm64` flag to the iOS build if you are going to test on the simulator.
- Build host artifacts (this will take a while): `ninja -C out/host_debug`
- Build iOS artifacts (this will take a while): `ninja -C out/ios_debug`
  - If targeting the simulator: `ninja -C out/ios_debug_sim_arm64`
- Clone the demo repository: `git clone https://github.com/bdero/flutter-scene-example.git` and move into the directory.
- Plug in your device or open `Simulator.app`, then run `flutter devices` to note the device identifier.
- Run the demo application: `flutter run -d [device_id] --local-engine ios_debug --local-engine-host host_debug` (or `ios_debug_sim_arm64` if you are running on the Simulator).
  - On Silicon Macs, prefer `--local-engine-host host_debug_arm64` (adjusting your `ninja` command above accordingly)

We hope to continue evolving the API and have it available on the stable channel soon!