Skip to main content

Wonderous Documentation

Explore the world’s most famous structures through a stunning Flutter showcase app that pushes the boundaries of visual fidelity and mobile performance.

Get StartedExplore Architecture

Quick Start

Get Wonderous running on your device in just a few minutes.

1

Install Flutter

Ensure you have Flutter installed and set up. Wonderous requires Flutter 3.32.0 or later.
flutter --version

Flutter 3.32.0 • channel stable
2

Clone the repository

Clone the Wonderous repository from GitHub.
git clone https://github.com/gskinnerTeam/flutter-wonderous-app.git
cd flutter-wonderous-app
3

Get dependencies

Install all required dependencies using Flutter’s package manager.
flutter pub get
4

Run the app

Launch Wonderous on your preferred device or simulator.
# For iOS
flutter run -d ios

# For Android
flutter run -d android

# For Web (WASM)
flutter run -d chrome --wasm
The app uses Impeller rendering by default on iOS for enhanced performance.

Explore by Feature

Discover the rich features that make Wonderous a showcase of Flutter’s capabilities.

8 World Wonders

Explore interactive experiences for the Great Wall, Petra, Colosseum, Chichen Itza, Machu Picchu, Taj Mahal, Christ the Redeemer, and the Pyramids of Giza.

Historical Timeline

Navigate through 5,000 years of history with events spanning from 3000 BCE to present day.

Artifact Search

Search and explore thousands of artifacts powered by the Metropolitan Museum of Art API.

Photo Galleries

Browse stunning photography from Unsplash integrated seamlessly into each wonder’s experience.

Collectibles System

Track progress and discover hidden collectibles as you explore each wonder.

Multi-language Support

Experience Wonderous in English or Chinese with full localization support.

Architecture Deep Dive

Learn how Wonderous is architected to deliver exceptional performance and visual quality.

Project Structure

Understand the organization of code, assets, and resources.

State Management

Learn how Wonderous manages state using GetIt and Provider patterns.

Routing System

Explore the GoRouter-based navigation with deep linking support.

Data Models

Discover the data structures powering wonders, artifacts, and collectibles.

UI Components

Build with reusable widgets and custom illustrations.

Performance

Optimize rendering with Impeller and advanced Flutter techniques.

API Reference

Complete reference documentation for all logic classes, data models, and UI components.

Logic Classes

AppLogic, WondersLogic, TimelineLogic, CollectiblesLogic, and more.

Data Models

WonderData, ArtifactData, CollectibleData, and TimelineData structures.

UI Components

Screens, common widgets, and wonder illustrations.

Integrations

Unsplash, Google Maps, and Metropolitan Museum API integrations.

Ready to explore?

Start building with Wonderous today and discover what Flutter can do.

Get Started Now