flutter-wonderous-app

# Wonderous
<p align="center">
<img width="215" src="https://user-images.githubusercontent.com/736973/187334196-b79e48b2-dbb8-4ea7-8aac-04dbc7e5159f.png#gh-dark-mode-only">
<img width="215" src="https://user-images.githubusercontent.com/736973/187334195-9821c031-a566-4f8e-b4e3-3158f733c6e5.png#gh-light-mode-only">
</p>
<p align="center">
 <img width="800" alt="wonderous-banner-800w" src="https://user-images.githubusercontent.com/736973/187334170-d05271e9-d016-4498-8065-662c6f1124fa.png">
</p>

Navigate the intersection of history, art, and culture. Wonderous will educate and entertain as you uncover information about some of the most famous structures in the world. 

Built by [gskinner](https://gskinner.com/) in partnership with the Flutter team, Wonderous deliberately pushes visual fidelity, effects and transitions to showcase what Flutter is truly capable of on modern mobile hardware.

In addition to forking and reviewing the [MIT licensed](LICENSE) code available here, you can check out more information on the [Wonderous Showcase Website](https://wonderous.app).

# App Downloads

To try the app you can download it from your favorite app store:
* [Google Play](https://play.google.com/store/apps/details?id=com.gskinner.flutter.wonders)
* [Apple App Store](https://apps.apple.com/us/app/wonderous/id1612491897)

Or you can try it on the web at https://wonderous.app/web/

# Installation

If you're new to Flutter the first thing you'll need is to follow the [setup instructions](https://flutter.dev/docs/get-started/install).

Once Flutter is setup, you can use the latest `stable` channel:
 * `flutter channel stable`
 * `flutter upgrade`

 Once on `stable` you're ready to run the app on your local device or simulator:
 * `flutter run -d ios`
 * `flutter run -d android`

### WASM

[Wonderous](https://wonderous.app/web/) is deployed using the Web Assembly target for Flutter Web (WASM). To test WASM locally you can use the command `flutter run -d chrome --wasm`.

#### Web query parameters

The web bootstrap in `web/index.html` supports a small set of URL query parameters:

* `wasm=1` or `wasm=true`: Opt in to WASM allowlisting for Safari (WebKit) and Firefox (Gecko).
	* By default, Safari/Firefox are not allowlisted.
	* Chromium browsers (for example, Chrome) continue using the default Flutter behavior.
* `mode=canvaskit`: Force the CanvasKit renderer.
* `mode=wimp`: Enable WIMP mode.
* `mode=skwasm-st`: Force single-threaded SKWASM.

Examples:

* `/?wasm=1`
* `/?wasm=1&mode=canvaskit`
* `/?wasm=true&mode=skwasm-st`

### Impeller Rendering

This app uses the new [Impeller Runtime](https://docs.flutter.dev/perf/impeller) by default on iOS.

# About gskinner
We build innovative digital experiences for smart clients, and we love how Flutter unleashes our creativity when building multi-platform apps. Don't hesitate to [stop by our site](https://gskinner.com/) to learn more about what we do, or check out other [innovative Flutter projects](https://flutter.gski