docs: Update example app with comprehensive configuration showcasing all parameters

[Copilot]

Description

The example app demonstrated only basic configuration, making it unclear how to use all available parameters—particularly for dark mode, background images, and Android 12+ settings.

Changes

example/pubspec.yaml

• Expanded from 4 parameters to complete configuration demonstrating all 13 supported parameters
• Added inline comments explaining each parameter's purpose and available options
• Organized into logical sections: Light Mode, Background Images, Android Dark Mode, Android 12+

example/README.md

• Replaced boilerplate with comprehensive documentation
• Added platform-specific guidance (iOS content_mode vs Android gravity)
• Included testing instructions for dark mode
• Clarified iOS dark mode parameters (image_dark_ios, ios_dark_content_mode, color_dark_ios) are not currently implemented

doc/documentation.md

• Restructured configuration example with descriptive section headers
• Added note distinguishing between required and optional parameters
• Clarified Android-only dark mode support

Assets

• Added placeholder images for dark mode, Android 12+, and background configurations

Configuration Example

splash_master:
  # Light mode
  color: '#FFFFFF'
  image: 'assets/splash.png'
  ios_content_mode: 'center'
  android_gravity: 'center'
  
  # Background
  background_image: 'assets/background.png'
  ios_background_content_mode: 'scaleToFill'
  android_background_image_gravity: 'fill'
  
  # Android dark mode
  image_dark_android: 'assets/splash_dark.png'
  android_dark_gravity_key: 'center'
  color_dark_android: '#000000'
  
  # Android 12+
  android_12_and_above:
    color: '#FFFFFF'
    image: 'assets/splash_12.png'
    branding_image: 'assets/branding.png'

Checklist

• The title of my PR starts with a Conventional Commit prefix (fix:, feat:, docs: etc).
• I have followed the Contributor Guide when preparing my PR.
• I have updated/added tests for ALL new/updated/fixed functionality.
• I have updated/added relevant documentation in docs and added dartdoc comments with ///.
• I have updated/added relevant examples in examples or docs.

Breaking Change?

• Yes, this PR is a breaking change.
• No, this PR is not a breaking change.

Related Issues

Closes #[issue_number]

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://storage.googleapis.com/flutter_infra_release/flutter/13e658725ddaa270601426d1485636157e38c34c/dart-sdk-linux-x64.zip
  • Triggering command: /update-job-proxy /update-job-proxy (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Update example app showcasing light and dark mode support</issue_title>
<issue_description>Is your feature request related to a problem? Please describe.
The current example app does not demonstrate how to use the full set of configuration parameters available in splash_master, especially for light/dark mode, iOS vs Android differences, and Android 12+ specific settings. This makes it harder for developers to understand how to configure every supported option properly.

Describe the solution you'd like
Please update the example app (or documentation) with a complete configuration that showcases all available parameters, including:

splash_master:
  # Light mode — Common
  color: '#FFFFFF'
  image: 'assets/splash.png'

  # iOS Light mode image behavior
  ios_content_mode: 'center'

  # Android Light mode image behavior
  android_gravity: 'center'

  # Background image
  background_image: 'assets/background_image.png'
  ios_background_content_mode: 'scaleToFill'
  android_background_image_gravity: 'fill'

  # ===== Android Dark Mode =====
  image_dark_android: 'assets/splash_dark.png'
  android_dark_gravity_key: 'center'
  color_dark_android: '#000000'

  # ===== iOS Dark Mode =====
  image_dark_ios: 'assets/splash_dark.png'
  ios_dark_content_mode: 'center'
  color_dark_ios: '#000000'

  # ===== Android 12+ Configuration =====
  android_12_and_above:
    color: '#FFFFFF'
    image: 'assets/splash_12.png'
    branding_image: 'assets/branding_image.png'

What this example should demonstrate

• Light & dark mode splash screens on both Android and iOS
• Usage of separate dark-mode assets for each platform
• Background image configuration
• Differences between gravity (Android) and content_mode (iOS)
• Complete Android 12+ behavior, including custom icon and branding image

Additional Context

A comprehensive example will help developers understand platform-specific behaviors and avoid misconfiguration issues—especially for Android dark mode, iOS appearance-based image switching, and the Android 12+ splash icon changes.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Update example app showcasing light and dark mode support #78

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.