atum/nativephp-loader

A NativePHP Mobile plugin for an animated loading screen

Maintainers

Package info

github.com/pteal79/nativephp-loader

Type:nativephp-plugin

pkg:composer/atum/nativephp-loader

Statistics

Installs: 20

Dependents: 0

Suggesters: 0

Stars: 0

Security

Advisories: 0

Aikido package health analysis

1.0.1 2026-02-21 15:04 UTC

Requires

  • php: ^8.2

Requires (Dev)

MIT 7d24b683ee85433fc9263d581f0f39f56bd39448

  • Atum Ventures Ltd <software.woop@atumsoft.co.uk>

This package is auto-updated.

Last update: 2026-03-23 14:27:29 UTC

README

A NativePHP Mobile plugin that provides beautiful Lottie animated loading screens for iOS and Android apps.

Give your users something delightful to look at while your app loads. This plugin replaces the default static splash screen with smooth, eye-catching Lottie animations that work seamlessly on both platforms.

Choose from the bundled animations or bring your own — just drop in a .lottie file and configure the colors to match your brand.

Installation

composer require atum/nativephp-loader

Publishing Assets

Publish the demo animations and config to your Laravel app:

# Publish everything (recommended)
php artisan vendor:publish --tag=nativephp-loader

# Or publish separately
php artisan vendor:publish --tag=nativephp-loader-config
php artisan vendor:publish --tag=nativephp-loader-animations

Example Animations

This plugin includes demo animations:

Demo Meditation Native
demo.lottie meditation.lottie native.lottie
#23b9d6 #1E40AF #1a2332

Configuration

Configuration can be controlled via environment variables or by publishing the config file.

Environment Variables

Example configurations:

# Demo animation (teal theme)
LOADER_ANIMATION_PATH="resources/animations/demo.lottie"
LOADER_BACKGROUND_COLOR="#23b9d6"

# Meditation animation (blue theme)
LOADER_ANIMATION_PATH="resources/animations/meditation.lottie"
LOADER_BACKGROUND_COLOR="#1E40AF"

# Native animation (dark theme)
LOADER_ANIMATION_PATH="resources/animations/native.lottie"
LOADER_BACKGROUND_COLOR="#1a2332"

# Common settings
LOADER_SIZE="0.6"
LOADER_POSITION="center"
LOADER_FADE_IN_DURATION="900"

Custom Animations

You can use your own Lottie animations by:

  1. Placing your .lottie file in resources/animations/
  2. Setting the path in your .env:
LOADER_ANIMATION_PATH=resources/animations/my-custom-animation.lottie

Demo Animations License

The demo animations included in this plugin (demo.lottie, meditation.lottie, native.lottie) are free animations from LottieFiles and are subject to the LottieFiles License.

License

MIT