docs: update example app README with setup instructions

- Add prerequisites section (Flutter SDK, Xcode, CocoaPods, iOS 13.0+)
- Add step-by-step setup instructions for Flutter installation
- Add iOS dependencies installation steps
- Document configuration changes (iOS deployment target update)
- Add troubleshooting section for common issues
- Include instructions for running on iOS simulator and device

Author: denischilik

example/README.md

@@ -2,15 +2,81 @@
 
 Demonstrates how to use the mparticle_flutter_sdk plugin.
 
-## Getting Started
+## Prerequisites
 
-This project is a starting point for a Flutter application.
+- Flutter SDK (stable channel)
+- Xcode 16.4 or later (for iOS development)
+- CocoaPods
+- iOS 13.0+ (minimum deployment target)
 
-A few resources to get you started if this is your first Flutter project:
+## Setup
+
+### 1. Install Flutter
+
+If Flutter is not installed, follow these steps:
+
+```bash
+# Clone Flutter SDK to your home directory
+cd ~
+git clone https://github.com/flutter/flutter.git -b stable
+
+# Add Flutter to your PATH in ~/.zshrc
+echo 'export PATH="$HOME/flutter/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+
+# Verify installation
+flutter doctor
+```
+
+### 2. Install Dependencies
+
+```bash
+# From the example directory
+cd example
+
+# Get Flutter packages
+flutter pub get
+
+# Precache iOS artifacts (first time only)
+flutter precache --ios
+```
+
+### 3. Install iOS Dependencies
+
+```bash
+# Install CocoaPods dependencies
+cd ios
+pod install
+cd ..
+```
+
+**Note:** The Podfile has been configured with iOS 13.0 as the minimum deployment target to ensure compatibility with Flutter and mParticle dependencies.
+
+## Running the App
+
+### iOS Simulator
+
+```bash
+# List available devices
+flutter devices
+
+# Run on iOS simulator
+flutter run -d <device-id>
+
+# Or simply
+flutter run
+```
+
+### iOS Device
+
+```bash
+# Connect your iOS device and ensure it's in Developer Mode
+flutter run -d <your-device-name>
+```
+
+## Resources
 
 - [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
 - [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
-
-For help getting started with Flutter, view our
-[online documentation](https://flutter.dev/docs), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+- [Flutter Documentation](https://flutter.dev/docs)
+- [mParticle Documentation](https://docs.mparticle.com/)