v1.3.0

Adds a master switch to turn the custom splash on or off.

Added

• enabled flag (MOBILE_SPLASHSCREEN_ENABLED, default true). Set it to false to turn the custom splash off entirely — the plugin reverts its native changes on both iOS and Android and the app falls back to NativePHP's default splash. Toggling it back on restores the custom splash. launch_color is still applied to the native launch screen when set, so that flash can match your brand even with the splash disabled.

Full Changelog: v1.2.3...v1.3.0

v1.2.3

Fixes the Android build for solid-color splash backgrounds.

Fixed

• Android failed to compile (Modifier.background: none of the candidates is applicable) when the background was a solid color — the generated background block mixed a Brush with a bare Color. Solid colors are now wrapped in SolidColor so the block is a consistent Brush. Gradient backgrounds were unaffected.

Full Changelog: v1.2.2...v1.2.3

v1.2.2

Fixes the iOS build for everyone — completes the Lottie dependency fix from v1.2.1.

Fixed

• The iOS build failed to link Lottie (Missing package product) because the Swift package's product name wasn't specified, so it was guessed from the URL. The lottie-spm library product (Lottie) is now declared explicitly so it links correctly on a clean install.

Full Changelog: v1.2.1...v1.2.2

v1.2.1

Fixes iOS clean builds failing with Unable to find module dependency: 'Lottie'.

Fixed

• The lottie-spm Swift package was never declared, so iOS builds only succeeded when Lottie already happened to be present in the Xcode project. It is now declared in nativephp.json and added on every build.

Full Changelog: v1.2.0...v1.2.1

v1.2.0

This release adds right-to-left progress bars, recurring seasonal schedule dates, and declares the supported minimum platform versions.

Added

• Progress bar fill direction — set ltr (default, fills left→right) or rtl (fills right→left) via the new MOBILE_SPLASHSCREEN_PROGRESS_BAR_DIRECTION env variable / progress_bar.direction config key. Overridable per entry in both the static and dynamic schedules, and validated by MobileSplashscreen::validate().
• Recurring schedule dates — schedule entries now accept MM-DD (recurs every year) in addition to YYYY-MM-DD (specific year). When a full-date entry and a recurring entry both match the same day, the full date takes precedence. Works for both static (build-time) and dynamic (remote) schedules.
• Minimum platform versions declared in nativephp.json — Android 26 (Android 8) and iOS 18.0, matching the NativePHP v3 supported range.

Changed

• Plugin registration docs now lead with the php artisan native:plugin:register command (manual NativeServiceProvider editing kept as an alternative).

Fixed

• Dynamic remote schedule now passes through progress_bar and progress_bar_color per-entry overrides — previously documented as supported but dropped during sync.
• Static schedule MM-DD dates were documented but never matched (the on-device matcher compared them against a full YYYY-MM-DD date); recurring dates now work as intended.

Full Changelog: v1.1.0...v1.2.0

v1.1.0

This release bundles 8 free, ready-to-use Lottie example animations so you can get a splash screen running in seconds.

Added

• 8 bundled, free Lottie example animations in resources/animations/, sourced from LottieFiles with full author attribution
• New mobile-splashscreen-examples publish tag — run php artisan vendor:publish --tag=mobile-splashscreen-examples to copy the example animations into your app's resources/animations/
• "Bundled Example Animations" section in the README, including a credits table linking each animation to its original author and LottieFiles source

Changed

• Removed the hardcoded version field from composer.json — the git tag is now the single source of truth for the package version

Full Changelog: v1.0.0...v1.1.0

v1.0.0

First public release of the NativePHP Mobile Splashscreen plugin — a fully config-driven splash screen for iOS and Android NativePHP apps, with no manual native code editing required.

Features

Content

• Lottie animation support (.lottie v2 → v1 automatic conversion)
• Text-only splash screens as an alternative to animations
• Single-play and looping animation modes

Visual

• Solid color and gradient backgrounds (vertical, horizontal, diagonal)
• Dark mode support with separate animations and background config, or follows system automatically
• App icon overlay with configurable size, position and corner radius
• Progress bar for loading indication

Exit Transitions

• fade, scale_up, scale_down, slide_up, slide_down, circle_expand, none
• Configurable duration, delay before and after, and origin point (8 positions for circle_expand)

Scheduling

• Build-time static schedule for seasonal splash screens (Christmas, New Year, etc.)
• Dynamic runtime schedule — download new animations and config remotely without releasing a new build
• Automatic cleanup of stale scheduled files

Events

• SplashscreenCompleted — fired when the splash finishes
• SplashscreenLoopCompleted — fired on each animation loop iteration

Platform integration

• Syncs the OS-level launch color to LaunchScreen.storyboard (iOS) and themes.xml (Android)
• Hooks into NativePHP's copy_assets and pre_compile stages — no Xcode or Android Studio changes needed

Full Changelog: https://github.com/S2BR/nativephp-mobile-splashscreen/commits/v1.0.0