Search packages, repositories and app categories

parallax_sensors_bg cover
Package detailsv1.0.1

parallax_sensors_bg

Flutter package to simplify giving a parallax effect in the background of a page that responds to a corresponding sensor detection.

AndroidiOS
30-day downloads
262
Likes
115
Pub points
140

Install package

flutter pub add parallax_sensors_bg

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that enables developers to create dynamic parallax backgrounds responding to device sensor data, such as accelerometer and gyroscope. It simplifies the integration of immersive, motion-sensitive visual effects in app interfaces by automatically adjusting background elements based on real-time sensor input. Ideal for enhancing user engagement with subtle, responsive animations. The package supports both Android and iOS platforms and is designed for smooth performance with minimal setup.

Use cases

  • Creating immersive app onboarding screens
  • Adding motion-responsive backgrounds in dashboards
  • Enhancing gaming or interactive UIs
  • Designing engaging product showcase pages
  • Implementing sensor-driven visual storytelling

Key features

  • Real-time sensor-based parallax effects
  • Smooth animation with low latency
  • Cross-platform support (Android & iOS)
  • Minimal configuration required
  • Supports custom background widgets
  • Optimized for performance

Suitable for

  • UI/UX designers seeking interactive elements
  • Developers building motion-aware apps
  • Apps requiring engaging visual feedback
  • Gamified or experiential mobile interfaces
  • Prototyping interactive prototypes

Considerations

  • Requires device sensors to be available
  • May impact battery life with continuous sensor use
  • Best suited for static or slow-moving backgrounds
  • Not ideal for complex animations
  • Limited control over sensor sensitivity settings

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Parallax Sensors Bg

Get a parallax effect in the background of a page that responds to a corresponding sensor detection (Accelerometer, Gyroscope, User accelerometer, Magnetometer)

Note: Accelerometer is preferred over other sensors.


Features

  • Supports 4 sensors: Accelerometer, User Accelerometer, Gyroscope, Magnetometer.
  • Simplified use of image.
  • Predefined filters for image: Blur and darken.
  • Any widgets can be used as a layer.
  • Can lock or reverse the movement of any axis.
  • Many parameters for precise customization.

Getting started

Add dependency in pubspec.yaml and run flutter pub get

dependencies:
  parallax_sensors_bg: ^1.0.0

Now import the package in your code:

import 'package:parallax_sensors_bg/parallax_sensors_bg.dart';

Usage

Use it in the Scaffold body

Parallax(
  sensors: ParallaxSensor.accelerometer,
  layers: [
    Layer(
      sensitivity: 1,
      image: NetworkImage('https://example.com/background.png'),
      preventCrop: true,
      imageBlurValue: 5,
    ),
    Layer(
      sensitivity: 7,
      image: AssetImage('assets/middle_layer.png'),
      imageHeight: 500,
      imageFit: BoxFit.fitHeight,
    ),
    Layer(
      sensitivity: 12,
      child: Text('Topmost layer'),
    ),
  ]
  child: Text('Page body here'),
),

Parallax class arguments:

Argument Type Default Description
sensor ParallaxSensor ParallaxSensor.accelerometer Type of the sensor whose detected values will be used for parallax movement. (accelerometer, userAccelerometer, gyroscope, magnetometer).
layers List<Layer> required Individual layers for the parallax effect. The declaration of the layers sequentially are positioned from bottom to top (Farthest to nearest from parallax perspective).
reverseVerticalAxis bool false Reverses the movement of vertical axis.
reverseHorizontalAxis bool false Reverses the movement of horizontal axis.
lockVerticalAxis bool false Stops the movement of vertical axis.
lockHorizontalAxis bool false Stops the movement of horizontal axis.
animationDuration int 300 The duration in milliseconds it takes for the movement change to complete. Ideal value is from 200 to 400.
child Widget? null The fixed body of the page, above the parallax layer.

Layer class arguments:

Argument Type Default Description
sensitivity double required Moving sensitivity of the layer.
offset Offset? null Position of the layer from the center.
image ImageProvider<Object>? null Image that the layer will show. By default, the image will take the size of the screen.
imageFit BoxFit BoxFit.cover BoxFit type of the image.
imageHeight double? null Height of the image.
imageWidth double? null Width of the image.
preventCrop bool false If set to true, it will ignore the imageHeight and imageWidth if given and will set the height and width of the image slightly more than the screen size such that it doesn't get cropped even at the extreme value of the sensor.
imageBlurValue double? null Blurs the image. Value can be any positive fractional number.
imageDarkenValue double? null Darkens the image. Value ranges from 0 to 1.
opacity double? null Opacity of the layer. Value ranges from 0 to 1.

Categories

Dependencies

Dependency list 1 items

Source repository

Projects using this package